Index: phpdoc/fr/functions/strings.xml diff -u phpdoc/fr/functions/strings.xml:1.7 phpdoc/fr/functions/strings.xml:1.8 --- phpdoc/fr/functions/strings.xml:1.7 Tue Oct 31 00:59:52 2000 +++ phpdoc/fr/functions/strings.xml Wed Nov 15 06:24:54 2000 @@ -4,32 +4,48 @@ - Ces fonctions permettent la manipulations de chaînes de caractères. Certaines - sections plus spécialisées sont disponibles dès les sections sur les expressions + Ces fonctions permettent la manipulations de chaînes de + caractères. Certaines sections plus spécialisées + sont disponibles dès les sections sur les expressions régulières et dans la section URL. + + + Pour plus de détails sur le comportement des chaînes de caractères, + notamment concerenant les guillemets simples ou doubles, et les + séquences d'échappement, reportez vous à + chaînes de caractères, + dans le chapitre Types. + AddCSlashes - Ajoute des slashes dans une chaîne, comme en langage C. + + Ajoute des slashes dans une chaîne, comme en langage C. + Description - string addcslashes - string str - string charlist + + string addcslashes + string str + string charlist + - Retourne une chaîne avec des backslash devant les caractères qui sont dans la - liste charlist. Les caractères \n, - \r etc. sont échappés. En langage C, les caractères avec un - code ASCII inférieur à 32 ou supérieur à 126 sont convertis en représentation - octale. Faites bien attention lorsque vous échappez des caractères alpha-numériques. - Vous pouvez spécifier un intervalle dans charlist comme - "\0..\37", qui échappera les caractères compris dans cet intervalle. + Retourne une chaîne avec des backslash devant les caractères + qui sont dans la liste charlist. Les caractères + \n, \r etc. sont échappés. + En langage C, les caractères avec un code ASCII inférieur + à 32 ou supérieur à 126 sont convertis en + représentation octale. Faites bien attention lorsque vous + échappez des caractères alpha-numériques. + Vous pouvez spécifier un intervalle dans charlist + comme "\0..\37", qui échappera les caractères compris + dans cet intervalle. Exemple avec <function>addcslashes</function> @@ -42,8 +58,10 @@ - Voir aussi stripcslashes, stripslashes, - htmlspecialchars, htmlspecialchars et + Voir aussi stripcslashes, + stripslashes, + htmlspecialchars, + htmlspecialchars, et quotemeta. @@ -56,19 +74,23 @@ Description - - string addslashes - string str - - - Retourne une chaîne avec des backslashes devant chaque caractère qui a en a besoin - pour être inséré dans une requête de base de données. Ces caractères sont - guillemets simples ('), guillemets doubles ("), - backslash (\) et NULL (la valeur null). + + + string addslashes + string str + + + + Retourne une chaîne avec des backslashes devant chaque + caractère qui a en a besoin pour être inséré + dans une requête de base de données. Ces caractères sont + guillemets simples ('), guillemets doubles + ("), backslash (\) et NULL + (la valeur nulle). - Voir aussi stripslashes, htmlspecialchars - et quotemeta. + Voir aussi stripslashes, + htmlspecialchars et quotemeta. @@ -82,14 +104,16 @@ Description - - string bin2hex - string str + + + string bin2hex + string str + - Retourne une chaîne ASCII contenant la représentation hexadécimale de - str. La conversion est faite avec le bit de poids fort - en premier. + Retourne une chaîne ASCII contenant la représentation + hexadécimale de str. La conversion est + faite avec le bit de poids fort en premier. @@ -104,8 +128,10 @@ Description - string chop - string str + + string chop + string str + Retourne l'argument sans les espaces de fin de chaîne. @@ -116,8 +142,16 @@ + + + chop diffère de sa cousine du Perl + chop, qui supprime le dernier caractère + de la chaîne. + + - Voir aussi trim. + Voir aussi trim, ltrim, + rtrim, et chop. @@ -130,8 +164,10 @@ Description - string chr - int ascii + + string chr + int ascii + Retourne le caractère de code ASCII ascii. @@ -160,23 +196,26 @@ Description - string chunk_split - string string - int - chunklen - - string - end - - - - Permet de scinder une chaîne en plus petit morceaux, comme dans le cas de la - conversion en base64_encode - pour se conformer à la RFC 2045. - Cette fonction insère une fin de chaîne end - (par défaut "\r\n"), tous les chunklen (par défaut 76) - caractères. - La chaîne retournée est une nouvelle chaîne, et l'original n'est pas modifié. + + string chunk_split + string string + int + chunklen + + string + end + + + + + Permet de scinder une chaîne en plus petit morceaux, comme dans + le cas de la conversion en + base64_encode pour se + conformer à la RFC 2045. Cette fonction insère une fin + de chaîne end (par défaut "\r\n"), + tous les chunklen (par défaut 76) + caractères. La chaîne retournée est une nouvelle + chaîne, et l'original n'est pas modifié. Exemple avec <function>chunk_split</function> @@ -205,15 +244,18 @@ Description - string convert_cyr_string - string str - string from - string to + + string convert_cyr_string + string str + string from + string to + - Cette fonction convertit la chaîne donnée depuis un alphabet cyrillique vers - un autre. Les arguments from et to - sont des caractères qui représentent la source et la destination. + Cette fonction convertit la chaîne donnée depuis un + alphabet cyrillique vers un autre. Les arguments from + et to sont des caractères qui + représentent la source et la destination. Les valeurs acceptées : @@ -255,26 +297,29 @@ count_chars - Retourne des informations sur les caractères utilisés dans une chaîne. + Retourne des informations sur les caractères utilisés dans + une chaîne. Description - mixed count_chars - string string - - - mode - - + + mixed count_chars + string string + + + mode + + + Compte le nombre d'occurence de chaque octet (0..255) dans la chaîne - string et le retourne de différente façon. L'option - Mode prend, par défaut, la valeur 0. - Suivant le mode, count_chars retourne - une des réponses suivante : + string et le retourne de différente + façon. L'option mode prend, par défaut, + la valeur 0. Suivant le mode, + count_chars retourne une des réponses suivante : @@ -283,12 +328,14 @@ - 1 - Identique à 0, mais seule les fréquences non nulles sont listées. + 1 - Identique à 0, mais seule les fréquences non nulles sont + listées. - 2 - Identique à 0, mais seule les fréquences nulles sont listées. + 2 - Identique à 0, mais seule les fréquences nulles sont + listées. @@ -311,6 +358,30 @@ + + + crc32 + Calcule le polynôme crc32 d'une chaîne + + + Description + + + int crc32 + string str + + + + crc32 génère la somme de vérification + de redondance cyclique (32-bit) de la chaîne str. + Cette valeur sert généralement à vérifier l'intégrité de données transmises. + + + Voir aussi: md5 + + + + crypt @@ -319,40 +390,52 @@ Description - string crypt - string str - string - salt - + + string crypt + string str + string + salt + + - crypt va coder une chaîne en utilisant la méthode d'encryption - du DES standard. Les arguments sont : la chaîne à encrypter, - et un grain de sel qui servira de base pour l'encryption. + crypt va coder une chaîne en utilisant la + méthode d'encryption du DES standard. Les + arguments sont : la chaîne à encrypter, et un grain de + sel qui servira de base pour l'encryption. Reportez vous au manuel Unix pour plus de détails. - Si le grain de sel n'est pas fourni, il sera automatiquement généré par PHP. + Si le grain de sel n'est pas fourni, il sera automatiquement + généré par PHP. Certains systèmes d'exploitation acceptent plus d'un type d'encryption. En fait, le DES standard est parfois remplacé par une encryption MD5. Le type d'encryption est alors choisi en fonction du grain de sel. - A l'installation, PHP détermine les possibilités de cryptage et décidera - d'accepter d'autres grains de sel pour d'autres types d'encryption. - Si le grain de sel n'est pas fourni, PHP générera alors un grain de 2 caractères, - pour le DES standard, à moins que le système ne dispose de MD5 : - dans ce cas, PHP générera un grain de sel pour MD, par défaut. - PHP affecte la variable d'environnement CRYPT_SALT_LENGTH, à 2 si il utilise le - DES standard, et à 12 si il utilise le MD5. + A l'installation, PHP détermine les possibilités de cryptage et + décidera d'accepter d'autres grains de sel pour d'autres types + d'encryption. Si le grain de sel n'est pas fourni, PHP générera + alors un grain de 2 caractères, pour le DES standard, à moins + que le système ne dispose de MD5 : dans ce cas, PHP + générera un grain de sel pour MD, par défaut. + PHP affecte la variable d'environnement CRYPT_SALT_LENGTH, à + 2 si il utilise le DES standard, et à 12 si il utilise le MD5. + Si vous utilisez le grain de sel fourni, retenez bien que ce grain + de sel est généré une seule fois. Si vous appelez cette fonction + récursivement, cela aura un impact sur l'apparance et finalement + la sécurité de votre cryptage. + + L'encryption standard fournit le grain de sel dans les deux premiers octets du résultat de la fonction crypt. - Sur les systèmes qui supportent plusieurs méthodes d'encryption, les variables - d'environnement suivantes sont mises à 0 ou à 1, en fonction de la disponibilité + Sur les systèmes qui supportent plusieurs méthodes + d'encryption, les variables d'environnement suivantes sont mises + à 0 ou à 1, en fonction de la disponibilité de la méthode : @@ -392,18 +475,20 @@ Description - echo - string arg1 - string - argn... - + + echo + string arg1 + string + argn... + + Affiche tous les paramètres. - echo n'est pas une fonction à proprement parler, ce qui rend - l'usage des parenthèses facultatives. + echo n'est pas une fonction à proprement + parler, ce qui rend l'usage des parenthèses facultatives. Exemple avec <function>echo</function> @@ -419,8 +504,9 @@ - En fait, si vous voulez passer plus d'un paramètre à echo, - vous ne DEVEZ pas les placer entre parenthèses. + En fait, si vous voulez passer plus d'un paramètre à + echo, vous ne DEVEZ pas les placer entre + parenthèses. @@ -434,18 +520,25 @@ explode - Scinde une chaîne en morceau, grâce à un délimiteur. + + Scinde une chaîne en morceau, grâce à un délimiteur. + Description - array explode - string separator - string string + + array explode + string separator + string string + int + limit + + - Retourne un tableau qui contient les éléments de la chaîne, séparés par - separator. + Retourne un tableau qui contient les éléments de la + chaîne, séparés par separator. Exemple avec <function>explode</function> @@ -454,6 +547,14 @@ + + + Bien que implode accepte, pour des raisons historiques, + les arguments dans un sens ou l'autre, explode + ne le peut. Vous devez vous assurer que l'argument séparateur + separator arrive avant l'argument de chaîne. + + Voir aussi split et implode. @@ -464,29 +565,32 @@ get_html_translation_table - Retourne la table de traduction utilisée par htmlspecialchars - et htmlentities. + Retourne la table de traduction utilisée par + htmlspecialchars et htmlentities. Description - string - get_html_translation_table - - int table + + string + get_html_translation_table + + int table + int quote_style + get_html_translation_table retourne la table de traduction utilisée en interne par htmlspecialchars et htmlentities. Il y a deux nouvelles définitions : - (HTML_ENTITIES, HTML_SPECIALCHARS) + (html_entities, html_specialchars) qui vous permettent de spécifier vos propres tables. Exemple de table de traduction $trans = get_html_translation_table (HTML_ENTITIES); -$str = "Hallo & <Frau> & Krämer"; +$str = "Hallo & <Frau> & Krämer"; $encoded = strtr ($str, $trans); @@ -504,7 +608,7 @@ $original = strtr ($str, $trans); - Le contenu de $original sera : "Hallo & <Frau> & Krämer". + Le contenu de $original sera : "Hallo & <Frau> & Krämer". Cette fonction a été ajoutée en PHP 4.0. @@ -530,11 +634,13 @@ Description - array get_meta_tags - string filename - int - use_include_path - + + array get_meta_tags + string filename + int + use_include_path + + Ouvre le fichier filename et l'analyse ligne par ligne, @@ -547,23 +653,90 @@ </head> <!-- parsing stops here --> - (Faites bien attention aux fins de lignes. PHP utilise une fonction native pour - analyser le fichier d'entrée, ce qui fait que les fichiers faits sous Mac - ne fonctionneront pas sous Unix). + (Faites bien attention aux fins de lignes. PHP utilise une fonction + native pour analyser le fichier d'entrée, ce qui fait que les + fichiers faits sous Mac ne fonctionneront pas sous Unix). - Le nom d'une propriété devient sa clé, et la valeur devient la valeur dans le - tableau associatif retourné, ce qui rend aisé la manipulation des informations. - Les caractères spéciaux dans la nom de la propriété sont remplacés par des '_', - le reste est converti en minuscule. + Le nom d'une propriété devient sa clé, et la + valeur devient la valeur dans le tableau associatif retourné, + ce qui rend aisé la manipulation des informations. Les + caractères spéciaux dans la nom de la propriété + sont remplacés par des '_', le reste est converti en minuscule. - Mettre use_include_path à 1 forcera PHP à ouvrir les - fichiers dans le chemin standard d'inclusion. + Mettre use_include_path à 1 forcera PHP + à ouvrir les fichiers dans le chemin standard d'inclusion. + + + hebrev + + Converti un texte Hebreux logique en texte visual + + + + Description + + + + string hebrev + string hebrew_text + int + max_chars_per_line + + + + + + Le paramètre optionnel max_chars_per_line + indique le nombre maximum de caractères par ligne qui seront + générés. La fonction essaie d'éviter + les césures de mots. + + + Voir aussi hebrevc + + + + + + + hebrevc + + Converti un texte hébreux logique en texte visuel + avec les nouvelles lignes de conversion. + + + + Description + + + string hebrevc + string hebrew_text + int + max_chars_per_line + + + + + hebrevc est similaire à + hebrev, au détail près + qu'elle converti les nouvelles lignes (\n) en "<br>\n". + Le paramètre optionnel max_chars_per_line + indique le nombre maximum de caractères par ligne + qui seront générés. La fonction essaie + d'éviter les césures de mots. + + + Voir aussi hebrev + + + + htmlentities @@ -574,16 +747,28 @@ Description - string htmlentities - string string + + string htmlentities + string string + int quote_style + Cette fonction est identique à - htmlspecialchars en tous points, sauf que tous les caractères - qui ont une entité équivalente en HTML sont replacés par ces entités. + htmlspecialchars en tous points, sauf + que tous les caractères qui ont une entité + équivalente en HTML sont replacés par ces entités. + Comme htmlspecialchars, elle prend un argument + optionnel qui indique ce qui doit être fait avec les guillemets + simples et doubles. ENT_COMPAT (par défaut) + convertira les guillemets doubles, et ignorera les guillemets simples. + ENT_QUOTES convertira les deux types de guillemets + et ENT_NOQUOTES les ignorera tous les deux. - Actuellement, le jeu de caractères ISO-8859-1 character est utilisé. + Actuellement, le jeu de caractères ISO-8859-1 character + est utilisé. Notez que l'argument optionnel + a été ajouté PHP 3.0.17 and PHP 4.0.3. Voir aussi htmlspecialchars et nl2br. @@ -601,18 +786,33 @@ Description - string htmlspecialchars - string string - - - Certains caractères ont une valeur avec HTML, et doivent être remplacés par des - balises HTML pour conserver leur valeur. Cette fonction retourne une chaîne avec - tous les caractères sensibles remplacés par leur équivalent. - - - Cette fonction est utile pour empêcher un utilisateur de fournir un texte avec un - sens HTML, comme dans un livre d'or. - + + string htmlspecialchars + string string + int quote_style + + + + Certains caractères ont une valeur avec HTML, et doivent + être remplacés par des balises HTML pour conserver + leur valeur. Cette fonction retourne une chaîne avec + tous les caractères sensibles remplacés par leur + équivalent. + + + Cette fonction est utile pour empêcher un utilisateur de + fournir un texte avec un sens HTML, comme dans un livre d'or. + + + Cette fonction est pratique pour éviter que les textes fournis par + les utilisateurs contiennent des balises HTML, comme dans le + cas d'un livre d'or ou d'une tribune. Cette fonction prend un argument + optionnel qui indique ce qui doit être fait avec les guillemets + simples et doubles. ENT_COMPAT (par défaut) + convertira les guillemets doubles, et ignorera les guillemets simples. + ENT_QUOTES convertira les deux types de guillemets + et ENT_NOQUOTES les ignorera tous les deux. + Actuellement, PHP remplace les valeurs suivantes : @@ -623,12 +823,12 @@ - '"' guillement double) devient '&quot;' + '"' guillement double) devient '&quot;' si ENT_NOQUOTES n'est pas actif. - '<' (inférieur à) devient '&lt;' + '<' (inférieur à) devient '&lt;' si ENT_QUOTES est actif. @@ -636,12 +836,30 @@ '>' (supérieur à) devient '&gt;' + + + '<' (inférieur) devient '&lt;' + + + + + '>' (supérieur) devient '&gt;' + + + + Exemple avec <function>htmlspecialchars</function> + +$new = htmlspecialchars("<a href='test'>Test</a>", ENT_QUOTES); + + - Notez bien que cette fonction ne fait aucun autre remplacment que ceux listés - ci-dessus. Pour une traduction complète de toutes les balises, reportez vous à - htmlentities. + Notez bien que cette fonction ne fait aucun autre remplacment que + ceux listés ci-dessus. Pour une traduction complète + de toutes les balises, reportez vous à + htmlentities. Notez que l'argument optionnel + a été ajouté PHP 3.0.17 and PHP 4.0.3. Voir aussi htmlentities et nl2br. @@ -653,20 +871,24 @@ implode - Regroupe tous les éléments d'un tableau dans une chaîne, avec une chaîne de - jointure. + Regroupe tous les éléments d'un tableau dans une + chaîne, avec une chaîne de jointure. Description - string implode - string glue - array pieces + + string implode + string glue + array pieces + - Retourne une chaîne constituée de tous les éléments du tableau, pris dans - l'ordre, transformés en chaîne, et séparés par glue. + Retourne une chaîne constituée de tous les + éléments du tableau, pris dans l'ordre, + transformés en chaîne, et séparés par + glue. Exemple avec <function>implode</function> @@ -674,6 +896,14 @@ + + + Pour des raisons historiques, implode accepte + ses arguments dans l'un ou l'autre sens. Par cohérence avec la fonction + explode, il est plus clair d'utiliser l'ordre + des arguments tel que documenté. + + Voir aussi explode, join, et split. @@ -685,19 +915,21 @@ join - Regroupe tous les éléments d'un tableau dans une chaîne, avec une chaîne de - jointure. + Regroupe tous les éléments d'un tableau dans + une chaîne, avec une chaîne de jointure. Description - string join - string glue - array pieces + + string join + string glue + array pieces + - join join() est un alias de implode, + join est un alias de implode, et lui est identique en tous points. @@ -707,6 +939,130 @@ + + + levenshtein + + Calcule la distance Levenshtein entre deux chaînes + + + + Description + + + int levenshtein + string str1 + string str2 + + + int levenshtein + string str1 + string str2 + int cost_ins + int cost_rep + int cost_del + + + int levenshtein + string str1 + string str2 + function cost + + + + + levenshtein retourne la distance Levenshtein + entre les deux chaînes str1 et + str1 ou -1 si un des arguments excéde + la limite de 255 caractères. + + + La distance Levenshtein est définie comme le nombre + minimal de caractères de caractères qu'il faut + remplacer, insérer ou effacer pour transformer la + chaîne str1 en str2. + La complexité de l'algorithme est en O(m*n), + où n et m sont les + longueurs respectives de str1 et + str2 (ceci est plutôt un bon + résultat, comparé à similar_text, + qui est en O(max(n,m)**3), mais cela reste couteux en terme de ressources). + + + Dans sa forme la plus simple, la fonction va prendre uniquement + deux chaînes en paramètres, et calculer uniquement le nombre + d'insertion, replacmenet et effacement nécessaire pour transformer + la chaîne str1 en str2. + + + Une variante prend trois paramètres additionnels, qui définissent + le cout des insertions, des remplacements et des effacement. + C'est une version plus générale et plus souple que la version + simple, mais qui n'est pas aussi efficace. + + + La troisième variante n'est pas encore implémentée. Elle est encore + plus générale, et plus souple, mais plus lente. Elle appelera une + fonction utilisateur qui déterminera le coût de chaque opération. + + + La fonction utilisateur sera appelée avec les arguments suivants : + + + + opération a appliquer : 'I', 'R' or 'D' + + + + + caractère courant de la chaîne str1 + + + + + caractère courant de la chaîne str2 + + + + + position courante de la chaîne str1 + + + + + position courante de la chaîne str2 + + + + + caractères restants dans la chaîne str1 + + + + + caractères restants dans la chaîne str2 + + + + La fonction utilisateur doit retourner un entier positif, qui + décrira le cout de cette opération particulière. Elle peut ne + prendre en compte que certains arguments, et non leur + totalité. + + + L'utilisation d'une fonction utilisateur permet de prendre en + compte la différence entre certains caractères, ou leur contexte + pour déterminer le coût d'une opération d'insertion, remplacement + ou effacement. Elle accroit la charge de calcul demandée au CPU, + et annule l'optimisation des autres variantes. + + + Voir aussi soundex, + similar_text et metaphone. + + + + ltrim @@ -717,13 +1073,16 @@ Description - string ltrim - string str + + string ltrim + string str + - Cette fonction enlève les caractères blancs placés au début d'une chaîne et - retourne la chaîne raccourcie. - Les caractères blancs sont : "\n", "\r", "\t", "\v", "\0", et " ". + Cette fonction enlève les caractères blancs + placés au début d'une chaîne et retourne la + chaîne raccourcie. Les caractères blancs sont : + "\n", "\r", "\t", "\v", "\0", et " ". Voir aussi chop et trim. @@ -739,12 +1098,15 @@ Description - string md5 - string str + + string md5 + string str + - Crypte la chaîne str en utilisant la méthode MD5 - (voir RSA Data Security, Inc. MD5 Message-Digest Algorithm.). + Crypte la chaîne str en utilisant la + méthode MD5 (voir + RSA Data Security, Inc. MD5 Message-Digest Algorithm.). @@ -757,22 +1119,26 @@ Description - string metaphone - string str + + string metaphone + string str + - Calcule la clé métaphone de la chaîne str. + metaphone calcule la clé métaphone + de la chaîne str. - Similairement à soundex, métaphone crée une clé similaire - pour des sons proches. C'est une fonction plus précise que - soundex car elle prend en compte les règles basiques de la - prononciation en anglais. Les clés métaphones sont de longueur variable. + Similairement à soundex, métaphone + crée une clé similaire pour des sons proches. C'est une + fonction plus précise que soundex car elle + prend en compte les règles basiques de la prononciation en anglais. + Les clés métaphones sont de longueur variable. - Metaphone a été développé par Lawrence Philips <lphilips <email protected>>. - Elle est décrit dans ["Practical Algorithms for Programmers", Binstock & Rex, - Addison Wesley, 1995]. + Metaphone a été développé par Lawrence + Philips <lphilips <email protected>>. Elle est décrit dans + ["Practical Algorithms for Programmers", Binstock & Rex, Addison Wesley, 1995]. Cette fonction a été ajoutée en PHP 4.0. @@ -790,15 +1156,19 @@ Description - string nl2br - string string + + string nl2br + string string + - Retourne la chaîne string dont toutes les lignes ont été + nl2br retourne la chaîne + string dont toutes les lignes ont été remplacées par '<BR>'. - Voir aussi htmlspecialchars et htmlentities. + Voir aussi htmlspecialchars et + htmlentities. @@ -811,8 +1181,10 @@ Description - int ord - string string + + int ord + string string + Retourne la valeur ASCII du premier caractère de la chaîne @@ -843,22 +1215,26 @@ Description - void parse_str - string str + + void parse_str + string str + array arr + - Analyse la chaîne str comme si c'etait une chaîne passée - par URL, et affecte les variables qu'elle y trouve. + Analyse la chaîne str comme si + c'était une chaîne passée par URL, et affecte les + variables qu'elle y trouve. Utilisation de <function>parse_str</function> -$str = "first=value&second[]=this+works&second[]=another"; +$str = "first=valeur&second[]=ceci+marche&second[]=encore"; parse_str($str); -echo $first; /* prints "value" */ -echo $second[0]; /* prints "this works" */ -echo $second[1]; /* prints "another" */ +echo $first; /* affiche "valeur" */ +echo $second[0]; /* affiche "ceci marche" */ +echo $second[1]; /* affiche "encore" */ @@ -873,11 +1249,13 @@ Description - print - string arg + + print + string arg + - Affiche arg. + print affiche arg. Voir aussi : echo, printf, @@ -894,20 +1272,24 @@ Description - int printf - string format - mixed - args... - - - - Affiche les arguments en fonction du format. Ce format est - décrit en détails dans la documentation de sprintf. + + int printf + string format + mixed + args... + + + + + Affiche les arguments en fonction du format. + Ce format est décrit en détails dans la documentation + de sprintf. + + + Voir aussi : print, sprintf, + sscanf, fscanf, + et flush. - - Voir aussi : print, sprintf et - flush. - @@ -921,15 +1303,18 @@ Description - string - quoted_printable_decode - - string str + + string + quoted_printable_decode + + string str + - Cette fonction retourne une chaîne 8-bit résultant du décodage de la chaîne - str. - Cette fonction est similaire à imap_qprint, hormis le fait + quoted_printable_decode retourne une chaîne + 8-bit résultant du décodage de la chaîne + str. quoted_printable_decode + est similaire à imap_qprint, hormis le fait qu'elle ne requiert pas le module IMAP. @@ -938,91 +1323,127 @@ QuoteMeta - Ajoute un backslash devant tous les caractères méta + + Ajoute un backslash devant tous les caractères méta + Description + string quotemeta string str + - Retourne une version de la chaîne str, - avec un backslash (\) devant tous les caractères de la liste + quotemeta retourne une version de la + chaîne str, avec un backslash + (\) devant tous les caractères de la liste ci-dessous : . \\ + * ? [ ^ ] ( $ ) - Voir aussi addslashes, htmlentities, - htmlspecialchars, nl2br et + Voir aussi addslashes, + htmlentities, + htmlspecialchars, + nl2br, et stripslashes. - + - rawurldecode - Décode une chaîne URL. + rtrim + Efface les espaces de fin de chaîne. Description - string rawurldecode + + string rtrim string str + - Retourne une chaîne dont les séquences de caractères %xy, avec xy deux valeurs - hexadécimales, auront été remplacées par le caractère ASCII correspondant. Par - exemple, la chaînefoo%20bar%40baz devient foo bar <email protected>. + rtrim la chaîne str, + débarassée de ses espaces terminaux, y compris les + nouvelles lignes. Cette fonction est un alias de chop. + + Exemple avec <function>rtrim</function> example + +$trimmed = rtrim ($line); + + - - Voir aussi rawurlencode. - + + Voir aussi trim, ltrim, and + rtrim. + - + - rawurlencode - Encode une chaîne en URL, selon la RFC1738. + sscanf + Analyse une fonction en fonction d'un format Description - string rawurlencode - string str + + mixed sscanf + string str + string format + string + var1... + + - Retourne une chaîne dont tous les caractères non-alpha-numériques - (hormis -_..) auront été remplacés par des séquences %xy - (%), avec xy deux valeurs hexadécimales. - Ce codage est conforme à la RFC1738 qui évite que les caractères spéciaux - soient interprétés comme des délimiteurs, et pour protéger les URL lors - du transfert (contrairement à certains systèmes email). Par exemple, si vous - voulez mettre un mot de passe dans une URL de ftp : - - Exemple avec <function>rawurlencode</function> example 1 - -echo '<A HREF="ftp://user:', rawurlencode ('foo @+%/'), - ' <email protected>/x.txt">'; - - - Ou, si vous transmettez un chemin dans une URL - - Exemple avec <function>rawurlencode</function> example 2 - -echo '<A HREF="http://x.com/department_list_script/', - rawurlencode ('sales et marketing/Miami'), '">'; - - + sscanf est le complémentaire de + printf. sscanf lit les + données de la chaîne str et + interprète son contenu en fonction du format + format. Si seulement deux paramètres + sont passés à cette fonction, les valeurs obtenues + seront retournées sous forme d'un tableau. + + Exemple avec <function>sscanf</function> + +// lecture d'un numéro de série +$serial = sscanf("SN/2350001","SN/%d"); +// et la date de fabrication +$mandate = "January 01 2000"; +list($month, $day, $year) = sscanf($mandate,"%s %d %d"); +echo "Le produit $serial a été fabriqué le: $year-".substr($month,0,3)."-$day\n"; + + + Si les paramètres optionnels sont passés, + sscanf retournera le nombre de valeurs + assignés. Les options doivent être passés + par référence. + + Utilisation des options avec <function>sscanf</function> + +// Lecture des informations d'auteur, et génération +// d'une entrée DocBook +$auth = "24\tVictor Hugo"; +$n = sscanf($auth,"%d\t%s %s", &$id, &$first, &$last); +echo "<auteur id='$id'> + <Prénom>$first</firstname> + <Nom>$last</surname> +</auteur>\n"; + + - - Voir aussi rawurldecode. - + + Voir aussi: fscanf, printf, + et sprintf. + - + setlocale @@ -1031,60 +1452,67 @@ Description - string setlocale - string category - string locale + + string setlocale + string category + string locale + - Category est une chaîne qui spécifie la catégorie de - fonction qui va être affectée par les informations locales : + category est une chaîne qui + spécifie la catégorie de fonction qui va être + affectée par les informations locales : - LC_ALL Toutes les fonctions ci-dessous + LC_ALL Toutes les fonctions ci-dessous - LC_COLLATE pour les comparaison de chaîne (en cours d'implémentation) + LC_COLLATE pour les comparaison de chaîne (en cours + d'implémentation) - LC_CTYPE pour la classification de caractères et les conversions, - par exemple strtoupper + LC_CTYPE pour la classification de caractères et les conversions, + par exemple strtoupper - LC_MONETARY pour localeconv() - (en cours d'implémentation) + LC_MONETARY pour localeconv() - (en cours d'implémentation) - LC_NUMERIC pour les séparateurs décimaux + LC_NUMERIC pour les séparateurs décimaux - LC_TIME pour le format des dates et heures date avec - strftime + LC_TIME pour le format des dates et heures date avec + strftime - Si locale est une chaîne vide (""), - les noms locaux prendront la valeur des variables d'environnement de même nom, - ou à partir de "LANG". + Si locale est une chaîne vide + (""), les noms locaux prendront la valeur + des variables d'environnement de même nom, ou à + partir de "LANG". - Si locale vaut zéro ou "0", la valeur - reste inchangée, mais l'état courant est retourné. + Si locale vaut zéro ou + "0", la valeur reste inchangée, + mais l'état courant est retourné. - setlocale retourne la valeur courante, ou FALSE si la - fonctionnalité n'est pas encore implémentée pour la plateforme. Une catégorie + setlocale retourne la valeur courante, ou + sFALSEssi la fonctionnalité n'est pas encore + implémentée pour la plateforme. Une catégorie invalide provoque une alerte. @@ -1100,23 +1528,28 @@ Description - int similar_text - string first - string second - double - percent - - - - Cette fonction calcule la similarité entre deux chaînes, comme décrit par Oliver - [1993]. Notez que cette implémentation n'utilise pas une pile, comme dans le - pseudo-code d'Oliver, mais un appel récursif qui accélère parfois l'exécution. - Notez aussi que la complexité de cet algorithme est en o(N**3) avec N la taille + + int similar_text + string first + string second + double + percent + + + + + Cette fonction calcule la similarité entre deux chaînes, + comme décrit par Oliver [1993]. Notez que cette + implémentation n'utilise pas une pile, comme dans le + pseudo-code d'Oliver, mais un appel récursif qui + accélère parfois l'exécution. Notez aussi que + la complexité de cet algorithme est en o(N**3) avec N la taille de la plus grande chaîne. - En passant une référence comme troisième argument, similar_text - va calculer le pourcentage de similarité. Il retourne le nombre de caractères + En passant une référence comme troisième argument, + similar_text va calculer le pourcentage de + similarité. Il retourne le nombre de caractères correspondant l'un à l'autre, d'une chaîne à l'autre. @@ -1130,21 +1563,26 @@ Description - string soundex - string str + + string soundex + string str + - Calcule la valeur soundex de str. + soundex calcule la valeur soundex de + str. - Une valeur Soundex est telle que deux mots prononcés de la même façon auront des - valeurs Soundex identiques. Cela permet d'effectuer des recherches dans les bases - de données, si vous connaissez la prononciation mais pas l'orthographe. Cette - fonction retourne une chaîne de 4 caractères, commencant par une lettre. + Une valeur Soundex est telle que deux mots prononcés de + la même façon auront des valeurs Soundex identiques. + Cela permet d'effectuer des recherches dans les bases de données, + si vous connaissez la prononciation mais pas l'orthographe. Cette + fonction retourne une chaîne de 4 caractères, commencant + par une lettre. - Cette fonction particulière a été décrite par Donald Knuth dans - "The Art Of Computer Programming, vol. 3: Sorting And Searching", + Cette fonction particulière a été décrite + par Donald Knuth dans "The Art Of Computer Programming, vol. 3: Sorting And Searching", Addison-Wesley (1973), pp. 391-392. @@ -1170,110 +1608,119 @@ Description - string sprintf - string format - mixed - args... - + + string sprintf + string format + mixed + args... + + - Retourne une chaîne formatée avec le format format. + sprintf retourne une chaîne + formatée avec le format format. - La chaîne de format est composée de 0 ou plus directives : généralement des - caractères qui sont recopiés tels quel (hormis %), et des - spécifications, chacune d'elle disposant de son propre paramètre. Cela - s'applique à sprintf et printf. + La chaîne de format est composée de 0 ou plus directives : + généralement des caractères qui sont recopiés + tels quel (hormis %), et des spécifications, + chacune d'elle disposant de son propre paramètre. Cela s'applique + à sprintf et printf. - Chaque conversion consiste, dans l'ordre: + Chaque conversion consiste, en un signe pourcentage (%), + suivi d'un ou plusieurs éléments parmi ceux-ci : - Une option de remplissage, qui indique quel caractère sera utilisé pour - le remplissage, et la taille finale de la chaîne. Le caractère de remplissage - peut être un espace ou le caractère zéro (0).). - La valeur par défaut est l'espace. Une autre valeur peut être spécifiée en la - préfixant par un guillemet simple ('). Voir les exemples - plus loin. + Une option de remplissage, qui indique quel caractère sera + utilisé pour le remplissage, et la taille finale de la + chaîne. Le caractère de remplissage peut être + un espace ou le caractère zéro (0).). + La valeur par défaut est l'espace. Une autre valeur peut + être spécifiée en la préfixant par un + guillemet simple ('). Voir les exemples plus loin. - Un argument optionnel alignment specifier qui indique - que le résultat doit être justifié à droite ou à gauche. Par défaut, il est - justifié à gauche. Le caractère - signifie : justification - à droite. + Un argument optionnel alignment specifier qui indique + que le résultat doit être justifié à droite ou + à gauche. Par défaut, il est justifié à gauche. + Le caractère - signifie : justification à + droite. - Argument optionnel, width specifier indique le nombre - minimum de caractères que la conversion devrait retourner. + Argument optionnel, width specifier indique le nombre + minimum de caractères que la conversion devrait retourner. - Argument optionnel, precision specifier indique le nombre - de chiffres utilisé pour afficher un nombre à virgule flottante. Cette option - n'a d'effet que sur les nombres à virgule, double. (Une autre fonciton pratique - pour formater les nombres est : number_format.) + Argument optionnel, precision specifier indique le nombre + de chiffres utilisé pour afficher un nombre à virgule flottante. + Cette option n'a d'effet que sur les nombres à virgule, double. + (Une autre fonciton pratique pour formater les nombres est : + number_format.) - type specifier indique le type de données passées en argument : - Les types possibles sont : - - - % - un signe pourcentage : aucun argument nécessaire. - - - b - l'argument est traité comme un entier, et représenté - comme un nombre binaire. - - - c - l'argument est traité comme un entier, et représenté - comme un nombre ascii. - - - d - l'argument est traité comme un entier, et représenté - comme un nombre décimal. - - - f - l'argument est traité comme un double, et représenté - comme un nombre à virgule flottante. - - - o - l'argument est traité comme un entier, et représenté - comme un nombre octal. - - - s - l'argument est traité tel quel, et représenté - comme une chaîne. - - - x - l'argument est traité comme un entier, et représenté - comme un nombre hexadécimal (en minuscule). - - - X - l'argument est traité comme un entier, et représenté - comme un nombre hexadécimal (en majuscule). - - + type specifier indique le type de données + passées en argument : + Les types possibles sont : + + + % - un signe pourcentage : aucun argument nécessaire. + + + b - l'argument est traité comme un entier, et représenté + comme un nombre binaire. + + + c - l'argument est traité comme un entier, et représenté + comme un nombre ascii. + + + d - l'argument est traité comme un entier, et représenté + comme un nombre décimal. + + + f - l'argument est traité comme un double, et représenté + comme un nombre à virgule flottante. + + + o - l'argument est traité comme un entier, et représenté + comme un nombre octal. + + + s - l'argument est traité tel quel, et représenté + comme une chaîne. + + + x - l'argument est traité comme un entier, et représenté + comme un nombre hexadécimal (en minuscule). + + + X - l'argument est traité comme un entier, et représenté + comme un nombre hexadécimal (en majuscule). + + - Voir aussi : printf et number_format. + Voir aussi : printf, sscanf, + fscanf, et number_format. - - - Exemples - Exemple avec <function>sprintf</function>: complété avec des zéros + + Exemple avec <function>sprintf</function>: complété avec des zéros + $isodate = sprintf ("%04d-%02d-%02d", $year, $month, $day); @@ -1303,9 +1750,11 @@ Description - int strcasecmp - string str1 - string str2 + + int strcasecmp + string str1 + string str2 + Retourne < 0 si str1 est plus petit que @@ -1340,13 +1789,15 @@ Description - string strchr - string haystack - string needle + + string strchr + string haystack + string needle + - Cette fonction est un alias de strstr, et lui est - identique en tous points. + strchr est un alias de strstr, + et lui est identique en tous points. @@ -1359,22 +1810,26 @@ Description - int strcmp - string str1 - string str2 + + int strcmp + string str1 + string str2 + - Retourne < 0 si str1 est plus petit que - str2; > 0 si str1 - est plus grand que str2, et 0 si ils sont égaux. + strcmp retourne < 0 si str1 + est plus petit que str2; > 0 si + str1 est plus grand que + str2, et 0 si ils sont égaux. - Notez bie nque la comparaison est sensible à la casse. + Notez bien que la comparaison est sensible à la casse. - Voir aussi ereg, strcasecmp, - substr, stristr et - strstr. + Voir aussi ereg, + strcasecmp, substr, + stristr, strncmp, + et strstr. @@ -1390,13 +1845,16 @@ Description - int strcspn - string str1 - string str2 + + int strcspn + string str1 + string str2 + - Retourne la longueur du premier segment de la chaîne str1 - qui ne contiennent pas aucun des + strcspn retourne la longueur du premier segment + de la chaîne str1 qui + ne contiennent pas aucun des caractères de la chaîne str2. @@ -1413,23 +1871,29 @@ Description - string strip_tags - string str - string - allowable_tags - - - - Cette fonction recherche et supprime toutes les balises HTML et PHP d'une chaîne. - En cas de balises non fermées, ou de balises mal formées, elle génère une erreur. - Cette fonction utilise le même système que la fonction fgetss. + + string strip_tags + string str + string + allowable_tags + + + + + strip_tags recherche et supprime toutes les balises + HTML et PHP d'une chaîne. En cas de balises non fermées, ou + de balises mal formées, elle génère une erreur. + strip_tags utilise le même système que + la fonction fgetss. - Vous pouvez utiliser l'option allowable_tags + Vous pouvez utiliser l'option + allowable_tags pour spéficier les balises qui seront ignorées. - Allowable_tags a été ajouté en PHP 3.0.13, et PHP4B3. + allowable_tags a été + ajouté en PHP 3.0.13, et PHP4B3. @@ -1439,18 +1903,23 @@ StripCSlashes - Déquote une chaîne quotée avec addcslashes + + Déquote une chaîne quotée avec addcslashes + Description - string stripcslashes - string str + + string stripcslashes + string str + - Retourne une chaîne dont les backslashes ont été supprimés. Cette fonction reconnait - les \n, \r ..., et les représentation octales - et hexadécimales utilisées en C. + stripcslashes retourne une chaîne dont les + backslashes ont été supprimés. Cette fonction reconnait + les \n, \r ..., et les représentations + octales et hexadécimales utilisées en C. Ajouté dans PHP4b3-dev. @@ -1471,11 +1940,14 @@ Description - string stripslashes - string str + + string stripslashes + string str + - Retourne une chaîne dont tous les slashes ont été supprimés. + stripslashes retourne une chaîne dont + tous les slashes ont été supprimés. (\' devient ', ... et ainsi de suite). Les doubles backslashes sont remplacés par des simples. @@ -1495,13 +1967,16 @@ Description - string stristr - string haystack - string needle + + string stristr + string haystack + string needle + - Retourne tous les éléments de haystack à partir de la - première occurence de needle, jusqu'à la fin. + stristr retourne tous les éléments de + haystack à partir de la première + occurence de needle, jusqu'à la fin. needle et haystack sont examinés sans tenir compte de la casse. @@ -1527,15 +2002,233 @@ Description - int strlen - string str + + int strlen + string str + - Retourne la longueur de la chaîne string. + strlen retourne la longueur de la chaîne + string. + + + strnatcmp + + Comparaisons de chaîne par ordre "naturel" + + + + Description + + + int strnatcmp + string str1 + string str2 + + + + strnatcmp implémente un algorithme de + comparaison qui traite les chaînes alphanumériques comme + un être humain : c'est ce qui est appelé l'"ordre naturel". + Un exemple de la différence de traitement entre + un tel algorithme et un algorithme de comparaison de chaîne + (comme lorsqu'on utilise strcmp) est + illustré ci dessous : + + +$arr1 = $arr2 = array ("img12.png","img10.png","img2.png","img1.png"); +echo "Comparaison standard de chaînes\n"; +usort($arr1,"strcmp"); +print_r($arr1); +echo "\nComparaison de chaînes par ordre naturel\n"; +usort($arr2,"strnatcmp"); +print_r($arr2); + + + L'exemple précédent affiche ceci : + + +Comparaison standard de chaînes +Array +( + [0] => img1.png + [1] => img10.png + [2] => img12.png + [3] => img2.png +) + +Comparaison de chaînes par ordre naturel +Array +( + [0] => img1.png + [1] => img2.png + [2] => img10.png + [3] => img12.png +) + + + Pour plus d'informations, reportez vous à Martin Pool Natural Order String Comparison. + + + Comme les autres fonctions de comparaisons de chaînes, elle retourne + une valeur < 0 si str1 est plus petites que + str2; > 0 si str1 + est plus grande que str2, et 0 si elles sont égales. + + + Notez que ces comparaisons sont sensibles à la casse. + + + Voir aussi ereg, + strcasecmp, substr, + stristr, strcmp, + strncmp, strnatcasecmp, + strstr, natsort et + natcasesort. + + + + + + + strnatcasecmp + + Comparaisons de chaîne par ordre "naturel" insensible à la casse + + + + Description + + + int strnatcasecmp + string str1 + string str2 + + + + strnatcasecmp implémente un algorithme de + comparaison qui traite les chaînes alphanumériques comme un + être humain : c'est ce qui est appelé l'"ordre naturel". Pour + plus d'informations, reportez vous à Martin Pool Natural Order String Comparison. + + + Comme les autres fonctions de comparaisons de chaînes, elle retourne + une valeur < 0 si str1 est plus petites que + str2; > 0 si str1 + est plus grande que str2, et 0 si elles sont égales. + + + Voir aussi ereg, + strcasecmp, substr, + stristr, strcmp, + strncmp, strnatcmp, + et strstr. + + + + + + + strncmp + + Comparaison binaire des premiers caractères + + + + Description + + + int strncmp + string str1 + string str2 + int len + + + + strncmp est similaire à strcmp, + à la différence près que vous pouvez spécifier + le nombre limite de caractères (len) + utilisés pour faire la comparaison. Si l'une des chaînes + est plus courte que len, alors cette longueur + sera utilisée pour faire la comparaison. + + + Comme les autres fonctions de comparaisons de chaînes, elle retourne + une valeur < 0 si str1 est plus petites que + str2; > 0 si str1 + est plus grande que str2, et 0 si elles sont égales. + equal. + + + Notez que la comparaison est sensible à la casse. + + + Voir aussi ereg, + strcasecmp, substr, + stristr, strcmp, + et strstr. + + + + + + + str_pad + Complète une chaîne avec une autre + + + Description + + + string str_pad + string input + int pad_length + string + pad_string + int + pad_type + + + + + str_pad complète la chaîne + input à droite, à gauche ou dans les + deux directions, avec pad_string jusqu'à la + taille de pad_length. Si pad_string + n'est pas fourni, input est complété avec + des espaces. Sinon, il est complété avec + pad_string. + + + pad_type peut prendre les valeurs de + STR_PAD_RIGHT, STR_PAD_LEFT, ou STR_PAD_BOTH. Si pad_type + n'est pas spécifiée, cela vaut STR_PAD_RIGHT. + + + Si pad_length est négative ou + inférieure à la taille courante de la chaîne + input, aucun complément n'est ajouté. + + + + Exemple avec <function>str_pad</function> + +$input = "Paris"; +print str_pad($input, 10); // produces "Paris " +print str_pad($input, 10, "-=", STR_PAD_LEFT); // produces "-=-=-Paris" +print str_pad($input, 10, "_", STR_PAD_BOTH); // produces "__Paris___" + + + + + + strpos @@ -1546,30 +2239,34 @@