# La classe SplObjectStorage

(PHP 5 >= 5.3.0, PHP 7)

## Introduction

La classe SplObjectStorage fournit une carte d'objets ou de données, ou encore, en ignorant les index, un ensemble d'objets. Ce double objectif est utile dans de nombreuses situations, où il faut identifier de manière unique des objets.

## Synopsis de la classe

SplObjectStorage implements Countable , Iterator , Serializable , ArrayAccess {
/* Méthodes */
public addAll ( SplObjectStorage `$storage` ) : void
public attach ( object `$object` [, mixed `$data` = `NULL` ] ) : void
public contains ( object `$object` ) : bool
public count ( void ) : int
public current ( void ) : object
public detach ( object `$object` ) : void
public getHash ( object `$object` ) : string
public getInfo ( void ) : mixed
public key ( void ) : int
public next ( void ) : void
public offsetExists ( object `$object` ) : bool
public offsetGet ( object `$object` ) : mixed
public offsetSet ( object `$object` [, mixed `$data` = `NULL` ] ) : void
public offsetUnset ( object `$object` ) : void
public removeAll ( SplObjectStorage `$storage` ) : void
public removeAllExcept ( SplObjectStorage `$storage` ) : void
public rewind ( void ) : void
public serialize ( void ) : string
public setInfo ( mixed `$data` ) : void
public unserialize ( string `$serialized` ) : void
public valid ( void ) : bool
}

## Exemples

Exemple #1 Exemple avec SplObjectStorage, sous forme d'ensemble d'objets

`<?php
// Un ensemble d'objets
$s = new SplObjectStorage();
$o1 = new StdClass;
$o2 = new StdClass;
$o3 = new StdClass;
$s->attach($o1);
$s->attach($o2);
var_dump($s->contains($o1));
var_dump($s->contains($o2));
var_dump($s->contains($o3));
$s->detach($o2);
var_dump($s->contains($o1));
var_dump($s->contains($o2));
var_dump($s->contains($o3));
?>`

L'exemple ci-dessus va afficher :

    bool(true)
    bool(true)
    bool(false)
    bool(true)
    bool(false)
    bool(false)

Exemple #2 Exemple avec SplObjectStorage, sous forme de carte

`<?php
// Une carte d'objets
$s = new SplObjectStorage();
$o1 = new StdClass;
$o2 = new StdClass;
$o3 = new StdClass;
$s[$o1] = "data for object 1";
$s[$o2] = array(1,2,3);
if (isset($s[$o2])) {
var_dump($s[$o2]);
}
?>`

L'exemple ci-dessus va afficher :

    array(3) {
      [0]=>
      int(1)
      [1]=>
      int(2)
      [2]=>
      int(3)
    }

## Sommaire

- SplObjectStorage::addAll — Ajoute tous les objets d'un autre stockage
- SplObjectStorage::attach — Ajoute un objet dans le stockage
- SplObjectStorage::contains — Vérifie si un stockage contient un objet
- SplObjectStorage::count — Retourne le nombre d'objets dans le stockage
- SplObjectStorage::current — Retourne l'objet courant
- SplObjectStorage::detach — Retire un objet du stockage
- SplObjectStorage::getHash — Calcule un identifiant unique pour les objets contenus
- SplObjectStorage::getInfo — Retourne les données associés à l'élément en cours
- SplObjectStorage::key — Retourne l'index de l'objet courant
- SplObjectStorage::next — Passe au prochain élément
- SplObjectStorage::offsetExists — Vérifie si un objet existe dans le stockage
- SplObjectStorage::offsetGet — Retourne les données associées à un objet
- SplObjectStorage::offsetSet — Associe des données à un stockage
- SplObjectStorage::offsetUnset — Retire un objet du stockage
- SplObjectStorage::removeAll — Retire les objets d'un stockage qui appartienne à un autre stockage
- SplObjectStorage::removeAllExcept — Supprime tous les objets du stockage courant sauf ceux contenus dans d'autres stockages
- SplObjectStorage::rewind — Remet l'itérateur au début
- SplObjectStorage::serialize — Linéarise un stockage
- SplObjectStorage::setInfo — Modifie les données associée à l'élément courant
- SplObjectStorage::unserialize — Délinéarise un stockage à partir de sa forme en chaîne
- SplObjectStorage::valid — Vérifie si l'élément courant est valide