<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.32 Maintainer: darvin  Status: ready -->
 <reference id="ref.classobj">
  <title>Funzioni per Classi/Oggetti </title>
  <titleabbrev>Classi/Oggetti</titleabbrev>

  <partintro>
   <sect1 id="classobj.partintro">
    <title>Introduzione</title>
    <sect2 id="classobj.intro">
    <title>Obiettivo</title>
     <para>
      Queste funzioni permettono di ottenere informazioni sulle classi 
      e sulle istanze degli oggetti. Si pu ricavare il nome della
      classe da cui deriva un dato oggetto, come le sue propriet e i 
      suoi metodi. Utilizzando queste funzioni si ottiene, non solo a 
      quale classe appartiene un dato oggetto, ma anche i suoi "padri"
      (ad esempio da quale classe  derivata la classe dell'oggetto).
     </para>
    </sect2>
    <sect2 id="classobj.example">
     <title>Esempio di utilizzo</title>
     <para>
      In questo esempio, prima si definisce una classe base, quindi una 
      seconda che deriva dalla prima. La classe base descrive gli aspetti
      generali degli ortaggi, se  commestibile e quale sia il colore. La
      classe derivata <varname>Spinaci</varname> aggiunge i metodi di 
      cottura e di verifica della completa cottura.
     </para>
     <para>
      <example>
       <title>classi.inc</title>
       <programlisting role="php">
<![CDATA[
<?php

// classe base con propriet e metodi
class Ortaggio {

    var $commestibile;
    var $colore;

    function Ortaggio( $commestibile, $colore="verde" ) {
        $this->commestibile = $commestibile;
        $this->colore = $colore;
    }

    function e_commestibile() {
        return $this->commestibile;
    }

    function che_colore_ha() {
        return $this->colore;
    }
    
} // Fine della classe ortaggio


// Estensione della classe base
class Spinaci extends Ortaggio {

    var $cotto = false;

    function Spinaci() {
        $this->Ortaggio( true, "verde" );
    }

    function cuocilo() {
        $this->cotto = true;
    }

    function e_cotto() {
        return $this->cotto;
    }
    
} // Fine della classe spinaci

?>
]]>
       </programlisting>
      </example>
     </para>
     <para>
     A questo punto si istanziano 2 oggetti a partire da queste classi
     e si visualizzeranno le informazioni relative a questi oggetti, compresi
     i loro padri. Verranno anche inserite funzioni di utilit
     principalmente con lo scopo di rendere chiara la visualizzazione delle
     variabili.
     </para>
     <para>
      <example>
       <title>test_script.php</title>
       <programlisting role="php">
<![CDATA[
<pre>
<?php

include "classi.inc";

// Funzioni di utilit

function visualizza_var($oggetto) {
    $matrice = get_object_vars($oggetto);
    while (list($prop, $val) = each($matrice))
        echo "\t$prop = $val\n";
}

function visualiazza_metodi($oggetto) {
    $matrice = get_class_methods(get_class($oggetto));
    foreach ($matrice as $metodo)
        echo "\tfunzione $metodo()\n";
}

function padri_classe($oggetto, $classe) {
    global $$oggetto;
    if (is_subclass_of($$oggetto, $classe)) {
        echo "Oggetto $oggetto appartiene alla classe ".get_class($$oggetto);
        echo " derivata da $classe\n";
    } else {
        echo "Oggetto $oggetto non deriva da una sottoclasse di $classe\n";
    }
}

// Istanzia 2 oggetti

$pomodoro = new Ortaggio(true,"rosso");
$frondoso = new Spinaci();

// Visualizza le informazioni sugli oggetti
echo "pomodoro: CLASSE ".get_class($pomodoro)."\n";
echo "frondoso: CLASSE ".get_class($frondoso);
echo ", PADRE ".get_parent_class($frondoso)."\n";

// visualizza le propriet di pomodoro
echo "\npomodoro: Propriet\n";
visualizza_var($pomodoro);

// e i metodi di frondoso
echo "\nfrondoso: Metodi\n";
visualizza_metodi($frondoso);

echo "\nPadri:\n";
padri_classe("frondoso", "Spinaci");
padri_classe("frondoso", "Ortaggio");
?>
</pre>
]]>
       </programlisting>
      </example>
     </para>
     <para>
      Un aspetto da notare nell'esempio precedente  che l'oggetto
      <varname>$frondoso</varname>  un'istanza della classe <classname>
      Spinaci</classname> che a sua volta  una sottoclasse di
      <classname>Ortaggio</classname>, quindi l'ultima parte dell'esempio
      visualizzer:
     </para>
     <para>
      <informalexample>
       <programlisting>
<![CDATA[
       [...]
Padri:
Oggetto frondoso non deriva da una sottoclasse di Spinaci
Oggetto frondoso appartiene alla classe spinaci derivata da Ortaggio
]]>
       </programlisting>
      </informalexample>
     </para>
    </sect2>
   </sect1>
  </partintro>
   
  <refentry id="function.call-user-method-array">
   <refnamediv>
    <refname>call_user_method_array</refname>
    <refpurpose>
     Richiama il metodo dato con un array di parametri
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>misto</type><methodname>call_user_method_array</methodname>
      <methodparam><type>stringa</type><parameter>nome_metodo</parameter></methodparam>
      <methodparam><type>oggetto</type><parameter>oggetto</parameter></methodparam>
      <methodparam choice="opt"><type>array</type><parameter>array_parametri</parameter></methodparam>
     </methodsynopsis>
    <para>
     Richiama il metodo indicato da <parameter>nome_metodo</parameter> 
     dell'oggetto <parameter>oggetto</parameter>, utilizzando i parametri 
     forniti in <parameter>array_parametri</parameter>.
    </para>
    <para>
     Vedere anche:
     <function>call_user_func_array</function>,
     <function>call_user_func</function>,
     <function>call_user_method</function>.
    </para>
    <note>
     <para>
      Questa funzione  stata aggiunta al codice CVS dopo la release 4.0.4pl1 di PHP
     </para>
    </note>
   </refsect1>
  </refentry>
 
  <refentry id="function.call-user-method">
   <refnamediv>
    <refname>call_user_method</refname>
    <refpurpose>
     Chiama un metodo dell'oggetto indicato
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>misto</type><methodname>call_user_method</methodname>
      <methodparam><type>stringa</type><parameter>nome_metodo</parameter></methodparam>
      <methodparam><type>oggetto</type><parameter>oggetto</parameter></methodparam>
      <methodparam choice="opt"><type>misto</type><parameter>parametro</parameter></methodparam>
      <methodparam choice="opt"><type>misto</type><parameter>...</parameter></methodparam>
     </methodsynopsis>
    <para>
     Richiama il metodo indicato da <parameter>nome_metodo</parameter> 
     dell'oggetto <parameter>oggetto</parameter>. Di seguito si fornisce
     un esempio di utilizzo. Qui si definisce una classe, si istanzia un 
     oggetto, e si utilizza <function>call_user_method</function> per 
     richiamare il metodo <varname>stampa_info</varname>
     <informalexample>
      <programlisting role="php">
<![CDATA[
<?php
class Stato {
    var $NOME;
    var $TLD;
    
    function Stato($nome, $tld) {
        $this->NOME = $nome;
        $this->TLD = $tld;
    }

    function stampa_info($prestr="") {
        echo $prestr."Stato: ".$this->NOME."\n";
        echo $prestr."Dominio di primo livello: ".$this->TLD."\n";
    }
}

$paese = new Stato("Peru","pe");

echo "* Richiamo il metodo direttamente\n";
$paese->stampa_info();

echo "\n* utilizzo dello stesso metodo in modo indiretto\n";
call_user_method("stampa_info", $paese, "\t");
?>
]]>
      </programlisting>
     </informalexample>
    </para>
    <simpara>
     Vedere anche <function>call_user_func_array</function>,
     <function>call_user_func</function>,
     <function>call_user_method_array</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.class-exists">
   <refnamediv>
    <refname>class_exists</refname>
    <refpurpose>Verifica se una classe  stata definita</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>bool</type><methodname>class_exists</methodname>
      <methodparam><type>stringa</type><parameter>nome_classe</parameter></methodparam>
     </methodsynopsis>
    <para>
     Questa classe restituisce &true; se la classe indicata dal
     parametro <parameter>nome_classe</parameter>  stata 
     definita, altrimenti restituisce &false; .
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.get-class">
   <refnamediv>
    <refname>get_class</refname>
    <refpurpose>Restituisce il nome della classe di un oggetto</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>stringa</type><methodname>get_class</methodname>
      <methodparam><type>oggetto</type><parameter>oggetto</parameter></methodparam>
     </methodsynopsis>
    <para>
     Questa funzione restituisce il nome della classe di cui
     l'oggetto <parameter>oggetto</parameter>  un'istanza.
     Restituisce &false; se <parameter>oggetto</parameter> non 
     un oggetto.
    </para>
    <note>
     <simpara>
      <function>get_class</function> restituisce il nome delle classi
      definite dagli utenti in minuscolo. Viceversa le classi definite
      nelle estensioni di PHP sono restituite nella notazione originale.
     </simpara>
    </note>
    <simpara>
     Vedere anche <function>get_parent_class</function>,
     <function>get_type</function>, e 
     <function>is_subclass_of</function>
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.get-class-methods">
   <refnamediv>
    <refname>get_class_methods</refname>
    <refpurpose>Restituisce un array con i nomi dei metodi della classe</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>array</type><methodname>get_class_methods</methodname>
      <methodparam><type>stringa</type><parameter>nome_classe</parameter></methodparam>
     </methodsynopsis>
    <para>
     Questa funzione restituisce un array contenente i nomi dei metodi
     definiti per la classe specificata da <parameter>nome_classe</parameter>.
    </para>
    <note>
     <para>
      Dalla versione 4.0.6 di PHP, si pu specificare direttamente
      l'oggetto anzich la classe nel parametro <parameter>nome_classe
      </parameter>. Ad esempio:
      <informalexample>
       <programlisting>
<![CDATA[
$metodi_della_classe = get_class_methods($mia_classe);
]]>
       </programlisting>
      </informalexample>
     </para>
    </note>
    <para>
     <example>
      <title>Esempio di <function>get_class_methods</function></title> 
      <programlisting role="php">
<![CDATA[
<?php

class miaclasse {
    // costruttore
    function miaclasse() {
        return(true);
    }
    
    // metodo 1
    function funzione1() {
        return(true);
    }

    // metodo 2
    function funzione2() {
        return(true);
    }
}

$mia_classe = new miaclasse();

$metodi = get_class_methods(get_class($mia_classe));

foreach ($metodi as $nome_metodo) {
    echo "$nome_metodo\n";
}

?>      
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Produrr:
     <informalexample>
      <programlisting>
<![CDATA[
miaclasse
funzione1
funzione2
]]>
      </programlisting>
     </informalexample>
    </para>
    <simpara>
     Vedere anche <function>get_class_vars</function>,
     <function>get_object_vars</function>
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.get-class-vars">
   <refnamediv>
    <refname>get_class_vars</refname>
    <refpurpose>
     Restituisce un array con le propriet di default della classe
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>array</type><methodname>get_class_vars</methodname>
      <methodparam><type>stringa</type><parameter>nome_classe</parameter></methodparam>
     </methodsynopsis>
    <para>
     Questa funzione restituisce un array associativo contenente
     le propriet di default della classe. Gli elementi dell'array
     prodotto sono nel formato <parameter>nomevariabile => valore</parameter>.
    </para>
    <note>
     <para>
      Le variabili della classe non inizializzate non sono 
      elencate da <function>get_class_vars</function>. 
     </para>
    </note>
    <para>
     <example>
      <title><function>get_class_vars</function> esempio</title>
      <programlisting role="php">
<![CDATA[
<?php

class miaclasse {

    var $var1; // questa variabile non ha un valore di default...
    var $var2 = "xyz";
    var $var3 = 100;
    
    // costruttore
    function miaclasse() {
        return(true);
    }

}

$mia_classe = new miaclasse();

$variabili = get_class_vars(get_class($mia_classe));

foreach ($variabili as $nome => $valore) {
    echo "$nome : $valore\n";
}

?>      
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Produrr:
     <informalexample>
      <programlisting>
<![CDATA[
var2 : xyz
var3 : 100
]]>
      </programlisting>
     </informalexample>
    </para>
    <simpara>
     Vedere anche <function>get_class_methods</function>,
     <function>get_object_vars</function>
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.get-declared-classes">
   <refnamediv>
    <refname>get_declared_classes</refname>
    <refpurpose>Restituisce un array con il nome delle classi definite</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>array</type><methodname>get_declared_classes</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Questa funzione restituisce un array con i nomi delle classi definite
     all'interno dello script corrente.
    </para>
    <note>
     <para>
      Nella versione 4.0.1pl2 di PHP, in testa all'array erano indicate
      tre ulteriori classi:
      <classname>stdClass</classname> (definita in 
      <filename>Zend/zend.c</filename>),
      <classname>OverloadedTestClass</classname> (definita in
      <filename>ext/standard/basic_functions.c</filename>) 
      e <classname>Directory</classname>
      (definita in <filename>ext/standard/dir.c</filename>).
     </para>
     <para>
      Occorre notare che, in base a quali librerie sono state compilate
      in PHP, possono essere rilevate ulteriori classi
     </para>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.get-object-vars">
   <refnamediv>
    <refname>get_object_vars</refname>
    <refpurpose>Restituisce un array associativo con le propriet dell'oggetto</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>array</type><methodname>get_object_vars</methodname>
      <methodparam><type>oggetto</type><parameter>oggetto</parameter></methodparam>
     </methodsynopsis>
    <para>
     Questa funzione restituisce un array associativo con le propriet
     definite nell'oggetto passato nel parametro <parameter>oggetto
     </parameter>. Le variabili, dichiarate nella classe di cui 
     <parameter>oggetto</parameter>  un'istanza, a cui non sia stato 
     ancora assegnato un valore, non saranno restituite nell'array.
     <example>
      <title>Utilizzo di <function>get_object_vars</function></title>
      <programlisting role="php">
<![CDATA[
<?php
class Point2D {
    var $x, $y;
    var $etichetta;

    function Point2D($x, $y) {
        $this->x = $x;
        $this->y = $y;
    }

    function setetichetta($etichetta) {
        $this->etichetta = $etichetta;
    }

    function getPoint() {
        return array("x" => $this->x,
                     "y" => $this->y,
                     "etichetta" => $this->etichetta);
    }
}

$p1 = new Point2D(1.233, 3.445);
print_r(get_object_vars($p1));
// "$etichetta"  dichiarata ma non definita
// Array
// (
//     [x] => 1.233
//     [y] => 3.445
// )

$p1->setetichetta("point #1");
print_r(get_object_vars($p1));
// Array
// (
//     [x] => 1.233
//     [y] => 3.445
//     [etichetta] => point #1
// )

?>
]]>
      </programlisting>
     </example>
    </para>
    <simpara>
     Vedere anche <function>get_class_methods</function>,
     <function>get_class_vars</function>
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.get-parent-class">
   <refnamediv>
    <refname>get_parent_class</refname>
    <refpurpose>Restituisce il nome della classe genitrice di un oggetto 
    o di una classe</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>stringa</type><methodname>get_parent_class</methodname>
      <methodparam><type>misto</type><parameter>oggetto</parameter></methodparam>
     </methodsynopsis>
    <para>
     Se <parameter>oggetto</parameter>  un oggetto, la funzione 
     restituisce il nome del genitore della classe di cui 
     <parameter>oggetto</parameter>  un'istanza.
    </para>
    <para>
     Se <parameter>oggetto</parameter>  una stringa, la funzione 
     restituisce il nome della classe genitrice della classe di 
     cui <parameter>oggetto</parameter> indica il nome. Questa 
     funzionalit  stata aggiunta nella versione 4.0.5 di PHP.
    </para>
    <simpara>
     Vedere anche <function>get_class</function>,
     <function>is_subclass_of</function>
    </simpara>
   </refsect1>
  </refentry>

 <refentry id="function.is-subclass-of">
   <refnamediv>
    <refname>is_subclass_of</refname>
    <refpurpose>
     Determina se un oggetto appartiene ad una
     sottoclasse della classe specificata
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_subclass_of</methodname>
      <methodparam><type>oggetto</type><parameter>oggetto</parameter></methodparam>
      <methodparam><type>stringa</type><parameter>superclasse</parameter></methodparam>
     </methodsynopsis>
    <para>
     Questa funzione restituisce &true; se <parameter>obj</parameter>,
     appartiene ad una sottoclasse di <parameter>superclasse</parameter>,
     altrimenti &false;.
    </para>
    <simpara>
     Vedere anche <function>get_class</function>,
     <function>get_parent_class</function>
    </simpara>
   </refsect1>
  </refentry>
  <refentry id="function.method-exists">
   <refnamediv>
    <refname>method_exists</refname>
    <refpurpose>Verifica se il metodo esiste nella classe</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>bool</type><methodname>method_exists</methodname>
      <methodparam><type>oggetto</type><parameter>object</parameter></methodparam>
      <methodparam><type>stringa</type><parameter>nome_metodo</parameter></methodparam>
     </methodsynopsis>
    <para>
     Questa funzione restituisce &true; se il metodo indicato
     dal parametro <parameter>nome_metodo</parameter>  stato
     nell'oggetto indicato da <parameter>oggetto</parameter>,
     altrimenti &false;.
    </para>
   </refsect1>
  </refentry>

 </reference>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->