Comment lire la définition d'une fonction (prototype)
Chaque fonction dans le manuel est documentée pour permettre une compréhension rapide. Savoir décoder le texte rendra votre apprentissage plus facile. Plutôt que de dépendre d'exemples prêts en copier/coller, il est plus utile de savoir lire la définition d'une fonction (prototype). Voici comment :
Note: Pré-requis : Connaissances de base des types.
Bien que PHP soit un langage sans typage fort, une connaissance de base des types est essentielle, car ils ont quand même des sens importants.
Les définitions de fonctions vous indiquent quel type de données est retourné. Examinons la fonction strlen() comme exemple :
strlen (PHP 4, PHP 5) strlen -- Retourne la taille de la chaîne Description int strlen ( string $string ) Retourne la taille de la chaîne $string.
| Partie | Description |
|---|---|
| strlen | Le nom de la fonction. |
| (PHP 4, PHP 5) | strlen() est présente dans toutes les versions de PHP 4 et PHP 5. |
| int | Type de valeur retournée par cette fonction, qui est, en l'occurrence, un entier (i.e. la taille d'une chaîne est mesurée par un nombre). |
| ( string $string ) |
Le premier (et ici le seul) paramètre à fournir à cette fonction est
le paramètre string, qui doit être du type
chaîne de caractères.
|
Nous pourrions réécrire ce prototype avec une version plus générique :
type_retourné nom_de_la_fonction ( type_du_paramètre nom_du_paramètre )
Plusieurs fonctions ont besoin de plusieurs paramètres, comme in_array(). Son prototype est le suivant :
bool in_array ( mixed $needle, array $haystack [, bool $strict = FALSE ] )
Qu'est ce que cela signifie ? in_array() retourne
un booléen TRUE en
cas de réussite (le paramètre
needle a été trouvé dans le tableau
haystack) ou FALSE si une erreur survient
(le paramètre needle n'a pas été trouvé
dans le tableau haystack). Le premier
paramètre s'appelle needle et il peut être
de différents types : il porte
donc la mention mixed.
Le paramètre needle (ce que nous recherchons)
peut être une valeur scalaire ( chaîne de caractères, entier,
ou float), ou encore un array.
haystack (le array,
dans lequel nous recherchons) est
le second paramètre. Le troisième paramètre, optionnel,
strict,
est optionnel. Tous les paramètres optionnels sont placés entre
[ crochets ].
La manuel indique que le paramètre strict vaut par
défaut FALSE. Reportez-vous au manuel de chaque fonction pour savoir
comment elle fonctionne.
De plus, le signe & (é commercial) ajouté au début du paramètre d'une fonction permet de passer ce paramètre par référence, comme ceci :
int preg_match ( string $pattern , string $subject [, array &$matches
[, int $flags = 0 [, int $offset = 0 ]]] )
Dans cet exemple, nous pouvons voir que le troisième paramètre optionnel
&$matches va être passé par référence.
Il y a aussi des fonctions avec des informations plus complexes concernant les versions de PHP. Prenons html_entity_decode() comme exemple :
(PHP 4 >= 4.3.0, PHP 5)
Cela signifie que cette fonction n'est disponible que depuis PHP 4.3.0.
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-about.prototypes.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.
