C.2 Chaînes de caractères 493 C.2 CHAÎNES DE CARACTÈRES addSlashes string addSlashes (string cha^ıne ) Renvoie une chaîne identique à cha^ıne,avecdes«\ » devant chaque apostrophe simple (’), apostrophe double (") et barre oblique inversée (\). La chaîne ainsi obtenue peut être utilisée sans risque dans une requête SQL. chop string chop (string cha^ıne ) Renvoie une chaîne identique à cha^ıne, après suppression de tous les caractères blancs en fin de chaîne. explode array explode (string s´eparateur, string cha^ıne ) Divise cha^ıne en valeurs séparées par s´eparateur, et renvoie le tableau de ces valeurs. implode string implode (array tableau, string s´eparateur ) Fonction inverse de explode() : renvoie une chaîne avec les valeurs de tableau séparées par s´eparateur. ltrim string ltrim (string cha^ıne ) Renvoie une chaîne identique à cha^ıne, après suppression de tous les caractères blancs en début de chaîne. strchr string strchr (string cha^ıne1, string cha^ıne2 ) Renvoie le contenu de cha^ıne1 à partir de la première occurrence de cha^ıne2. Renvoie faux si cha^ıne2 n’apparaît pas dans cha^ıne1. 494 Annexe C. Fonctions PHP strcmp int strcmp (string cha^ıne1, string cha^ıne2 ) Renvoie une valeur négative si cha^ıne1 précède cha^ıne2 dans l’ordre lexicogra- phique, une valeur positive si cha^ıne1 est supérieure à cha^ıne2, 0 si les chaînes sont égales. strcspn int strcspn (string cha^ıne1, string cha^ıne2 ) Renvoie la position du premier caractère de cha^ıne1 qui fait aussi partie de cha^ıne2. stripSlashes string stripSlashes (string cha^ıne ) Renvoie une chaîne identique à cha^ıne, avec suppression des « \ » devant chaque apostrophe simple (’), apostrophe double (") et barre oblique inversée (\). C’est la fonction inverse de addSlashes(). strlen int strlen (string cha^ıne ) Renvoie la longueur de cha^ıne. strpos int strpos (string cha^ıne1, string cha^ıne2 ) Renvoielapositiondelapremièreoccurrencedecha^ıne2 dans cha^ıne1. Renvoie faux si rien n’est trouvé. strrpos int strrpos (string cha^ıne, char caract`ere ) Renvoielapositiondeladernièreoccurrencedecaract`ere dans cha^ıne. Renvoie faux si rien n’est trouvé. substr_count int substr_count (string cha^ıne1, string cha^ıne2 ) Renvoie le nombre d’occurrences de cha^ıne2 dans cha^ıne1 C.2 Chaînes de caractères 495 strrchr string strrchr (string cha^ıne1, string cha^ıne2 ) Renvoie le contenu de cha^ıne1 à partir de la dernière occurrence de cha^ıne2. Renvoie faux si cha^ıne2 n’apparaît pas dans cha^ıne1. strrev string strrev (string cha^ıne ) Renvoie la chaîne miroir de cha^ıne. strspn int strspn (string cha^ıne1, string cha^ıne2 ) Renvoie la position du premier caractère de cha^ıne1 qui ne fait pas partie de cha^ıne2. strToLower string strToLower (string cha^ıne ) Renvoie la chaîne mise en minuscules. strToUpper string strToUpper (string cha^ıne ) Renvoielachaînemiseenmajuscules. substr string substr (string cha^ıne, int d´ebut, int longueur ) Renvoie la sous-chaîne de cha^ıne de longueur longueur à partir de d´ebut. trim string trim (string cha^ıne ) Renvoie une chaîne identique à cha^ıne après suppression des blancs au début et à la fin. 496 Annexe C. Fonctions PHP C.3 DATES checkdate bool checkdate (int mois, int jour, int an ) Contrôle la validité d’une date : le 32/89/1879879 n’est pas une date valide ! date string date (string format [, int timestamp ]) Renvoie la date correspondant à timestamp, ou la date courante si le paramètre est omis, formaté avec format. Les options pour le formatage sont les suivantes. • a «am»ou«pm». • A «AM»ou«PM». • d Jour du mois, sur deux chiffres avec un zéro initial si besoin est. • D Trois premières lettres du nom du jour (en anglais). • F Nom du mois (en anglais). • h Heure, sur 12 heures, avec deux chiffres. • H Heure, sur 24 heures, et avec deux chiffres. • g Heure, sur 12 heures, avec un ou deux chiffres. • G Heure, sur 24 heures, et avec un ou deux chiffres. • i Minutes, de 00 à 59. • j Jour du mois, sur un ou deux chiffres. • l Nom du jour (en anglais). • L, 0 ou 1 selon qu’il s’agit d’une année bissextile ou pas. • m Numéro du mois, de 01 à 12. • n Numéro du mois, de 1 à 12. • M Trois premières lettres du nom du mois (en anglais). • s Secondes, de 00 à 59. • t Nombre de jours dans le mois courant (28 à 31). • U Nombre de secondes depuis le 01/01/1970. • w, chiffre du jour de la semaine, de 0 (dimanche) à 6 (samedi). • Y Année sur quatre chiffres. • y Année sur deux chiffres. • z Numéro du jour de l’année, commençant à 0. getdate array getdate (int timestamp ) C.4 Tableaux 497 Renvoie les informations propres à timestamp sous la forme d’un tableau associatif contenant des éléments indexés par les clés suivantes : • seconds : les secondes. • minutes : les minutes. • hours : les heures. • mday : jour du mois. • wday : numéro du jour de la semaine. • mon :numérodumois. • year : l’année. • yday : numéro du jour dans l’année. • weekday : nom (en anglais) du jour. • month : nom (en anglais) du mois. mkTime int mkTime (int heure, int minutes, int secondes, int mois, int jour, int annee ) Renvoie un timestamp UNIX (secondes depuis le 01/01/1970). time int time () Renvoie le timestamp UNIX (secondes depuis le 01/01/1970) de la date courante. C.4 TABLEAUX Rappelons qu’un tableau est une suite de valeurs, indexées par un chiffre ou par une clé (tableaux associatifs). Le terme « élément » désigne la paire clé/valeur ou indice/- valeur. La liste qui suit est une sélection qui ne donne pas de manière exhaustive les fonctions d’interaction avec les tableaux PHP. array array array (listeValeurs ) Crée un tableau avec initialisation à partir de la liste des valeurs fournies. Voir le chapitre 11 pour l’utilisation de cette fonction. array_key_exists bool array_key_exists (cl´e, tableau ) Renvoie true si la clé existe dans le tableau. . heures, et avec deux chiffres. • g Heure, sur 12 heures, avec un ou deux chiffres. • G Heure, sur 24 heures, et avec un ou deux chiffres. • i Minutes, de 00 à 59. • j Jour du mois, sur un ou deux. mois, de 01 à 12. • n Numéro du mois, de 1 à 12. • M Trois premières lettres du nom du mois (en anglais). • s Secondes, de 00 à 59. • t Nombre de jours dans le mois courant (28 à 31). • U Nombre de. la sous-chaîne de cha^ıne de longueur longueur à partir de d´ebut. trim string trim (string cha^ıne ) Renvoie une chaîne identique à cha^ıne après suppression des blancs au début et à la fin. 496