Files
2023-08-15 15:20:18 +01:00

114 lines
3.0 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f7e42edba898d3a07f5213360e9464fbf526b20e Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.spl-object-hash" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>spl_object_hash</refname>
<refpurpose>
Retourne l'identifiant de hachage pour un objet donné
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>spl_object_hash</methodname>
<methodparam><type>object</type><parameter>object</parameter></methodparam>
</methodsynopsis>
<para>
Cette fonction retourne un identifiant unique pour l'objet. Cet identifiant
peut être utilisé comme clé de hachage pour stocker les objets ou pour les
identifier, tant que l'objet n'est pas détruit. Une fois l'objet détruit,
l'identifiant peut être réutilisé pour d'autres objets. Ce comportement est similaire à celui de la <function>spl_object_id</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>object</parameter></term>
<listitem>
<para>
N'importe quel objet.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Une &string; unique pour chaque objet existant et qui
sera toujours identique pour chaque objet.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Exemple avec <function>spl_object_hash</function></title>
<programlisting role="php">
<![CDATA[
<?php
$id = spl_object_hash($object);
$storage[$id] = $object;
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
Lorsqu'un objet est détruit, son identifiant de hachage
pourra être réutilisé pour d'autres objets.
</para>
</note>
<note>
<para>
Les hachage d'objet devraient être comparé pour leur identité avec <code>===</code>
et <code>!==</code>, car le hachage retourné pourrait être
une <link linkend="language.types.numeric-strings">chaîne numérique</link>.
Par exemple: <literal>0000000000000e600000000000000000</literal>.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>spl_object_id</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->