SplObjectStorage::getHash

(PHP 5 >= 5.4.0, PHP 7, PHP 8)

SplObjectStorage::getHash — Calcular un identificador único (hash) para los objetos contenidos

Descripción

public SplObjectStorage::getHash(object $object): string

Este método calcula un identificador para los objetos añadidos a un objeto SplObjectStorage.

La implementación en la clase SplObjectStorage devuelve el mismo valor que la función spl_object_hash().

El objeto de almacenamiento nunca contendrá más de un objeto con el mismo identificador. Por lo tanto, se puede usar para implementar un conjunto (una colección de valores únicos) donde la cualidad de un objeto de ser único está determinada por el valor devuelto por esta función.

Parámetros

object: El objeto cuyo identificador va a ser calculado.

Valores devueltos

Un string con el identificador calculado.

Errores/Excepciones

Se lanza una excepción de tipo RuntimeException cuando el valor devuelto no es un string.

Ejemplos

Ejemplo #1 Ejemplo de SplObjectStorage::getHash()

<?php
class OneSpecimenPerClassStorage extends SplObjectStorage {
    public function getHash($o) {
        return get_class($o);
    }
}
class A {}

$s = new OneSpecimenPerClassStorage;
$o1 = new stdClass;
$o2 = new stdClass;
$o3 = new A;

$s[$o1] = 1;
//$o2 es considerado igual a $o1, por lo que el valor es reemplazado
$s[$o2] = 2;
$s[$o3] = 3;

//estos objetos son considerados iguales a los objetos anteriores
//por lo que se pueden usar para acceder a los valores almacenados en ellos
$p1 = new stdClass;
$p2 = new A;
echo $s[$p1], "\n";
echo $s[$p2], "\n";
?>

Resultado del ejemplo anterior es similar a:

2
3

Ver también

spl_object_hash() - Devuelve el identificador de hash para un objeto dado

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

aron dot duby at gmail dot com ¶

12 years ago

This also appears to be the function which gets used within the contains() function, so if all the objects you are storing already have a unique id you can overwrite this function with your own class.

<?php
class UserStorage extends SPLObjectStorage{
     public function getHash($obj){
          return $obj->id;
     }
}

$us = new UserStorage();
$user1 = new User(1);
$user2 = new User(2);

$us->attach($user1);
$us->attach($user2);

$me = new User(2);

// the following would normally fail since they are two separate objects 
// but it works now with our extended getHash()
$us->contains($me);

?>

＋add a note