cvs: phpdoc-fr /reference/classobj/functions call-user-method-array.xml call-user-method.xml class-exists.xml get-class-methods.xml get-class-vars.xml
get-class.xml get-declared-classes.xml get-declared-interfaces.xml get-object-vars.xml get-parent-class.xml interface-exists.xml is-a.xml
is-subclass-of.xml method-exists.xml property-exists.xml
| From: | Yannick Torres | Date: | Wed, 17 Jan 2007 20:54:39 +0000 |
| Subject: | cvs: phpdoc-fr /reference/classobj/functions call-user-method-array.xml call-user-method.xml class-exists.xml get-class-methods.xml get-class-vars.xml get-class.xml get-declared-classes.xml get-declared-interfaces.xml get-object-vars.xml get-parent-class.xml interface-exists.xml is-a.xml is-subclass-of.xml method-exists.xml property-exists.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-5173@lists.php.net to get a copy of this message | ||
yannick Wed Jan 17 20:54:39 2007 UTC
Modified files:
/phpdoc-fr/reference/classobj/functions call-user-method-array.xml
call-user-method.xml
class-exists.xml
get-class-methods.xml
get-class-vars.xml
get-class.xml
get-declared-classes.xml
get-declared-interfaces.xml
get-object-vars.xml
get-parent-class.xml
interface-exists.xml
is-a.xml is-subclass-of.xml
method-exists.xml
property-exists.xml
Log:
sync with EN
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/call-user-method-array.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/classobj/functions/call-user-method-array.xml diff -u phpdoc-fr/reference/classobj/functions/call-user-method-array.xml:1.12 phpdoc-fr/reference/classobj/functions/call-user-method-array.xml:1.13 --- phpdoc-fr/reference/classobj/functions/call-user-method-array.xml:1.12 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/call-user-method-array.xml Wed Jan 17 20:54:39 2007 @@ -1,44 +1,40 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.7 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.call-user-method-array"> - <refnamediv> - <refname>call_user_method_array</refname> - <refpurpose> - Appelle une méthode utilisateur avec un tableau de paramètres - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>mixed</type><methodname>call_user_method_array</methodname> - <methodparam><type>string</type><parameter>method_name</parameter></methodparam> - <methodparam><type>object</type><parameter role="reference">obj</parameter></methodparam> - <methodparam><type>array</type><parameter>paramarr</parameter></methodparam> - </methodsynopsis> - <warning> - <para> - La fonction <function>call_user_method_array</function> est obsolète - depuis &php; 4.1.0, utilisez plutôt la fonction - <function>call_user_func_array</function> avec la syntaxe - <literal>array(&$obj, "method_name")</literal>. - </para> - </warning> +<refentry id="function.call-user-method-array"> + <refnamediv> + <refname>call_user_method_array</refname> + <refpurpose>Appelle une méthode utilisateur avec un tableau de paramètres [obsolète]</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>call_user_method_array</methodname> + <methodparam><type>string</type><parameter>method_name</parameter></methodparam> + <methodparam><type>object</type><parameter role="reference">obj</parameter></methodparam> + <methodparam><type>array</type><parameter>paramarr</parameter></methodparam> + </methodsynopsis> + <warning> <para> - <function>call_user_method_array</function> appelle la méthode - <parameter>method_name</parameter> de l'objet <parameter>obj</parameter>, - en utilisant les paramètres <parameter>paramarr</parameter>, rassemblés - sous forme de tableau. + La fonction <function>call_user_method_array</function> est obsolète + depuis &php; 4.1.0, utilisez plutôt la fonction + <function>call_user_func_array</function> avec la syntaxe + <literal>array(&$obj, "method_name")</literal>. </para> - <para> - Voir aussi - <function>call_user_func_array</function> et - <function>call_user_func</function>. - </para> - </refsect1> - </refentry> + </warning> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>call_user_func_array</function></member> + <member><function>call_user_func</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -59,4 +55,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/call-user-method.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/classobj/functions/call-user-method.xml diff -u phpdoc-fr/reference/classobj/functions/call-user-method.xml:1.12 phpdoc-fr/reference/classobj/functions/call-user-method.xml:1.13 --- phpdoc-fr/reference/classobj/functions/call-user-method.xml:1.12 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/call-user-method.xml Wed Jan 17 20:54:39 2007 @@ -1,79 +1,40 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.10 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.call-user-method"> - <refnamediv> - <refname>call_user_method</refname> - <refpurpose> - Appelle une méthode utilisateur d'un objet - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>mixed</type><methodname>call_user_method</methodname> - <methodparam><type>string</type><parameter>method_name</parameter></methodparam> - <methodparam><type>object</type><parameter role="reference">obj</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter>parameter</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> - </methodsynopsis> - <warning> - <para> - La fonction <function>call_user_method</function> est abandonnée depuis - &php; 4.1.0, utilisez plutôt la fonction <function>call_user_func</function> - avec la syntaxe <literal>array(&$obj, "method_name")</literal>. - </para> - </warning> +<refentry id="function.call-user-method"> + <refnamediv> + <refname>call_user_method</refname> + <refpurpose>Appelle une méthode utilisateur d'un objet [obsolète]</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>call_user_method</methodname> + <methodparam><type>string</type><parameter>method_name</parameter></methodparam> + <methodparam><type>object</type><parameter role="reference">obj</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>parameter</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> + </methodsynopsis> + <warning> <para> - <function>call_user_method</function> appelle la méthode - <parameter>method_name</parameter> de l'objet - <parameter>obj</parameter>, avec les paramètres - <parameter>parameter</parameter>, <parameter>...</parameter>. - Un exemple d'utilisation de cet objet - est présenté ci-dessous, où une classe est définie, puis instantiée. - On utilise alors <function>call_user_method</function> pour appeler - indirectement les méthodes <varname>print_info</varname>. - <example> - <title>Exemple avec <function>call_user_method</function></title> - <programlisting role="php"> -<![CDATA[ -<?php -class Country { - var $NAME; - var $TLD; - - function Country($name, $tld) { - $this->NAME = $name; - $this->TLD = $tld; - } - - function print_info($prestr="") { - echo $prestr."Pays : ".$this->NAME."\n"; - echo $prestr."Top Level Domain : ".$this->TLD."\n"; - } -} - -$cntry = new Country("Perou","pe"); - -echo "* Appel de la méthode de l'objet directement\n"; -$cntry->print_info(); - -echo "\n* Appel de la méthode de l'objet indirectement\n"; -call_user_method ("print_info", $cntry, "\t"); -?> -]]> - </programlisting> - </example> + La fonction <function>call_user_method</function> est abandonnée depuis + &php; 4.1.0, utilisez plutôt la fonction <function>call_user_func</function> + avec la syntaxe <literal>array(&$obj, "method_name")</literal>. </para> - <simpara> - Voir aussi - <function>call_user_func_array</function> et - <function>call_user_func</function>. - </simpara> - </refsect1> - </refentry> + </warning> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>call_user_func_array</function></member> + <member><function>call_user_func</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -94,4 +55,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/class-exists.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/classobj/functions/class-exists.xml diff -u phpdoc-fr/reference/classobj/functions/class-exists.xml:1.14 phpdoc-fr/reference/classobj/functions/class-exists.xml:1.15 --- phpdoc-fr/reference/classobj/functions/class-exists.xml:1.14 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/class-exists.xml Wed Jan 17 20:54:39 2007 @@ -1,81 +1,129 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.8 Maintainer: dams Status: ready --> <!-- Reviewed: no --> - <refentry id="function.class-exists"> - <refnamediv> - <refname>class_exists</refname> - <refpurpose>Vérifie qu'une classe a été définie</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>class_exists</methodname> - <methodparam><type>string</type><parameter>class_name</parameter></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>autoload</parameter></methodparam> - </methodsynopsis> - <para> - <function>class_exists</function> retourne &true; si la classe - <parameter>class_name</parameter> a été définie, et &false; sinon. - </para> - <para> - <example> - <title>Exemple avec <function>class_exists</function></title> - <programlisting role="php"> +<refentry id="function.class-exists"> + <refnamediv> + <refname>class_exists</refname> + <refpurpose>Vérifie qu'une classe a été définie</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>class_exists</methodname> + <methodparam><type>string</type><parameter>class_name</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>autoload</parameter></methodparam> + </methodsynopsis> + <para> + Cette fonction vérifie si une classe donnée a été définie. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>class_name</parameter></term> + <listitem> + <para> + Le nom de la classe + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>autoload</parameter></term> + <listitem> + <para> + Si l'on doit appeler &link.autoload; ou non par défaut + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne &true; si <parameter>class_name</parameter> est une classe définie, + &false; sinon. + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.0.0</entry> + <entry> + La paramètre <parameter>autoload</parameter> a été ajoutée. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>class_exists</function></title> + <programlisting role="php"> <![CDATA[ <?php // Vérifiez que la classe existe avant de l'utiliser -if (class_exists('MaClasse')) { - $maclasse = new MaClasse(); +if (class_exists('MyClass')) { + $myclass = new MyClass(); } ?> ]]> - </programlisting> - </example> - </para> - <para> - <function>class_exists</function> essayera d'appeler &link.autoload; par défaut. - Si vous ne le voulez pas, vous pouvez définir le paramètre - <parameter>autoload</parameter> à &false;. - </para> - <para> - <example> - <title>Exemple avec le paramètre <parameter>autoload</parameter></title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Exemple avec le paramètre <parameter>autoload</parameter></title> + <programlisting role="php"> <![CDATA[ <?php -function __autoload($class) { +function __autoload($class) +{ include($class . '.php'); - /* Vérifie si l'include définie la classe */ - if ( !class_exists($class, false) ) { - trigger_error("Impossible de charger la classe $class", E_USER_ERROR); + // Vérifie si l'include définie la classe + if (!class_exists($class, false)) { + trigger_error("Impossible de charger la classe : $class", E_USER_WARNING); } } -if (class_exists('MaClasse')) { - $maclasse = new MaClasse(); +if (class_exists('MyClass')) { + $myclass = new MyClass(); } ?> ]]> - </programlisting> - </example> - </para> - <note> - <para> - Le paramètre <parameter>autoload</parameter> a été ajouté en &php; 5. - </para> - </note> - <simpara> - Voir aussi - <function>get_declared_classes</function> et - <function>interface_exists</function>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>interface_exists</function></member> + <member><function>get_declared_classes</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -96,4 +144,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/get-class-methods.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/classobj/functions/get-class-methods.xml diff -u phpdoc-fr/reference/classobj/functions/get-class-methods.xml:1.15 phpdoc-fr/reference/classobj/functions/get-class-methods.xml:1.16 --- phpdoc-fr/reference/classobj/functions/get-class-methods.xml:1.15 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/get-class-methods.xml Wed Jan 17 20:54:39 2007 @@ -1,105 +1,139 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.12 Maintainer: dams Status: ready --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.14 Maintainer: dams Status: ready --> <!-- Reviewed: no --> - - <refentry id="function.get-class-methods"> - <refnamediv> - <refname>get_class_methods</refname> - <refpurpose>Retourne les noms des méthodes d'une classe</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>get_class_methods</methodname> - <methodparam><type>mixed</type><parameter>class_name</parameter></methodparam> - </methodsynopsis> - <para> - <function>get_class_methods</function> retourne un tableau contenant les - noms des méthodes de la classe <parameter>class_name</parameter>. - En cas d'erreur, &null; est retourné. - </para> - <note> - <para> - À partir de &php; 4.0.6, vous pouvez spécifier l'objet lui-même, au lieu - de sa classe <parameter>class_name</parameter>. Par exemple : - <example> - <title> - Passer l'objet ou la classe à <function>get_class_methods</function> - </title> - <programlisting role="php"> -<![CDATA[ -<?php -$class_methods = get_class_methods($my_object); // Voir plus loin l'exemple complet -?> -]]> - </programlisting> - </example> - </para> - </note> - <para> - <example> - <title>Exemple avec <function>get_class_methods</function></title> - <programlisting role="php"> +<refentry id="function.get-class-methods"> + <refnamediv> + <refname>get_class_methods</refname> + <refpurpose>Retourne les noms des méthodes d'une classe</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>get_class_methods</methodname> + <methodparam><type>mixed</type><parameter>class_name</parameter></methodparam> + </methodsynopsis> + <para> + Retourne les noms des méthodes d'une classe. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>class_name</parameter></term> + <listitem> + <para> + Le nom de la classe d'une instance + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau contenant les noms des méthodes de la classe + <parameter>class_name</parameter>. En cas d'erreur, &null; + est retourné. + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.0.0</entry> + <entry> + Depuis &php; 5, cette fonction retourne le nom des méthodes telles + quelles sont déclarées (sensible à la casse). En &php; 4, elles étaient + en minuscules. + </entry> + </row> + <row> + <entry>4.0.6</entry> + <entry> + La possibilité de spécifier l'objet lui-même a été ajoutée. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>get_class_methods</function></title> + <programlisting role="php"> <![CDATA[ <?php -class maclasse { +class myclass { // constructeur - function maclasse() + function myclass() { - return(TRUE); + return(true); } // méthode 1 function myfunc1() { - return(TRUE); + return(true); } // méthode 2 - function mafunc2() + function myfunc2() { - return(TRUE); + return(true); } } -$class_methods = get_class_methods('maclasse'); +$class_methods = get_class_methods('myclass'); // ou -$class_methods = get_class_methods(new maclasse()); +$class_methods = get_class_methods(new myclass()); foreach ($class_methods as $method_name) { echo "$method_name\n"; } + ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ -maclasse +myclass myfunc1 -mafunc2 +myfunc2 ]]> - </screen> - </example> - </para> - <warning> - <para> - Depuis &php; 5, cette fonction retourne le nom des méthodes comme - elles ont été déclarées (sensible à la casse). En &php; 4, elles étaient - converties en minuscule. - </para> - </warning> - <simpara> - Voir aussi - <function>get_class</function>, - <function>get_class_vars</function> et - <function>get_object_vars</function>. - </simpara> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>get_class</function></member> + <member><function>get_class_vars</function></member> + <member><function>get_object_vars</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/get-class-vars.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/classobj/functions/get-class-vars.xml diff -u phpdoc-fr/reference/classobj/functions/get-class-vars.xml:1.11 phpdoc-fr/reference/classobj/functions/get-class-vars.xml:1.12 --- phpdoc-fr/reference/classobj/functions/get-class-vars.xml:1.11 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/get-class-vars.xml Wed Jan 17 20:54:39 2007 @@ -1,49 +1,93 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.9 Maintainer: dams Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.11 Maintainer: dams Status: ready --> <!-- Reviewed: no --> - <refentry id="function.get-class-vars"> - <refnamediv> - <refname>get_class_vars</refname> - <refpurpose> - Retourne les valeurs par défaut des propriétés d'une classe - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>get_class_vars</methodname> - <methodparam><type>string</type><parameter>class_name</parameter></methodparam> - </methodsynopsis> - <para> - <function>get_class_vars</function> retourne un tableau contenant les - valeurs par défaut des propriétés publiques de la classe - <parameter>class_name</parameter>. - </para> - <note> - <para> - Avant &php; 4.2.0, les variables de classe non initialisées n'étaient - pas rapportées par <function>get_class_vars</function>. - </para> - </note> - <para> - <example> - <title>Exemple avec <function>get_class_vars</function></title> - <programlisting role="php"> +<refentry id="function.get-class-vars"> + <refnamediv> + <refname>get_class_vars</refname> + <refpurpose>Retourne les valeurs par défaut des propriétés d'une classe</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>get_class_vars</methodname> + <methodparam><type>string</type><parameter>class_name</parameter></methodparam> + </methodsynopsis> + <para> + Retourne les valeurs par défaut des propriétés d'une classe. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>class_name</parameter></term> + <listitem> + <para> + Le nom de la classe + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + retourne un tableau contenant les valeurs par défaut des + propriétés publiques de la classe <parameter>class_name</parameter>. + Les éléments du tableau résultant sont sous la forme : + <literal>nom_variable => valeur</literal>. + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Avant la version 4.2.0</entry> + <entry> + les variables de classe non initialisées n'étaient pas + rapportées par <function>get_class_vars</function>. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>get_class_vars</function></title> + <programlisting role="php"> <![CDATA[ <?php class myclass { - var $var1; // this has no default value... + var $var1; // pas de valeur par défaut... var $var2 = "xyz"; var $var3 = 100; private $var4; // PHP 5 - + // constructeur function myclass() { - return(TRUE); + // changement de quelques propriétés + $this->var1 = "foo"; + $this->var2 = "bar"; + return true; } } @@ -56,7 +100,7 @@ echo "$name : $value\n"; } -?> +?> ]]> </programlisting> &example.outputs; @@ -70,15 +114,19 @@ var1 : var2 : xyz var3 : 100 -]]> +]]> </screen> </example> </para> - <simpara> - Voir aussi - <function>get_class_methods</function> et - <function>get_object_vars</function>. - </simpara> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>get_class_methods</function></member> + <member><function>get_object_vars</function></member> + </simplelist> + </para> </refsect1> </refentry> @@ -101,4 +149,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/get-class.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/classobj/functions/get-class.xml diff -u phpdoc-fr/reference/classobj/functions/get-class.xml:1.12 phpdoc-fr/reference/classobj/functions/get-class.xml:1.13 --- phpdoc-fr/reference/classobj/functions/get-class.xml:1.12 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/get-class.xml Wed Jan 17 20:54:39 2007 @@ -1,83 +1,130 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.8 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.10 Maintainer: dams Status: ready --> <!-- Reviewed: no --> - <refentry id="function.get-class"> - <refnamediv> - <refname>get_class</refname> - <refpurpose>Retourne la classe d'un objet</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>get_class</methodname> - <methodparam choice="opt"><type>object</type><parameter>obj</parameter></methodparam> - </methodsynopsis> - <para> - <function>get_class</function> retourne la classe de l'objet - <parameter>obj</parameter>. <function>get_class</function> retourne - &false; si <parameter>obj</parameter> n'est pas un objet. - </para> - <note> - <simpara> - <function>get_class</function> retourne un nom de classe utilisateur, - en minuscules. Une classe définie par une extension &php; est retournée - dans sa notation originale. - </simpara> - </note> - <note> - <para> - Depuis &php; 5, <parameter>obj</parameter> est optionnel s'il est appelé - depuis la méthode de l'objet. - </para> - </note> - <para> - <example> - <title>Exemple avec <function>get_class</function></title> - <programlisting role="php"> +<refentry id="function.get-class"> + <refnamediv> + <refname>get_class</refname> + <refpurpose>Retourne la classe d'un objet</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>get_class</methodname> + <methodparam choice="opt"><type>object</type><parameter>object</parameter></methodparam> + </methodsynopsis> + <para> + Retourne la classe de l'objet <parameter>obj</parameter>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>object</parameter></term> + <listitem> + <para> + L'objet testé + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nom de la classe pour laquelle <parameter>object</parameter> + est une instance. Retourne &false; si <parameter>object</parameter> + n'est pas un objet. + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Depuis 5.0.0</entry> + <entry> + Le nom de la classe est retourné dans sa notation originale. + </entry> + </row> + <row> + <entry>Depuis 5.0.0</entry> + <entry> + Le paramètre <parameter>object</parameter> est optionnel + s'il est appelé depuis la méthode de l'objet. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>get_class</function></title> + <programlisting role="php"> <![CDATA[ <?php class foo { - function foo() { + function foo() + { // un peu de code } - function name() { + function name() + { echo "Mon nom est " , get_class($this) , "\n"; } } -// create an object +// création d'un objet $bar = new foo(); -// external call +// Appel externe echo "Son nom est " , get_class($bar) , "\n"; -// internal call +// Appel interne $bar->name(); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Son nom est foo Mon nom est foo ]]> - </screen> - </example> - </para> - <para> - Voir aussi - <function>get_parent_class</function>, - <function>gettype</function> et - <function>is_subclass_of</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>get_parent_class</function></member> + <member><function>gettype</function></member> + <member><function>is_subclass_of</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -98,4 +145,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/get-declared-classes.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/classobj/functions/get-declared-classes.xml diff -u phpdoc-fr/reference/classobj/functions/get-declared-classes.xml:1.11 phpdoc-fr/reference/classobj/functions/get-declared-classes.xml:1.12 --- phpdoc-fr/reference/classobj/functions/get-declared-classes.xml:1.11 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/get-declared-classes.xml Wed Jan 17 20:54:39 2007 @@ -1,53 +1,62 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.8 Maintainer: dams Status: ready --> <!-- Reviewed: no --> - <refentry id="function.get-declared-classes"> - <refnamediv> - <refname>get_declared_classes</refname> - <refpurpose>Liste toutes les classes définies</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>get_declared_classes</methodname> - <void/> - </methodsynopsis> +<refentry id="function.get-declared-classes"> + <refnamediv> + <refname>get_declared_classes</refname> + <refpurpose>Liste toutes les classes définies</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>get_declared_classes</methodname> + <void/> + </methodsynopsis> + <para> + Liste toutes les classes définies. + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau contenant la liste des classes déclarées + dans le script courant. + </para> + <note> <para> - <function>get_declared_classes</function> retourne un tableau contenant - la liste des classes déclarées dans le script courant. + En &php; 4.0.1pl2, trois classes supplémentaires sont retournées, au + début de ce tableau : <classname>stdClass</classname> (définie dans + <filename>Zend/zend.c</filename>), + <classname>OverloadedTestClass</classname> (définie dans + <filename>ext/standard/basic_functions.c</filename>) + et <classname>Directory</classname> + (définie dans <filename>ext/standard/dir.c</filename>). </para> - <note> - <para> - En &php; 4.0.1pl2, trois classes supplémentaires sont retournées, au - début de ce tableau : <classname>stdClass</classname> (définie dans - <filename>Zend/zend.c</filename>), - <classname>OverloadedTestClass</classname> (définie dans - <filename>ext/standard/basic_functions.c</filename>) - et <classname>Directory</classname> - (définie dans <filename>ext/standard/dir.c</filename>). - </para> - <para> - De plus, notez que suivant les bibliothèques qui sont compilées - avec &php;, d'autres classes peuvent être présentes. Cela signifie - que vous ne pourrez pas utiliser ces noms de classe pour définir vos propres - classes. Voici une liste des - <link linkend="reserved.classes">classes pré-définies</link>. - </para> - </note> - <para> - <example> - <title>Exemple avec <function>get_declared_classes</function></title> - <programlisting role="php"> + <para> + De plus, notez que suivant les bibliothèques qui sont compilées + avec &php;, d'autres classes peuvent être présentes. Cela signifie + que vous ne pourrez pas utiliser ces noms de classe pour définir vos propres + classes. Voici une liste des + <link linkend="reserved.classes">classes pré-définies</link>. + </para> + </note> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>get_declared_classes</function></title> + <programlisting role="php"> <![CDATA[ <?php print_r(get_declared_classes()); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs.similar; + <screen> <![CDATA[ Array ( @@ -56,16 +65,20 @@ [2] => Directory ) ]]> - </screen> - </example> - </para> - <simpara> - Voir aussi - <function>class_exists</function> et - <function>get_declared_interfaces</function>. - </simpara> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>class_exists</function></member> + <member><function>get_declared_interfaces</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -86,4 +99,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/get-declared-interfaces.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-fr/reference/classobj/functions/get-declared-interfaces.xml diff -u phpdoc-fr/reference/classobj/functions/get-declared-interfaces.xml:1.7 phpdoc-fr/reference/classobj/functions/get-declared-interfaces.xml:1.8 --- phpdoc-fr/reference/classobj/functions/get-declared-interfaces.xml:1.7 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/get-declared-interfaces.xml Wed Jan 17 20:54:39 2007 @@ -1,37 +1,44 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.4 Maintainer: dams Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> <!-- Reviewed: no --> - <refentry id="function.get-declared-interfaces"> - <refnamediv> - <refname>get_declared_interfaces</refname> - <refpurpose> - Retourne un tableau avec toutes les interfaces déclarées - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>get_declared_interfaces</methodname> - <void/> - </methodsynopsis> - <para> - <function>get_declared_interfaces</function> retourne un tableau - avec la liste de toutes les interfaces déclarées dans le script courant. - </para> - <para> - <example> - <title>Exemple avec <function>get_declared_interfaces</function></title> - <programlisting role="php"> +<refentry id="function.get-declared-interfaces"> + <refnamediv> + <refname>get_declared_interfaces</refname> + <refpurpose>Retourne un tableau avec toutes les interfaces déclarées</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>get_declared_interfaces</methodname> + <void/> + </methodsynopsis> + <para> + Retourne un tableau avec toutes les interfaces déclarées. + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau contenant les noms des interfaces déclarées dans + le script courant. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>get_declared_interfaces</function></title> + <programlisting role="php"> <![CDATA[ <?php print_r(get_declared_interfaces()); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs.similar; + <screen> <![CDATA[ Array ( @@ -44,15 +51,19 @@ [6] => SeekableIterator ) ]]> - </screen> - </example> - </para> - <simpara> - Voir aussi - <function>get_declared_classes</function>. - </simpara> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>get_declared_classes</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -73,4 +84,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/get-object-vars.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/classobj/functions/get-object-vars.xml diff -u phpdoc-fr/reference/classobj/functions/get-object-vars.xml:1.12 phpdoc-fr/reference/classobj/functions/get-object-vars.xml:1.13 --- phpdoc-fr/reference/classobj/functions/get-object-vars.xml:1.12 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/get-object-vars.xml Wed Jan 17 20:54:39 2007 @@ -1,63 +1,105 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.8 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.10 Maintainer: dams Status: ready --> <!-- Reviewed: no --> - <refentry id="function.get-object-vars"> - <refnamediv> - <refname>get_object_vars</refname> - <refpurpose> - Retourne un tableau associatif des propriétés d'un objet - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>get_object_vars</methodname> - <methodparam><type>object</type><parameter>obj</parameter></methodparam> - </methodsynopsis> - <para> - <function>get_object_vars</function> retourne un tableau associatif - contenant les propriétés de l'objet <parameter>obj</parameter>. - Les clés du tableau sont les noms des propriétés - de l'objet. - </para> - <note> +<refentry id="function.get-object-vars"> + <refnamediv> + <refname>get_object_vars</refname> + <refpurpose>Retourne un tableau associatif des propriétés d'un objet</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>get_object_vars</methodname> + <methodparam><type>object</type><parameter>object</parameter></methodparam> + </methodsynopsis> + <para> + Récupère les propriétés de l'objet <parameter>object</parameter> fourni. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>object</parameter></term> + <listitem> <para> - Dans les versions antérieures à la &php; 4.2.0, si les variables déclarées - dans la classe de l'objet <parameter>obj</parameter>, n'avaient - pas été assignées, elles n'apparaissaient pas dans le tableau - retourné. Depuis &php; 4.2.0, elles apparaissent, avec la valeur - &null;. + Une instance d'un objet. </para> - </note> - <para> - <example> - <title>Exemple avec <function>get_object_vars</function></title> - <programlisting role="php"> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau associatif contenant les propriétés + de l'objet <parameter>obj</parameter>. Si une propriété + n'a pas de valeur d'assignée, elle sera retournée avec une + valeur &null;. + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Avant 4.2.0</entry> + <entry> + Si les variables déclarées dans la classe de l'objet + <parameter>obj</parameter>, n'avaient pas + été assignées, elles n'apparaissaient pas dans le tableau + retourné + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>get_object_vars</function></title> + <programlisting role="php"> <![CDATA[ <?php class Point2D { var $x, $y; var $label; - function Point2D($x, $y) { + function Point2D($x, $y) + { $this->x = $x; $this->y = $y; } - function setLabel($label) { + function setLabel($label) + { $this->label = $label; } - function getPoint() { + function getPoint() + { return array("x" => $this->x, "y" => $this->y, "label" => $this->label); } } -// "$label" est déclaré mais non défini +// "$label" est déclaré mais n'est pas défini $p1 = new Point2D(1.233, 3.445); print_r(get_object_vars($p1)); @@ -66,9 +108,9 @@ ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Array ( @@ -84,16 +126,20 @@ [label] => point #1 ) ]]> - </screen> - </example> - </para> - <simpara> - Voir aussi - <function>get_class_methods</function> et - <function>get_class_vars</function>. - </simpara> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>get_class_methods</function></member> + <member><function>get_class_vars</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -114,4 +160,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/get-parent-class.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/classobj/functions/get-parent-class.xml diff -u phpdoc-fr/reference/classobj/functions/get-parent-class.xml:1.13 phpdoc-fr/reference/classobj/functions/get-parent-class.xml:1.14 --- phpdoc-fr/reference/classobj/functions/get-parent-class.xml:1.13 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/get-parent-class.xml Wed Jan 17 20:54:39 2007 @@ -1,58 +1,115 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.8 Maintainer: dams Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.10 Maintainer: dams Status: ready --> <!-- Reviewed: no --> - <refentry id="function.get-parent-class"> - <refnamediv> - <refname>get_parent_class</refname> - <refpurpose>Retourne le nom de la classe d'un objet</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>get_parent_class</methodname> - <methodparam choice="opt"><type>mixed</type><parameter>obj</parameter></methodparam> - </methodsynopsis> - <para> - <function>get_parent_class</function> retourne le nom de la classe - de l'objet <parameter>obj</parameter>. - </para> - <para> - Si le paramètre <parameter>obj</parameter> est une chaîne, - <function>get_parent_class</function> retourne le nom de la classe - parente. Cette fonctionnalité a été ajoutée en &php; 4.0.5. - </para> - <note> - <para> - Depuis &php; 5, <parameter>obj</parameter> est optionnel s'il est appelé - depuis la méthode de l'objet. - Si appelée sans paramètre en dehors de l'objet, cette fonction retourne - &false; (ou &null; avec un avertissement avant &php; 5.1.0). - </para> - </note> - <para> - <example> - <title>Exemple avec <function>get_parent_class</function></title> - <programlisting> +<refentry id="function.get-parent-class"> + <refnamediv> + <refname>get_parent_class</refname> + <refpurpose>Retourne le nom de la classe d'un objet</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>get_parent_class</methodname> + <methodparam choice="opt"><type>mixed</type><parameter>object</parameter></methodparam> + </methodsynopsis> + <para> + Récupère le nom de classe parent pour un objet ou une classe. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>object</parameter></term> + <listitem> + <para> + L'objet ou le nom de la classe testé + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nom de la classe parent dont + <parameter>object</parameter> est une instance ou le nom. + </para> + <para> + Si appelée sans paramètre en dehors de l'objet, cette fonction retourne + &false;. + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Avant 5.1.0</entry> + <entry> + Si appelée sans paramètre en dehors de l'objet, cette fonction retourne + &null; avec une alerte. + </entry> + </row> + <row> + <entry>Depuis 5.0.0</entry> + <entry> + Le paramètre <parameter>object</parameter> est optionnel si appelé + depuis la méthode de l'objet. + </entry> + </row> + <row> + <entry>Depuis 4.0.5</entry> + <entry> + Si le paramètre <parameter>obj</parameter> est une chaîne, + <function>get_parent_class</function> retourne le nom de la classe + parente. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>get_parent_class</function></title> + <programlisting role="php"> <![CDATA[ <?php -class papa { - function papa() { +class dad { + function dad() + { // un peu de code } } class child extends papa { - function child() { - echo "je suis le fils de " , get_parent_class($this) , "\n"; + function child() + { + echo "je suis le fils de " , get_parent_class($this) , "\n"; } } class child2 extends papa { - function child2() { - echo "Je suis aussi le papa de " , get_parent_class('child2') , "\n"; + function child2() + { + echo "Je suis aussi le papa de " , get_parent_class('child2') , "\n"; } } @@ -61,23 +118,27 @@ ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ je suis le fils de papa Je suis aussi le papa de papa ]]> - </screen> - </example> - </para> - <para> - Voir aussi - <function>get_class</function> et - <function>is_subclass_of</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>get_class</function></member> + <member><function>is_subclass_of</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -98,4 +159,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/interface-exists.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/classobj/functions/interface-exists.xml diff -u phpdoc-fr/reference/classobj/functions/interface-exists.xml:1.3 phpdoc-fr/reference/classobj/functions/interface-exists.xml:1.4 --- phpdoc-fr/reference/classobj/functions/interface-exists.xml:1.3 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/interface-exists.xml Wed Jan 17 20:54:39 2007 @@ -1,34 +1,66 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.interface-exists"> - <refnamediv> - <refname>interface_exists</refname> - <refpurpose>Vérifie si une interface a été définie</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>interface_exists</methodname> - <methodparam><type>string</type><parameter>interface_name</parameter></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>autoload</parameter></methodparam> - </methodsynopsis> - <para> - <methodname>interface_exists</methodname> retourne &true; si - l'interface <parameter>interface_name</parameter> a été définie, - et &false; sinon. - </para> - <para> - <example> - <title>Exemple avec <function>interface_exists</function></title> - <programlisting role="php"> +<refentry id="function.interface-exists"> + <refnamediv> + <refname>interface_exists</refname> + <refpurpose>Vérifie si une interface a été définie</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>interface_exists</methodname> + <methodparam><type>string</type><parameter>interface_name</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>autoload</parameter></methodparam> + </methodsynopsis> + <para> + Vérifie si une interface a été définie. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>interface_name</parameter></term> + <listitem> + <para> + Le nom de l'interface + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>autoload</parameter></term> + <listitem> + <para> + Si l'on doit appeler &link.autoload; ou non par défaut + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne &true; si l'interface fournie par le paramètre + <parameter>interface_name</parameter> a été définie, + &false; sinon. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>interface_exists</function></title> + <programlisting role="php"> <![CDATA[ <?php // Vérifie si l'interface existe avant de l'utiliser -if (interface_exists('MonInterface')) { - class MaClasse implements MonInterface +if (interface_exists('MyInterface')) { + class MyClass implements MyInterface { // Méthodes } @@ -36,21 +68,19 @@ ?> ]]> - </programlisting> - </example> - </para> - <para> - <function>interface_exists</function> essaiera d'appeler &link.autoload; par - défaut. Si vous ne voulez pas que <function>interface_exists</function> appelle - &link.autoload;, vous pouvez donner au paramètre <parameter>autoload</parameter> - la valeur de &false;. - </para> - <simpara> - Voir aussi - <function>class_exists</function>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>class_exists</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -71,4 +101,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/is-a.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/classobj/functions/is-a.xml diff -u phpdoc-fr/reference/classobj/functions/is-a.xml:1.8 phpdoc-fr/reference/classobj/functions/is-a.xml:1.9 --- phpdoc-fr/reference/classobj/functions/is-a.xml:1.8 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/is-a.xml Wed Jan 17 20:54:39 2007 @@ -1,31 +1,67 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.7 Maintainer: dams Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.is-a"> - <refnamediv> - <refname>is_a</refname> - <refpurpose> - Retourne &true; si un objet a pour parent une classe donnée - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>is_a</methodname> - <methodparam><type>object</type><parameter>object</parameter></methodparam> - <methodparam><type>string</type><parameter>class_name</parameter></methodparam> - </methodsynopsis> - <para> - <function>is_a</function> retourne &true; si l'objet <parameter>object</parameter> - a pour classe <parameter>class_name</parameter>, ou bien si <parameter>class_name</parameter> - est un de ses parents. <function>is_a</function> retourne &false; sinon. - </para> - <para> - <example> - <title>Exemple avec <function>is_a</function></title> - <programlisting role="php"> +<refentry id="function.is-a"> + <refnamediv> + <refname>is_a</refname> + <refpurpose>Vérifie si l'objet fait parti d'une classe ou a cette classe comme parents</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>is_a</methodname> + <methodparam><type>object</type><parameter>object</parameter></methodparam> + <methodparam><type>string</type><parameter>class_name</parameter></methodparam> + </methodsynopsis> + <para> + Vérifie si l'objet <parameter>object</parameter>fait parti de cette classe ou + a cette classe comme parents. + </para> + <note> + <para> + La fonction <function>is_a</function> est déconseillé en &php; 5 en faveur de + l'opérateur de type <link linkend="language.operators.type">instanceof</link>. + </para> + </note> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>object</parameter></term> + <listitem> + <para> + L'objet testé + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>class_name</parameter></term> + <listitem> + <para> + Le nom de la classe + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne &true; si l'objet fait parti de cette classe ou a cette classe comme parents, + &false; sinon. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>is_a</function></title> + <programlisting role="php"> <![CDATA[ <?php // Définit une classe @@ -42,18 +78,11 @@ } ?> ]]> - </programlisting> - </example> - </para> - <para> - La fonction <function>is_a</function> est déconseillé en &php; 5 en faveur de - l'opérateur de type <link linkend="language.operators.type">instanceof</link>. - Voir un exemple de cette utilisation avec &php; 5 : - </para> - <para> - <example> - <title>Utilisation de l'opérateur <emphasis>instanceof</emphasis> avec &php; 5</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Utilisation de l'opérateur <emphasis>instanceof</emphasis> avec &php; 5</title> + <programlisting role="php"> <![CDATA[ <?php if ($WF instanceof WidgetFactory) { @@ -61,17 +90,21 @@ } ?> ]]> - </programlisting> - </example> - </para> - <simpara> - Voir aussi - <function>get_class</function>, - <function>get_parent_class</function> et - <function>is_subclass_of</function>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>get_class</function></member> + <member><function>get_parent_class</function></member> + <member><function>is_subclass_of</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -92,4 +125,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/is-subclass-of.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/classobj/functions/is-subclass-of.xml diff -u phpdoc-fr/reference/classobj/functions/is-subclass-of.xml:1.12 phpdoc-fr/reference/classobj/functions/is-subclass-of.xml:1.13 --- phpdoc-fr/reference/classobj/functions/is-subclass-of.xml:1.12 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/is-subclass-of.xml Wed Jan 17 20:54:39 2007 @@ -1,50 +1,101 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.5 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.is-subclass-of"> - <refnamediv> - <refname>is_subclass_of</refname> - <refpurpose>Détermine si un objet est une sous-classe</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>is_subclass_of</methodname> - <methodparam><type>mixed</type><parameter>object</parameter></methodparam> - <methodparam><type>string</type><parameter>class_name</parameter></methodparam> - </methodsynopsis> - <para> - <function>is_subclass_of</function> retourne &true; si l'objet - <parameter>object</parameter> est une sous-classe de - <parameter>class_name</parameter>, &false; sinon. - </para> - <note> - <para> - Depuis &php; 5.0.3, vous devez également spécifier le paramètre - <parameter>object</parameter> en tant que chaîne de caractères (le nom de la classe). - </para> - </note> - <para> - <example> - <title>Exemple avec <function>is_subclass_of</function></title> - <programlisting role="php"> +<refentry id="function.is-subclass-of"> + <refnamediv> + <refname>is_subclass_of</refname> + <refpurpose>Détermine si un objet est une sous-classe</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>is_subclass_of</methodname> + <methodparam><type>mixed</type><parameter>object</parameter></methodparam> + <methodparam><type>string</type><parameter>class_name</parameter></methodparam> + </methodsynopsis> + <para> + Vérifie si l'objet <parameter>object</parameter> a la classe + <parameter>class_name</parameter> comme parents. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>object</parameter></term> + <listitem> + <para> + Un nom de classe ou une instance d'un objet + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>class_name</parameter></term> + <listitem> + <para> + Le nom de la classe + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Cette fonction retourne &true; si l'objet <parameter>object</parameter>, + appartient à une classe qui est une sous-classe de + <parameter>class_name</parameter>, &false; sinon. + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.0.3</entry> + <entry> + vous devez également spécifier le paramètre <parameter>object</parameter> + en tant que chaîne de caractères (le nom de la classe). + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>is_subclass_of</function></title> + <programlisting role="php"> <![CDATA[ <?php -// définition d'une classe +// Définit une classe class WidgetFactory { var $oink = 'moo'; } -// définition d'une sous-classe +// Définit une sous-classe class WidgetFactory_Child extends WidgetFactory { var $oink = 'oink'; } -// création d'un nouvel objet +// Création d'un nouvel objet $WF = new WidgetFactory(); $WFC = new WidgetFactory_Child(); @@ -54,12 +105,14 @@ echo "non, \$WFC n'est pas une sous-classe de la classe WidgetFactory\n"; } + if (is_subclass_of($WF, 'WidgetFactory')) { echo "oui, \$WF est une sous-classe de la classe WidgetFactory\n"; } else { echo "non, \$WF n'est pas une sous-classe de la classe WidgetFactory\n"; } + // utilisable uniquement depuis PHP 5.0.3 if (is_subclass_of('WidgetFactory_Child', 'WidgetFactory')) { echo "oui, WidgetFactory_Child est une sous-classe de la classe WidgetFactory\n"; @@ -68,24 +121,29 @@ } ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ oui, $WFC est une sous-classe de la classe WidgetFactory non, $WF n'est pas une sous-classe de la classe WidgetFactory oui, WidgetFactory_Child est une sous-classe de la classe WidgetFactory ]]> - </screen> - </example> - </para> - <simpara> - Voir aussi - <function>get_class</function> et - <function>get_parent_class</function>. - </simpara> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>get_class</function></member> + <member><function>get_parent_class</function></member> + <member><function>is_a</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -106,4 +164,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/method-exists.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/classobj/functions/method-exists.xml diff -u phpdoc-fr/reference/classobj/functions/method-exists.xml:1.12 phpdoc-fr/reference/classobj/functions/method-exists.xml:1.13 --- phpdoc-fr/reference/classobj/functions/method-exists.xml:1.12 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/method-exists.xml Wed Jan 17 20:54:39 2007 @@ -1,52 +1,88 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.5 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.method-exists"> - <refnamediv> - <refname>method_exists</refname> - <refpurpose>Vérifie que la méthode existe pour une classe</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>method_exists</methodname> - <methodparam><type>object</type><parameter>object</parameter></methodparam> - <methodparam><type>string</type><parameter>method_name</parameter></methodparam> - </methodsynopsis> - <para> - <function>method_exists</function> retourne &true; - si la méthode <parameter>method_name</parameter> a - été définie pour la classe - <parameter>object</parameter>, et sinon, retourne &false;. - </para> - <para> - <example> - <title>Exemple avec <function>method_exists</function></title> - <programlisting role="php"> +<refentry id="function.method-exists"> + <refnamediv> + <refname>method_exists</refname> + <refpurpose>Vérifie que la méthode existe pour une classe</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>method_exists</methodname> + <methodparam><type>object</type><parameter>object</parameter></methodparam> + <methodparam><type>string</type><parameter>method_name</parameter></methodparam> + </methodsynopsis> + <para> + Vérifie si la méthode existe pour l'objet + <parameter>object</parameter> fourni. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>object</parameter></term> + <listitem> + <para> + Une instance d'un objet + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>method_name</parameter></term> + <listitem> + <para> + Le nom de la méthode + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne &true; si la méthode fournie par le paramètre + <parameter>method_name</parameter> a été définie pour l'objet + <parameter>object</parameter>, &false; sinon. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>method_exists</function></title> + <programlisting role="php"> <![CDATA[ <?php $directory = new Directory('.'); var_dump(method_exists($directory,'read')); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ bool(true) ]]> - </screen> - </example> - </para> - <para> - Voir aussi - <function>function_exists</function> et - <function>is_callable</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>function_exists</function></member> + <member><function>is_callable</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/property-exists.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-fr/reference/classobj/functions/property-exists.xml diff -u phpdoc-fr/reference/classobj/functions/property-exists.xml:1.4 phpdoc-fr/reference/classobj/functions/property-exists.xml:1.5 --- phpdoc-fr/reference/classobj/functions/property-exists.xml:1.4 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/property-exists.xml Wed Jan 17 20:54:39 2007 @@ -1,9 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.property-exists"> <refnamediv> <refname>property_exists</refname> @@ -26,12 +25,11 @@ <note> <para> À l'opposé de la fonction <function>isset</function>, - <function>property_exists</function> retourne &true; + <function>property_exists</function> retourne &true; même si la propriété a une valeur &null;. </para> </note> </refsect1> - <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -40,7 +38,7 @@ <term><parameter>class</parameter></term> <listitem> <para> - Une chaîne contenant le nom de la classe ou un objet de la classe à tester + Le nom de la classe ou un objet de la classe à tester </para> </listitem> </varlistentry> @@ -55,15 +53,13 @@ </variablelist> </para> </refsect1> - <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Retourne &true; si la propriété existe, &false; si elle n'existe pas ou &null; + Retourne &true; si la propriété existe, &false; si elle n'existe pas et &null; si une erreur survient. </para> </refsect1> - <refsect1 role="examples"> &reftitle.examples; <para> @@ -84,7 +80,7 @@ var_dump(property_exists('myClass', 'mine')); //true var_dump(property_exists(new myClass, 'mine')); //true -var_dump(property_exists('myClass', 'xpto')); //false, n'est pas publique +var_dump(property_exists('myClass', 'xpto')); //false, non publique myClass::test(); ?> @@ -93,7 +89,6 @@ </example> </para> </refsect1> - <refsect1 role="seealso"> &reftitle.seealso; <para> @@ -123,4 +118,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/call-user-method-array.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/classobj/functions/call-user-method-array.xml diff -u phpdoc-fr/reference/classobj/functions/call-user-method-array.xml:1.12 phpdoc-fr/reference/classobj/functions/call-user-method-array.xml:1.13 --- phpdoc-fr/reference/classobj/functions/call-user-method-array.xml:1.12 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/call-user-method-array.xml Wed Jan 17 20:54:39 2007 @@ -1,44 +1,40 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.7 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.call-user-method-array"> - <refnamediv> - <refname>call_user_method_array</refname> - <refpurpose> - Appelle une méthode utilisateur avec un tableau de paramètres - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>mixed</type><methodname>call_user_method_array</methodname> - <methodparam><type>string</type><parameter>method_name</parameter></methodparam> - <methodparam><type>object</type><parameter role="reference">obj</parameter></methodparam> - <methodparam><type>array</type><parameter>paramarr</parameter></methodparam> - </methodsynopsis> - <warning> - <para> - La fonction <function>call_user_method_array</function> est obsolète - depuis &php; 4.1.0, utilisez plutôt la fonction - <function>call_user_func_array</function> avec la syntaxe - <literal>array(&$obj, "method_name")</literal>. - </para> - </warning> +<refentry id="function.call-user-method-array"> + <refnamediv> + <refname>call_user_method_array</refname> + <refpurpose>Appelle une méthode utilisateur avec un tableau de paramètres [obsolète]</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>call_user_method_array</methodname> + <methodparam><type>string</type><parameter>method_name</parameter></methodparam> + <methodparam><type>object</type><parameter role="reference">obj</parameter></methodparam> + <methodparam><type>array</type><parameter>paramarr</parameter></methodparam> + </methodsynopsis> + <warning> <para> - <function>call_user_method_array</function> appelle la méthode - <parameter>method_name</parameter> de l'objet <parameter>obj</parameter>, - en utilisant les paramètres <parameter>paramarr</parameter>, rassemblés - sous forme de tableau. + La fonction <function>call_user_method_array</function> est obsolète + depuis &php; 4.1.0, utilisez plutôt la fonction + <function>call_user_func_array</function> avec la syntaxe + <literal>array(&$obj, "method_name")</literal>. </para> - <para> - Voir aussi - <function>call_user_func_array</function> et - <function>call_user_func</function>. - </para> - </refsect1> - </refentry> + </warning> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>call_user_func_array</function></member> + <member><function>call_user_func</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -59,4 +55,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/call-user-method.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/classobj/functions/call-user-method.xml diff -u phpdoc-fr/reference/classobj/functions/call-user-method.xml:1.12 phpdoc-fr/reference/classobj/functions/call-user-method.xml:1.13 --- phpdoc-fr/reference/classobj/functions/call-user-method.xml:1.12 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/call-user-method.xml Wed Jan 17 20:54:39 2007 @@ -1,79 +1,40 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.10 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.call-user-method"> - <refnamediv> - <refname>call_user_method</refname> - <refpurpose> - Appelle une méthode utilisateur d'un objet - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>mixed</type><methodname>call_user_method</methodname> - <methodparam><type>string</type><parameter>method_name</parameter></methodparam> - <methodparam><type>object</type><parameter role="reference">obj</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter>parameter</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> - </methodsynopsis> - <warning> - <para> - La fonction <function>call_user_method</function> est abandonnée depuis - &php; 4.1.0, utilisez plutôt la fonction <function>call_user_func</function> - avec la syntaxe <literal>array(&$obj, "method_name")</literal>. - </para> - </warning> +<refentry id="function.call-user-method"> + <refnamediv> + <refname>call_user_method</refname> + <refpurpose>Appelle une méthode utilisateur d'un objet [obsolète]</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>call_user_method</methodname> + <methodparam><type>string</type><parameter>method_name</parameter></methodparam> + <methodparam><type>object</type><parameter role="reference">obj</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>parameter</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> + </methodsynopsis> + <warning> <para> - <function>call_user_method</function> appelle la méthode - <parameter>method_name</parameter> de l'objet - <parameter>obj</parameter>, avec les paramètres - <parameter>parameter</parameter>, <parameter>...</parameter>. - Un exemple d'utilisation de cet objet - est présenté ci-dessous, où une classe est définie, puis instantiée. - On utilise alors <function>call_user_method</function> pour appeler - indirectement les méthodes <varname>print_info</varname>. - <example> - <title>Exemple avec <function>call_user_method</function></title> - <programlisting role="php"> -<![CDATA[ -<?php -class Country { - var $NAME; - var $TLD; - - function Country($name, $tld) { - $this->NAME = $name; - $this->TLD = $tld; - } - - function print_info($prestr="") { - echo $prestr."Pays : ".$this->NAME."\n"; - echo $prestr."Top Level Domain : ".$this->TLD."\n"; - } -} - -$cntry = new Country("Perou","pe"); - -echo "* Appel de la méthode de l'objet directement\n"; -$cntry->print_info(); - -echo "\n* Appel de la méthode de l'objet indirectement\n"; -call_user_method ("print_info", $cntry, "\t"); -?> -]]> - </programlisting> - </example> + La fonction <function>call_user_method</function> est abandonnée depuis + &php; 4.1.0, utilisez plutôt la fonction <function>call_user_func</function> + avec la syntaxe <literal>array(&$obj, "method_name")</literal>. </para> - <simpara> - Voir aussi - <function>call_user_func_array</function> et - <function>call_user_func</function>. - </simpara> - </refsect1> - </refentry> + </warning> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>call_user_func_array</function></member> + <member><function>call_user_func</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -94,4 +55,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/class-exists.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc-fr/reference/classobj/functions/class-exists.xml diff -u phpdoc-fr/reference/classobj/functions/class-exists.xml:1.14 phpdoc-fr/reference/classobj/functions/class-exists.xml:1.15 --- phpdoc-fr/reference/classobj/functions/class-exists.xml:1.14 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/class-exists.xml Wed Jan 17 20:54:39 2007 @@ -1,81 +1,129 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> -<!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> +<!-- $Revision: 1.15 $ --> +<!-- EN-Revision: 1.8 Maintainer: dams Status: ready --> <!-- Reviewed: no --> - <refentry id="function.class-exists"> - <refnamediv> - <refname>class_exists</refname> - <refpurpose>Vérifie qu'une classe a été définie</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>class_exists</methodname> - <methodparam><type>string</type><parameter>class_name</parameter></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>autoload</parameter></methodparam> - </methodsynopsis> - <para> - <function>class_exists</function> retourne &true; si la classe - <parameter>class_name</parameter> a été définie, et &false; sinon. - </para> - <para> - <example> - <title>Exemple avec <function>class_exists</function></title> - <programlisting role="php"> +<refentry id="function.class-exists"> + <refnamediv> + <refname>class_exists</refname> + <refpurpose>Vérifie qu'une classe a été définie</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>class_exists</methodname> + <methodparam><type>string</type><parameter>class_name</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>autoload</parameter></methodparam> + </methodsynopsis> + <para> + Cette fonction vérifie si une classe donnée a été définie. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>class_name</parameter></term> + <listitem> + <para> + Le nom de la classe + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>autoload</parameter></term> + <listitem> + <para> + Si l'on doit appeler &link.autoload; ou non par défaut + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne &true; si <parameter>class_name</parameter> est une classe définie, + &false; sinon. + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.0.0</entry> + <entry> + La paramètre <parameter>autoload</parameter> a été ajoutée. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>class_exists</function></title> + <programlisting role="php"> <![CDATA[ <?php // Vérifiez que la classe existe avant de l'utiliser -if (class_exists('MaClasse')) { - $maclasse = new MaClasse(); +if (class_exists('MyClass')) { + $myclass = new MyClass(); } ?> ]]> - </programlisting> - </example> - </para> - <para> - <function>class_exists</function> essayera d'appeler &link.autoload; par défaut. - Si vous ne le voulez pas, vous pouvez définir le paramètre - <parameter>autoload</parameter> à &false;. - </para> - <para> - <example> - <title>Exemple avec le paramètre <parameter>autoload</parameter></title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Exemple avec le paramètre <parameter>autoload</parameter></title> + <programlisting role="php"> <![CDATA[ <?php -function __autoload($class) { +function __autoload($class) +{ include($class . '.php'); - /* Vérifie si l'include définie la classe */ - if ( !class_exists($class, false) ) { - trigger_error("Impossible de charger la classe $class", E_USER_ERROR); + // Vérifie si l'include définie la classe + if (!class_exists($class, false)) { + trigger_error("Impossible de charger la classe : $class", E_USER_WARNING); } } -if (class_exists('MaClasse')) { - $maclasse = new MaClasse(); +if (class_exists('MyClass')) { + $myclass = new MyClass(); } ?> ]]> - </programlisting> - </example> - </para> - <note> - <para> - Le paramètre <parameter>autoload</parameter> a été ajouté en &php; 5. - </para> - </note> - <simpara> - Voir aussi - <function>get_declared_classes</function> et - <function>interface_exists</function>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>interface_exists</function></member> + <member><function>get_declared_classes</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -96,4 +144,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/get-class-methods.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/classobj/functions/get-class-methods.xml diff -u phpdoc-fr/reference/classobj/functions/get-class-methods.xml:1.15 phpdoc-fr/reference/classobj/functions/get-class-methods.xml:1.16 --- phpdoc-fr/reference/classobj/functions/get-class-methods.xml:1.15 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/get-class-methods.xml Wed Jan 17 20:54:39 2007 @@ -1,105 +1,139 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.12 Maintainer: dams Status: ready --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.14 Maintainer: dams Status: ready --> <!-- Reviewed: no --> - - <refentry id="function.get-class-methods"> - <refnamediv> - <refname>get_class_methods</refname> - <refpurpose>Retourne les noms des méthodes d'une classe</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>get_class_methods</methodname> - <methodparam><type>mixed</type><parameter>class_name</parameter></methodparam> - </methodsynopsis> - <para> - <function>get_class_methods</function> retourne un tableau contenant les - noms des méthodes de la classe <parameter>class_name</parameter>. - En cas d'erreur, &null; est retourné. - </para> - <note> - <para> - À partir de &php; 4.0.6, vous pouvez spécifier l'objet lui-même, au lieu - de sa classe <parameter>class_name</parameter>. Par exemple : - <example> - <title> - Passer l'objet ou la classe à <function>get_class_methods</function> - </title> - <programlisting role="php"> -<![CDATA[ -<?php -$class_methods = get_class_methods($my_object); // Voir plus loin l'exemple complet -?> -]]> - </programlisting> - </example> - </para> - </note> - <para> - <example> - <title>Exemple avec <function>get_class_methods</function></title> - <programlisting role="php"> +<refentry id="function.get-class-methods"> + <refnamediv> + <refname>get_class_methods</refname> + <refpurpose>Retourne les noms des méthodes d'une classe</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>get_class_methods</methodname> + <methodparam><type>mixed</type><parameter>class_name</parameter></methodparam> + </methodsynopsis> + <para> + Retourne les noms des méthodes d'une classe. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>class_name</parameter></term> + <listitem> + <para> + Le nom de la classe d'une instance + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau contenant les noms des méthodes de la classe + <parameter>class_name</parameter>. En cas d'erreur, &null; + est retourné. + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.0.0</entry> + <entry> + Depuis &php; 5, cette fonction retourne le nom des méthodes telles + quelles sont déclarées (sensible à la casse). En &php; 4, elles étaient + en minuscules. + </entry> + </row> + <row> + <entry>4.0.6</entry> + <entry> + La possibilité de spécifier l'objet lui-même a été ajoutée. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>get_class_methods</function></title> + <programlisting role="php"> <![CDATA[ <?php -class maclasse { +class myclass { // constructeur - function maclasse() + function myclass() { - return(TRUE); + return(true); } // méthode 1 function myfunc1() { - return(TRUE); + return(true); } // méthode 2 - function mafunc2() + function myfunc2() { - return(TRUE); + return(true); } } -$class_methods = get_class_methods('maclasse'); +$class_methods = get_class_methods('myclass'); // ou -$class_methods = get_class_methods(new maclasse()); +$class_methods = get_class_methods(new myclass()); foreach ($class_methods as $method_name) { echo "$method_name\n"; } + ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ -maclasse +myclass myfunc1 -mafunc2 +myfunc2 ]]> - </screen> - </example> - </para> - <warning> - <para> - Depuis &php; 5, cette fonction retourne le nom des méthodes comme - elles ont été déclarées (sensible à la casse). En &php; 4, elles étaient - converties en minuscule. - </para> - </warning> - <simpara> - Voir aussi - <function>get_class</function>, - <function>get_class_vars</function> et - <function>get_object_vars</function>. - </simpara> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>get_class</function></member> + <member><function>get_class_vars</function></member> + <member><function>get_object_vars</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/get-class-vars.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/classobj/functions/get-class-vars.xml diff -u phpdoc-fr/reference/classobj/functions/get-class-vars.xml:1.11 phpdoc-fr/reference/classobj/functions/get-class-vars.xml:1.12 --- phpdoc-fr/reference/classobj/functions/get-class-vars.xml:1.11 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/get-class-vars.xml Wed Jan 17 20:54:39 2007 @@ -1,49 +1,93 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.9 Maintainer: dams Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.11 Maintainer: dams Status: ready --> <!-- Reviewed: no --> - <refentry id="function.get-class-vars"> - <refnamediv> - <refname>get_class_vars</refname> - <refpurpose> - Retourne les valeurs par défaut des propriétés d'une classe - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>get_class_vars</methodname> - <methodparam><type>string</type><parameter>class_name</parameter></methodparam> - </methodsynopsis> - <para> - <function>get_class_vars</function> retourne un tableau contenant les - valeurs par défaut des propriétés publiques de la classe - <parameter>class_name</parameter>. - </para> - <note> - <para> - Avant &php; 4.2.0, les variables de classe non initialisées n'étaient - pas rapportées par <function>get_class_vars</function>. - </para> - </note> - <para> - <example> - <title>Exemple avec <function>get_class_vars</function></title> - <programlisting role="php"> +<refentry id="function.get-class-vars"> + <refnamediv> + <refname>get_class_vars</refname> + <refpurpose>Retourne les valeurs par défaut des propriétés d'une classe</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>get_class_vars</methodname> + <methodparam><type>string</type><parameter>class_name</parameter></methodparam> + </methodsynopsis> + <para> + Retourne les valeurs par défaut des propriétés d'une classe. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>class_name</parameter></term> + <listitem> + <para> + Le nom de la classe + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + retourne un tableau contenant les valeurs par défaut des + propriétés publiques de la classe <parameter>class_name</parameter>. + Les éléments du tableau résultant sont sous la forme : + <literal>nom_variable => valeur</literal>. + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Avant la version 4.2.0</entry> + <entry> + les variables de classe non initialisées n'étaient pas + rapportées par <function>get_class_vars</function>. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>get_class_vars</function></title> + <programlisting role="php"> <![CDATA[ <?php class myclass { - var $var1; // this has no default value... + var $var1; // pas de valeur par défaut... var $var2 = "xyz"; var $var3 = 100; private $var4; // PHP 5 - + // constructeur function myclass() { - return(TRUE); + // changement de quelques propriétés + $this->var1 = "foo"; + $this->var2 = "bar"; + return true; } } @@ -56,7 +100,7 @@ echo "$name : $value\n"; } -?> +?> ]]> </programlisting> &example.outputs; @@ -70,15 +114,19 @@ var1 : var2 : xyz var3 : 100 -]]> +]]> </screen> </example> </para> - <simpara> - Voir aussi - <function>get_class_methods</function> et - <function>get_object_vars</function>. - </simpara> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>get_class_methods</function></member> + <member><function>get_object_vars</function></member> + </simplelist> + </para> </refsect1> </refentry> @@ -101,4 +149,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/get-class.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/classobj/functions/get-class.xml diff -u phpdoc-fr/reference/classobj/functions/get-class.xml:1.12 phpdoc-fr/reference/classobj/functions/get-class.xml:1.13 --- phpdoc-fr/reference/classobj/functions/get-class.xml:1.12 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/get-class.xml Wed Jan 17 20:54:39 2007 @@ -1,83 +1,130 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.8 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.10 Maintainer: dams Status: ready --> <!-- Reviewed: no --> - <refentry id="function.get-class"> - <refnamediv> - <refname>get_class</refname> - <refpurpose>Retourne la classe d'un objet</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>get_class</methodname> - <methodparam choice="opt"><type>object</type><parameter>obj</parameter></methodparam> - </methodsynopsis> - <para> - <function>get_class</function> retourne la classe de l'objet - <parameter>obj</parameter>. <function>get_class</function> retourne - &false; si <parameter>obj</parameter> n'est pas un objet. - </para> - <note> - <simpara> - <function>get_class</function> retourne un nom de classe utilisateur, - en minuscules. Une classe définie par une extension &php; est retournée - dans sa notation originale. - </simpara> - </note> - <note> - <para> - Depuis &php; 5, <parameter>obj</parameter> est optionnel s'il est appelé - depuis la méthode de l'objet. - </para> - </note> - <para> - <example> - <title>Exemple avec <function>get_class</function></title> - <programlisting role="php"> +<refentry id="function.get-class"> + <refnamediv> + <refname>get_class</refname> + <refpurpose>Retourne la classe d'un objet</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>get_class</methodname> + <methodparam choice="opt"><type>object</type><parameter>object</parameter></methodparam> + </methodsynopsis> + <para> + Retourne la classe de l'objet <parameter>obj</parameter>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>object</parameter></term> + <listitem> + <para> + L'objet testé + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nom de la classe pour laquelle <parameter>object</parameter> + est une instance. Retourne &false; si <parameter>object</parameter> + n'est pas un objet. + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Depuis 5.0.0</entry> + <entry> + Le nom de la classe est retourné dans sa notation originale. + </entry> + </row> + <row> + <entry>Depuis 5.0.0</entry> + <entry> + Le paramètre <parameter>object</parameter> est optionnel + s'il est appelé depuis la méthode de l'objet. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>get_class</function></title> + <programlisting role="php"> <![CDATA[ <?php class foo { - function foo() { + function foo() + { // un peu de code } - function name() { + function name() + { echo "Mon nom est " , get_class($this) , "\n"; } } -// create an object +// création d'un objet $bar = new foo(); -// external call +// Appel externe echo "Son nom est " , get_class($bar) , "\n"; -// internal call +// Appel interne $bar->name(); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Son nom est foo Mon nom est foo ]]> - </screen> - </example> - </para> - <para> - Voir aussi - <function>get_parent_class</function>, - <function>gettype</function> et - <function>is_subclass_of</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>get_parent_class</function></member> + <member><function>gettype</function></member> + <member><function>is_subclass_of</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -98,4 +145,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/get-declared-classes.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/classobj/functions/get-declared-classes.xml diff -u phpdoc-fr/reference/classobj/functions/get-declared-classes.xml:1.11 phpdoc-fr/reference/classobj/functions/get-declared-classes.xml:1.12 --- phpdoc-fr/reference/classobj/functions/get-declared-classes.xml:1.11 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/get-declared-classes.xml Wed Jan 17 20:54:39 2007 @@ -1,53 +1,62 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.8 Maintainer: dams Status: ready --> <!-- Reviewed: no --> - <refentry id="function.get-declared-classes"> - <refnamediv> - <refname>get_declared_classes</refname> - <refpurpose>Liste toutes les classes définies</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>get_declared_classes</methodname> - <void/> - </methodsynopsis> +<refentry id="function.get-declared-classes"> + <refnamediv> + <refname>get_declared_classes</refname> + <refpurpose>Liste toutes les classes définies</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>get_declared_classes</methodname> + <void/> + </methodsynopsis> + <para> + Liste toutes les classes définies. + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau contenant la liste des classes déclarées + dans le script courant. + </para> + <note> <para> - <function>get_declared_classes</function> retourne un tableau contenant - la liste des classes déclarées dans le script courant. + En &php; 4.0.1pl2, trois classes supplémentaires sont retournées, au + début de ce tableau : <classname>stdClass</classname> (définie dans + <filename>Zend/zend.c</filename>), + <classname>OverloadedTestClass</classname> (définie dans + <filename>ext/standard/basic_functions.c</filename>) + et <classname>Directory</classname> + (définie dans <filename>ext/standard/dir.c</filename>). </para> - <note> - <para> - En &php; 4.0.1pl2, trois classes supplémentaires sont retournées, au - début de ce tableau : <classname>stdClass</classname> (définie dans - <filename>Zend/zend.c</filename>), - <classname>OverloadedTestClass</classname> (définie dans - <filename>ext/standard/basic_functions.c</filename>) - et <classname>Directory</classname> - (définie dans <filename>ext/standard/dir.c</filename>). - </para> - <para> - De plus, notez que suivant les bibliothèques qui sont compilées - avec &php;, d'autres classes peuvent être présentes. Cela signifie - que vous ne pourrez pas utiliser ces noms de classe pour définir vos propres - classes. Voici une liste des - <link linkend="reserved.classes">classes pré-définies</link>. - </para> - </note> - <para> - <example> - <title>Exemple avec <function>get_declared_classes</function></title> - <programlisting role="php"> + <para> + De plus, notez que suivant les bibliothèques qui sont compilées + avec &php;, d'autres classes peuvent être présentes. Cela signifie + que vous ne pourrez pas utiliser ces noms de classe pour définir vos propres + classes. Voici une liste des + <link linkend="reserved.classes">classes pré-définies</link>. + </para> + </note> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>get_declared_classes</function></title> + <programlisting role="php"> <![CDATA[ <?php print_r(get_declared_classes()); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs.similar; + <screen> <![CDATA[ Array ( @@ -56,16 +65,20 @@ [2] => Directory ) ]]> - </screen> - </example> - </para> - <simpara> - Voir aussi - <function>class_exists</function> et - <function>get_declared_interfaces</function>. - </simpara> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>class_exists</function></member> + <member><function>get_declared_interfaces</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -86,4 +99,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/get-declared-interfaces.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-fr/reference/classobj/functions/get-declared-interfaces.xml diff -u phpdoc-fr/reference/classobj/functions/get-declared-interfaces.xml:1.7 phpdoc-fr/reference/classobj/functions/get-declared-interfaces.xml:1.8 --- phpdoc-fr/reference/classobj/functions/get-declared-interfaces.xml:1.7 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/get-declared-interfaces.xml Wed Jan 17 20:54:39 2007 @@ -1,37 +1,44 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.4 Maintainer: dams Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.6 Maintainer: dams Status: ready --> <!-- Reviewed: no --> - <refentry id="function.get-declared-interfaces"> - <refnamediv> - <refname>get_declared_interfaces</refname> - <refpurpose> - Retourne un tableau avec toutes les interfaces déclarées - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>get_declared_interfaces</methodname> - <void/> - </methodsynopsis> - <para> - <function>get_declared_interfaces</function> retourne un tableau - avec la liste de toutes les interfaces déclarées dans le script courant. - </para> - <para> - <example> - <title>Exemple avec <function>get_declared_interfaces</function></title> - <programlisting role="php"> +<refentry id="function.get-declared-interfaces"> + <refnamediv> + <refname>get_declared_interfaces</refname> + <refpurpose>Retourne un tableau avec toutes les interfaces déclarées</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>get_declared_interfaces</methodname> + <void/> + </methodsynopsis> + <para> + Retourne un tableau avec toutes les interfaces déclarées. + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau contenant les noms des interfaces déclarées dans + le script courant. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>get_declared_interfaces</function></title> + <programlisting role="php"> <![CDATA[ <?php print_r(get_declared_interfaces()); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs.similar; + <screen> <![CDATA[ Array ( @@ -44,15 +51,19 @@ [6] => SeekableIterator ) ]]> - </screen> - </example> - </para> - <simpara> - Voir aussi - <function>get_declared_classes</function>. - </simpara> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>get_declared_classes</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -73,4 +84,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/get-object-vars.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/classobj/functions/get-object-vars.xml diff -u phpdoc-fr/reference/classobj/functions/get-object-vars.xml:1.12 phpdoc-fr/reference/classobj/functions/get-object-vars.xml:1.13 --- phpdoc-fr/reference/classobj/functions/get-object-vars.xml:1.12 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/get-object-vars.xml Wed Jan 17 20:54:39 2007 @@ -1,63 +1,105 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.8 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.10 Maintainer: dams Status: ready --> <!-- Reviewed: no --> - <refentry id="function.get-object-vars"> - <refnamediv> - <refname>get_object_vars</refname> - <refpurpose> - Retourne un tableau associatif des propriétés d'un objet - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>get_object_vars</methodname> - <methodparam><type>object</type><parameter>obj</parameter></methodparam> - </methodsynopsis> - <para> - <function>get_object_vars</function> retourne un tableau associatif - contenant les propriétés de l'objet <parameter>obj</parameter>. - Les clés du tableau sont les noms des propriétés - de l'objet. - </para> - <note> +<refentry id="function.get-object-vars"> + <refnamediv> + <refname>get_object_vars</refname> + <refpurpose>Retourne un tableau associatif des propriétés d'un objet</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>get_object_vars</methodname> + <methodparam><type>object</type><parameter>object</parameter></methodparam> + </methodsynopsis> + <para> + Récupère les propriétés de l'objet <parameter>object</parameter> fourni. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>object</parameter></term> + <listitem> <para> - Dans les versions antérieures à la &php; 4.2.0, si les variables déclarées - dans la classe de l'objet <parameter>obj</parameter>, n'avaient - pas été assignées, elles n'apparaissaient pas dans le tableau - retourné. Depuis &php; 4.2.0, elles apparaissent, avec la valeur - &null;. + Une instance d'un objet. </para> - </note> - <para> - <example> - <title>Exemple avec <function>get_object_vars</function></title> - <programlisting role="php"> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne un tableau associatif contenant les propriétés + de l'objet <parameter>obj</parameter>. Si une propriété + n'a pas de valeur d'assignée, elle sera retournée avec une + valeur &null;. + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Avant 4.2.0</entry> + <entry> + Si les variables déclarées dans la classe de l'objet + <parameter>obj</parameter>, n'avaient pas + été assignées, elles n'apparaissaient pas dans le tableau + retourné + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>get_object_vars</function></title> + <programlisting role="php"> <![CDATA[ <?php class Point2D { var $x, $y; var $label; - function Point2D($x, $y) { + function Point2D($x, $y) + { $this->x = $x; $this->y = $y; } - function setLabel($label) { + function setLabel($label) + { $this->label = $label; } - function getPoint() { + function getPoint() + { return array("x" => $this->x, "y" => $this->y, "label" => $this->label); } } -// "$label" est déclaré mais non défini +// "$label" est déclaré mais n'est pas défini $p1 = new Point2D(1.233, 3.445); print_r(get_object_vars($p1)); @@ -66,9 +108,9 @@ ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Array ( @@ -84,16 +126,20 @@ [label] => point #1 ) ]]> - </screen> - </example> - </para> - <simpara> - Voir aussi - <function>get_class_methods</function> et - <function>get_class_vars</function>. - </simpara> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>get_class_methods</function></member> + <member><function>get_class_vars</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -114,4 +160,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/get-parent-class.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-fr/reference/classobj/functions/get-parent-class.xml diff -u phpdoc-fr/reference/classobj/functions/get-parent-class.xml:1.13 phpdoc-fr/reference/classobj/functions/get-parent-class.xml:1.14 --- phpdoc-fr/reference/classobj/functions/get-parent-class.xml:1.13 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/get-parent-class.xml Wed Jan 17 20:54:39 2007 @@ -1,58 +1,115 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.8 Maintainer: dams Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.10 Maintainer: dams Status: ready --> <!-- Reviewed: no --> - <refentry id="function.get-parent-class"> - <refnamediv> - <refname>get_parent_class</refname> - <refpurpose>Retourne le nom de la classe d'un objet</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>string</type><methodname>get_parent_class</methodname> - <methodparam choice="opt"><type>mixed</type><parameter>obj</parameter></methodparam> - </methodsynopsis> - <para> - <function>get_parent_class</function> retourne le nom de la classe - de l'objet <parameter>obj</parameter>. - </para> - <para> - Si le paramètre <parameter>obj</parameter> est une chaîne, - <function>get_parent_class</function> retourne le nom de la classe - parente. Cette fonctionnalité a été ajoutée en &php; 4.0.5. - </para> - <note> - <para> - Depuis &php; 5, <parameter>obj</parameter> est optionnel s'il est appelé - depuis la méthode de l'objet. - Si appelée sans paramètre en dehors de l'objet, cette fonction retourne - &false; (ou &null; avec un avertissement avant &php; 5.1.0). - </para> - </note> - <para> - <example> - <title>Exemple avec <function>get_parent_class</function></title> - <programlisting> +<refentry id="function.get-parent-class"> + <refnamediv> + <refname>get_parent_class</refname> + <refpurpose>Retourne le nom de la classe d'un objet</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>get_parent_class</methodname> + <methodparam choice="opt"><type>mixed</type><parameter>object</parameter></methodparam> + </methodsynopsis> + <para> + Récupère le nom de classe parent pour un objet ou une classe. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>object</parameter></term> + <listitem> + <para> + L'objet ou le nom de la classe testé + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne le nom de la classe parent dont + <parameter>object</parameter> est une instance ou le nom. + </para> + <para> + Si appelée sans paramètre en dehors de l'objet, cette fonction retourne + &false;. + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Avant 5.1.0</entry> + <entry> + Si appelée sans paramètre en dehors de l'objet, cette fonction retourne + &null; avec une alerte. + </entry> + </row> + <row> + <entry>Depuis 5.0.0</entry> + <entry> + Le paramètre <parameter>object</parameter> est optionnel si appelé + depuis la méthode de l'objet. + </entry> + </row> + <row> + <entry>Depuis 4.0.5</entry> + <entry> + Si le paramètre <parameter>obj</parameter> est une chaîne, + <function>get_parent_class</function> retourne le nom de la classe + parente. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>get_parent_class</function></title> + <programlisting role="php"> <![CDATA[ <?php -class papa { - function papa() { +class dad { + function dad() + { // un peu de code } } class child extends papa { - function child() { - echo "je suis le fils de " , get_parent_class($this) , "\n"; + function child() + { + echo "je suis le fils de " , get_parent_class($this) , "\n"; } } class child2 extends papa { - function child2() { - echo "Je suis aussi le papa de " , get_parent_class('child2') , "\n"; + function child2() + { + echo "Je suis aussi le papa de " , get_parent_class('child2') , "\n"; } } @@ -61,23 +118,27 @@ ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ je suis le fils de papa Je suis aussi le papa de papa ]]> - </screen> - </example> - </para> - <para> - Voir aussi - <function>get_class</function> et - <function>is_subclass_of</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>get_class</function></member> + <member><function>is_subclass_of</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -98,4 +159,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/interface-exists.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/classobj/functions/interface-exists.xml diff -u phpdoc-fr/reference/classobj/functions/interface-exists.xml:1.3 phpdoc-fr/reference/classobj/functions/interface-exists.xml:1.4 --- phpdoc-fr/reference/classobj/functions/interface-exists.xml:1.3 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/interface-exists.xml Wed Jan 17 20:54:39 2007 @@ -1,34 +1,66 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.interface-exists"> - <refnamediv> - <refname>interface_exists</refname> - <refpurpose>Vérifie si une interface a été définie</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>interface_exists</methodname> - <methodparam><type>string</type><parameter>interface_name</parameter></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>autoload</parameter></methodparam> - </methodsynopsis> - <para> - <methodname>interface_exists</methodname> retourne &true; si - l'interface <parameter>interface_name</parameter> a été définie, - et &false; sinon. - </para> - <para> - <example> - <title>Exemple avec <function>interface_exists</function></title> - <programlisting role="php"> +<refentry id="function.interface-exists"> + <refnamediv> + <refname>interface_exists</refname> + <refpurpose>Vérifie si une interface a été définie</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>interface_exists</methodname> + <methodparam><type>string</type><parameter>interface_name</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>autoload</parameter></methodparam> + </methodsynopsis> + <para> + Vérifie si une interface a été définie. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>interface_name</parameter></term> + <listitem> + <para> + Le nom de l'interface + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>autoload</parameter></term> + <listitem> + <para> + Si l'on doit appeler &link.autoload; ou non par défaut + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne &true; si l'interface fournie par le paramètre + <parameter>interface_name</parameter> a été définie, + &false; sinon. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>interface_exists</function></title> + <programlisting role="php"> <![CDATA[ <?php // Vérifie si l'interface existe avant de l'utiliser -if (interface_exists('MonInterface')) { - class MaClasse implements MonInterface +if (interface_exists('MyInterface')) { + class MyClass implements MyInterface { // Méthodes } @@ -36,21 +68,19 @@ ?> ]]> - </programlisting> - </example> - </para> - <para> - <function>interface_exists</function> essaiera d'appeler &link.autoload; par - défaut. Si vous ne voulez pas que <function>interface_exists</function> appelle - &link.autoload;, vous pouvez donner au paramètre <parameter>autoload</parameter> - la valeur de &false;. - </para> - <simpara> - Voir aussi - <function>class_exists</function>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>class_exists</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -71,4 +101,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/is-a.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/classobj/functions/is-a.xml diff -u phpdoc-fr/reference/classobj/functions/is-a.xml:1.8 phpdoc-fr/reference/classobj/functions/is-a.xml:1.9 --- phpdoc-fr/reference/classobj/functions/is-a.xml:1.8 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/is-a.xml Wed Jan 17 20:54:39 2007 @@ -1,31 +1,67 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.7 Maintainer: dams Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.is-a"> - <refnamediv> - <refname>is_a</refname> - <refpurpose> - Retourne &true; si un objet a pour parent une classe donnée - </refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>is_a</methodname> - <methodparam><type>object</type><parameter>object</parameter></methodparam> - <methodparam><type>string</type><parameter>class_name</parameter></methodparam> - </methodsynopsis> - <para> - <function>is_a</function> retourne &true; si l'objet <parameter>object</parameter> - a pour classe <parameter>class_name</parameter>, ou bien si <parameter>class_name</parameter> - est un de ses parents. <function>is_a</function> retourne &false; sinon. - </para> - <para> - <example> - <title>Exemple avec <function>is_a</function></title> - <programlisting role="php"> +<refentry id="function.is-a"> + <refnamediv> + <refname>is_a</refname> + <refpurpose>Vérifie si l'objet fait parti d'une classe ou a cette classe comme parents</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>is_a</methodname> + <methodparam><type>object</type><parameter>object</parameter></methodparam> + <methodparam><type>string</type><parameter>class_name</parameter></methodparam> + </methodsynopsis> + <para> + Vérifie si l'objet <parameter>object</parameter>fait parti de cette classe ou + a cette classe comme parents. + </para> + <note> + <para> + La fonction <function>is_a</function> est déconseillé en &php; 5 en faveur de + l'opérateur de type <link linkend="language.operators.type">instanceof</link>. + </para> + </note> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>object</parameter></term> + <listitem> + <para> + L'objet testé + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>class_name</parameter></term> + <listitem> + <para> + Le nom de la classe + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne &true; si l'objet fait parti de cette classe ou a cette classe comme parents, + &false; sinon. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>is_a</function></title> + <programlisting role="php"> <![CDATA[ <?php // Définit une classe @@ -42,18 +78,11 @@ } ?> ]]> - </programlisting> - </example> - </para> - <para> - La fonction <function>is_a</function> est déconseillé en &php; 5 en faveur de - l'opérateur de type <link linkend="language.operators.type">instanceof</link>. - Voir un exemple de cette utilisation avec &php; 5 : - </para> - <para> - <example> - <title>Utilisation de l'opérateur <emphasis>instanceof</emphasis> avec &php; 5</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Utilisation de l'opérateur <emphasis>instanceof</emphasis> avec &php; 5</title> + <programlisting role="php"> <![CDATA[ <?php if ($WF instanceof WidgetFactory) { @@ -61,17 +90,21 @@ } ?> ]]> - </programlisting> - </example> - </para> - <simpara> - Voir aussi - <function>get_class</function>, - <function>get_parent_class</function> et - <function>is_subclass_of</function>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>get_class</function></member> + <member><function>get_parent_class</function></member> + <member><function>is_subclass_of</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -92,4 +125,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/is-subclass-of.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/classobj/functions/is-subclass-of.xml diff -u phpdoc-fr/reference/classobj/functions/is-subclass-of.xml:1.12 phpdoc-fr/reference/classobj/functions/is-subclass-of.xml:1.13 --- phpdoc-fr/reference/classobj/functions/is-subclass-of.xml:1.12 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/is-subclass-of.xml Wed Jan 17 20:54:39 2007 @@ -1,50 +1,101 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.5 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.is-subclass-of"> - <refnamediv> - <refname>is_subclass_of</refname> - <refpurpose>Détermine si un objet est une sous-classe</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>is_subclass_of</methodname> - <methodparam><type>mixed</type><parameter>object</parameter></methodparam> - <methodparam><type>string</type><parameter>class_name</parameter></methodparam> - </methodsynopsis> - <para> - <function>is_subclass_of</function> retourne &true; si l'objet - <parameter>object</parameter> est une sous-classe de - <parameter>class_name</parameter>, &false; sinon. - </para> - <note> - <para> - Depuis &php; 5.0.3, vous devez également spécifier le paramètre - <parameter>object</parameter> en tant que chaîne de caractères (le nom de la classe). - </para> - </note> - <para> - <example> - <title>Exemple avec <function>is_subclass_of</function></title> - <programlisting role="php"> +<refentry id="function.is-subclass-of"> + <refnamediv> + <refname>is_subclass_of</refname> + <refpurpose>Détermine si un objet est une sous-classe</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>is_subclass_of</methodname> + <methodparam><type>mixed</type><parameter>object</parameter></methodparam> + <methodparam><type>string</type><parameter>class_name</parameter></methodparam> + </methodsynopsis> + <para> + Vérifie si l'objet <parameter>object</parameter> a la classe + <parameter>class_name</parameter> comme parents. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>object</parameter></term> + <listitem> + <para> + Un nom de classe ou une instance d'un objet + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>class_name</parameter></term> + <listitem> + <para> + Le nom de la classe + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Cette fonction retourne &true; si l'objet <parameter>object</parameter>, + appartient à une classe qui est une sous-classe de + <parameter>class_name</parameter>, &false; sinon. + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.0.3</entry> + <entry> + vous devez également spécifier le paramètre <parameter>object</parameter> + en tant que chaîne de caractères (le nom de la classe). + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>is_subclass_of</function></title> + <programlisting role="php"> <![CDATA[ <?php -// définition d'une classe +// Définit une classe class WidgetFactory { var $oink = 'moo'; } -// définition d'une sous-classe +// Définit une sous-classe class WidgetFactory_Child extends WidgetFactory { var $oink = 'oink'; } -// création d'un nouvel objet +// Création d'un nouvel objet $WF = new WidgetFactory(); $WFC = new WidgetFactory_Child(); @@ -54,12 +105,14 @@ echo "non, \$WFC n'est pas une sous-classe de la classe WidgetFactory\n"; } + if (is_subclass_of($WF, 'WidgetFactory')) { echo "oui, \$WF est une sous-classe de la classe WidgetFactory\n"; } else { echo "non, \$WF n'est pas une sous-classe de la classe WidgetFactory\n"; } + // utilisable uniquement depuis PHP 5.0.3 if (is_subclass_of('WidgetFactory_Child', 'WidgetFactory')) { echo "oui, WidgetFactory_Child est une sous-classe de la classe WidgetFactory\n"; @@ -68,24 +121,29 @@ } ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ oui, $WFC est une sous-classe de la classe WidgetFactory non, $WF n'est pas une sous-classe de la classe WidgetFactory oui, WidgetFactory_Child est une sous-classe de la classe WidgetFactory ]]> - </screen> - </example> - </para> - <simpara> - Voir aussi - <function>get_class</function> et - <function>get_parent_class</function>. - </simpara> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>get_class</function></member> + <member><function>get_parent_class</function></member> + <member><function>is_a</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -106,4 +164,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/method-exists.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc-fr/reference/classobj/functions/method-exists.xml diff -u phpdoc-fr/reference/classobj/functions/method-exists.xml:1.12 phpdoc-fr/reference/classobj/functions/method-exists.xml:1.13 --- phpdoc-fr/reference/classobj/functions/method-exists.xml:1.12 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/method-exists.xml Wed Jan 17 20:54:39 2007 @@ -1,52 +1,88 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.5 Maintainer: dams Status: ready --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.method-exists"> - <refnamediv> - <refname>method_exists</refname> - <refpurpose>Vérifie que la méthode existe pour une classe</refpurpose> - </refnamediv> - <refsect1> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>method_exists</methodname> - <methodparam><type>object</type><parameter>object</parameter></methodparam> - <methodparam><type>string</type><parameter>method_name</parameter></methodparam> - </methodsynopsis> - <para> - <function>method_exists</function> retourne &true; - si la méthode <parameter>method_name</parameter> a - été définie pour la classe - <parameter>object</parameter>, et sinon, retourne &false;. - </para> - <para> - <example> - <title>Exemple avec <function>method_exists</function></title> - <programlisting role="php"> +<refentry id="function.method-exists"> + <refnamediv> + <refname>method_exists</refname> + <refpurpose>Vérifie que la méthode existe pour une classe</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>method_exists</methodname> + <methodparam><type>object</type><parameter>object</parameter></methodparam> + <methodparam><type>string</type><parameter>method_name</parameter></methodparam> + </methodsynopsis> + <para> + Vérifie si la méthode existe pour l'objet + <parameter>object</parameter> fourni. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>object</parameter></term> + <listitem> + <para> + Une instance d'un objet + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>method_name</parameter></term> + <listitem> + <para> + Le nom de la méthode + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Retourne &true; si la méthode fournie par le paramètre + <parameter>method_name</parameter> a été définie pour l'objet + <parameter>object</parameter>, &false; sinon. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>method_exists</function></title> + <programlisting role="php"> <![CDATA[ <?php $directory = new Directory('.'); var_dump(method_exists($directory,'read')); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ bool(true) ]]> - </screen> - </example> - </para> - <para> - Voir aussi - <function>function_exists</function> et - <function>is_callable</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>function_exists</function></member> + <member><function>is_callable</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/classobj/functions/property-exists.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-fr/reference/classobj/functions/property-exists.xml diff -u phpdoc-fr/reference/classobj/functions/property-exists.xml:1.4 phpdoc-fr/reference/classobj/functions/property-exists.xml:1.5 --- phpdoc-fr/reference/classobj/functions/property-exists.xml:1.4 Sun Aug 27 20:36:13 2006 +++ phpdoc-fr/reference/classobj/functions/property-exists.xml Wed Jan 17 20:54:39 2007 @@ -1,9 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: no --> - <refentry id="function.property-exists"> <refnamediv> <refname>property_exists</refname> @@ -26,12 +25,11 @@ <note> <para> À l'opposé de la fonction <function>isset</function>, - <function>property_exists</function> retourne &true; + <function>property_exists</function> retourne &true; même si la propriété a une valeur &null;. </para> </note> </refsect1> - <refsect1 role="parameters"> &reftitle.parameters; <para> @@ -40,7 +38,7 @@ <term><parameter>class</parameter></term> <listitem> <para> - Une chaîne contenant le nom de la classe ou un objet de la classe à tester + Le nom de la classe ou un objet de la classe à tester </para> </listitem> </varlistentry> @@ -55,15 +53,13 @@ </variablelist> </para> </refsect1> - <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Retourne &true; si la propriété existe, &false; si elle n'existe pas ou &null; + Retourne &true; si la propriété existe, &false; si elle n'existe pas et &null; si une erreur survient. </para> </refsect1> - <refsect1 role="examples"> &reftitle.examples; <para> @@ -84,7 +80,7 @@ var_dump(property_exists('myClass', 'mine')); //true var_dump(property_exists(new myClass, 'mine')); //true -var_dump(property_exists('myClass', 'xpto')); //false, n'est pas publique +var_dump(property_exists('myClass', 'xpto')); //false, non publique myClass::test(); ?> @@ -93,7 +89,6 @@ </example> </para> </refsect1> - <refsect1 role="seealso"> &reftitle.seealso; <para> @@ -123,4 +118,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file