Table des matières
- Miscellaneous -- Divers
- attribute
attribute
Date de publication: le vendredi 1 avril 2011 à 15h43
Dernière modification: par Pascal BOYER le samedi 2 avril 2011 à 12h08
toutes versions
Summary / Résumé
Makes it possible to inspect the contents of arrays, hashes and objects.
Permet d'inspecter les contenus des tableaux, des tableaux associatifs et des objets.
Usage / Utilisation
input|attribute( [show_values [, level [, table ] ] ] )
Parameters / Paramètres
|
Name Nom | Type | Description |
Required Requis |
|---|---|---|---|
| show_values |
string Chaîne de caractères |
Sets whether to extract values in addition to keys, names, etc. If "show" is passed, the values will be returned. Otherwise, the operator will not return any values. Définit s'il faut extraire des valeurs en plus des clefs, des noms, etc... Si le paramètre show est passé, les valeurs seront retournées, sinon l'opérateur ne retournera aucune valeur. |
No Non |
| level |
integer entier |
The number of levels that should be processed (default is 2). Le nombre de niveaux à traités (2 par défaut). |
No Non |
| table |
boolean booléen |
Return result as HTML table (default) or not. Renvoie, par défaut, le resultat sous forme d'un tableau HTML ou non |
No Non |
Returns / Renvoie
A string revealing information about the target.
Des informations, au format chaîne de caractères, sur l'élément cible.
Description
This operator extracts all available keys, attribute names and/or methods that belong to the input parameter (must be either an object, an array or a hash). By default, the array keys, object attribute names and their types will be revealed. By passing "show" as the first parameter, the operator will also return the values. The second parameter can be used to control the number of levels/children that should be expanded and included in the result (the default setting is 2). A large level value may cause the system to be trapped in a recursive/infinite loop. The returned result is an HTML table containing the retrieved information. If "false()" is passed as the third parameter, the output will be a plain string instead of an HTML table. Please refer to the "Array and object inspection" section of the "Templates" chapter for more information about the use of this operator.
Cet opérateur extrait toutes les clefs disponibles, les noms des attributs et/ou les méthodes appartenant au paramètre d'entrée (qui doit être soit un objet soit un tableau soit un tableau associatif ). Par défaut, les clefs du tableau, les noms des attributs de l'objet et leurs types sont renvoyés, mais en passant show en premier paramètre, l'opérateur renvoie également les valeurs. Le second paramètre est utilisé pour contrôler le nombre de niveaux (ou d'enfants) à parcourir/explorer puis à inclur dans le résultat (la valeur par défaut de ce paramètre est 2). Attention: une valeur trop importante peut emprisonner le système dans une boucle récursive/infinie.Le résultat renvoyé par défaut est un tableau HTML, mais si le paramètre false() est passé en troisième position, alors la sortie sera retournée au format plain. Référez-vous à l'article
Inspection des tableaux et objets
de la section consacrée aux templates pour de plus amples informations sur l'usage de cet opérateur.
Exemple 1
{def $example=hash( 'Name', 'John Doe', 'Age', 24, 'Phone', '555-3212' )} {$example|attribute()}
The following output will be produced:
La sortie suivante sera produite:
|
Attribute Attribut | Type |
|---|---|
| Name |
string chaîne de caratères |
| Age |
integer entier |
| Phone |
string chaîne de caratères |
Exemple 2
{def $example=hash( 'Name', 'Jane Doe', 'Age', 23, 'Phone', '555-3213' )} {$example|attribute( 'show' )}
The following output will be produced:
La sortie suivante sera produite:
|
Attribute Attribut | Type |
Value Valeur |
|---|---|---|
| Name |
string chaîne de caratères | 'Jane Doe' |
| Age |
integer entier | 23 |
| Phone |
string chaîne de caratères | '555-3213' |