Config_Container::getItem() -- Essaye de trouver un ou plusieurs éléments spécifiques
Description
Cette méthode tente de trouver les éléments qui correspondent aux paramètres
spécifiés.
Cette méthode ne peut être appelée que sur un objet de type
'section'. Notez que la racine est une section.
Cette méthode n'est pas récursive et essaye de prendre la structure courrante.
Paramètres
- chaîne de caractères
$type
type de l'élément : directive, section,
comment, blank...
- chaîne de caractères
$nom
Nom de l'élément
- mixed
$contenu
Contenu de l'élément
- array
$attributes
trouver un élément dont la valeur donnée est dans les attributs
- entier
$index
index de l'élément dans la liste des éléments qui a été retournée.
Si ce n'est pas dans la série, ce sera le dernier élément qui sera retourné
avec son nom.
Valeur retournée
mixed
- référence de l'élément trouvé.
- FALSE si rien n'est trouvé.
Note
Cette fonction ne peut pas être appelée de façon statique.
Exemple
Exemple 32-1. Quelques petits exemples qui montrent comment trouver des items en utilisant getItem() // Retournera la dernière directive trouvée
$directives =& $obj->getItem('directive');
// Retournera la dernière directive trouvé avec comme contenu 'root'
$directives =& $obj->getItem('directive', null, 'root');
// Retournera la 4ème directive dont le nom est 'bar'
$directive_bar_4 =& $obj->getItem('directive', 'bar', null, null, 4);
// Retournera la dernière section nommée 'foo'
$section_foo =& $obj->getItem('section', 'foo');
// Retournera la dernière section dont l'attribut 'id' est défini à 'db'
$section_foo =& $obj->getItem('section', 'foo', null, array('id' => 'db')); |
|