darvina Tue Apr 23 15:24:17 2002 EDT
Added files:
/phpdoc/it/reference/xml/functions utf8-decode.xml utf8-encode.xml
xml-error-string.xml
xml-get-current-byte-index.xml
xml-get-current-column-number.xml
xml-get-current-line-number.xml
xml-get-error-code.xml
xml-parse-into-struct.xml
xml-parse.xml
xml-parser-create-ns.xml
xml-parser-create.xml
xml-parser-free.xml
xml-parser-get-option.xml
xml-parser-set-option.xml
xml-set-character-data-handler.xml
xml-set-default-handler.xml
xml-set-element-handler.xml
xml-set-end-namespace-decl-handler.xml
xml-set-external-entity-ref-handler.xml
xml-set-notation-decl-handler.xml
xml-set-object.xml
xml-set-processing-instruction-handler.xml
xml-set-start-namespace-decl-handler.xml
xml-set-unparsed-entity-decl-handler.xml
Log:
Italian translation
Index: phpdoc/it/reference/xml/functions/utf8-decode.xml
+++ phpdoc/it/reference/xml/functions/utf8-decode.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.2 -->
<refentry id="function.utf8-decode">
<refnamediv>
<refname>utf8_decode</refname>
<refpurpose>
Converte una stringa con caratteri ISO-8859-1 codificati con UTF-8
in formato ISO-8859-1 singolo byte.
</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>string</type><methodname>utf8_decode</methodname>
<methodparam><type>string</type><parameter>data</parameter></methodparam>
</methodsynopsis>
<para>
Questa funzione decodifica il parametro <parameter>data</parameter>, considerato
codificato in <literal>UTF-8</literal>, alla codifica
<literal>ISO-8859-1</literal>.
</para>
<para>
Vedere anche <function>utf8_encode</function> per dettagli sulla codifica
UTF-8.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/utf8-encode.xml
+++ phpdoc/it/reference/xml/functions/utf8-encode.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.2 -->
<refentry id="function.utf8-encode">
<refnamediv>
<refname>utf8_encode</refname>
<refpurpose>Codifica una stringa da ISO-8859-1 a UTF-8</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>string</type><methodname>utf8_encode</methodname>
<methodparam><type>string</type><parameter>data</parameter></methodparam>
</methodsynopsis>
<para>
Questa funzione converte la stringa <parameter>data</parameter> al formato
<literal>UTF-8</literal>, e restituisce la nuova versione.
<literal>UTF-8</literal> � il meccanismo standard utilizzato da
<acronym>Unicode</acronym> per la codifica dei valori <glossterm>wide
character</glossterm> in un flusso di byte.
La codifica <literal>UTF-8</literal> � trasparente ai caratteri
<abbrev>ASCII</abbrev>,
� auto-sincronizzata (per un programma � possibile determinare dove iniziano
i caratteri in un flusso di dati) e pu� essere usata nelle normali funzioni
di confronto di stringhe per i sort e simili. Il PHP codifica i caratteri
<literal>UTF-8</literal> fino a quattro byte come segue:
<table>
<title>Codifica UTF-8</title>
<tgroup cols="3">
<thead>
<row>
<entry>bytes</entry>
<entry>bits</entry>
<entry>rappresentazione</entry>
</row>
</thead>
<tbody>
<row>
<entry>1</entry>
<entry>7</entry>
<entry>0bbbbbbb</entry>
</row>
<row>
<entry>2</entry>
<entry>11</entry>
<entry>110bbbbb 10bbbbbb</entry>
</row>
<row>
<entry>3</entry>
<entry>16</entry>
<entry>1110bbbb 10bbbbbb 10bbbbbb</entry>
</row>
<row>
<entry>4</entry>
<entry>21</entry>
<entry>11110bbb 10bbbbbb 10bbbbbb 10bbbbbb</entry>
</row>
</tbody>
</tgroup>
</table>
Ciascuna <replaceable>b</replaceable> rappresenta un bit che pu� essere utilizzato
per registrare le informazioni del carattere.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/xml-error-string.xml
+++ phpdoc/it/reference/xml/functions/xml-error-string.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.2 -->
<refentry id="function.xml-error-string">
<refnamediv>
<refname>xml_error_string</refname>
<refpurpose>restituisce la stringa di errore dal parser XML</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>string</type><methodname>xml_error_string</methodname>
<methodparam><type>int</type><parameter>codice_errore</parameter></methodparam>
</methodsynopsis>
<para>
<variablelist>
<varlistentry>
<term><parameter>codice_errore</parameter></term>
<listitem>
<simpara>
Un codice di errore da <function>xml_get_error_code</function>.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
La funzione restituisce una stringa con la descrizione del codice di errore
<parameter>codice_errore</parameter>, oppure &false; se non si trova una
descrizione.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/xml-get-current-byte-index.xml
+++ phpdoc/it/reference/xml/functions/xml-get-current-byte-index.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.2 -->
<refentry id="function.xml-get-current-byte-index">
<refnamediv>
<refname>xml_get_current_byte_index</refname>
<refpurpose>Restituisce il corrente indice di posizione per un parser
XML</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>int</type><methodname>xml_get_current_byte_index</methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
</methodsynopsis>
<para>
<variablelist>
<varlistentry>
<term><parameter>parser</parameter></term>
<listitem>
<simpara>
Il riferimento al parser XML da cui si vuole ottenere la posizione.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
Questa funzione restituisce &false; se <parameter>parser</parameter> non
si riferisce ad un parser valido, altrimenti la funzione restituisce in quale byte
si trova attualmente il parser nel buffer dei dati (partendo da 0).
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/xml-get-current-column-number.xml
+++ phpdoc/it/reference/xml/functions/xml-get-current-column-number.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.2 -->
<refentry id="function.xml-get-current-column-number">
<refnamediv>
<refname>xml_get_current_column_number</refname>
<refpurpose>
Restituisce il numero di colonna corrente di un parser XML
</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>int</type><methodname>xml_get_current_column_number</methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
</methodsynopsis>
<para>
<variablelist>
<varlistentry>
<term><parameter>parser</parameter></term>
<listitem>
<simpara>
Il riferimento al parser XML da cui ottenere il numero di colonna.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
Questa funzione restituisce &false; se <parameter>parser</parameter> non
si riferisce ad un parser valido, altrimenti restituisce in quale colonna
sulla linea corrente (come indicato da
<function>xml_get_current_line_number</function>) si trova
il parser.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/xml-get-current-line-number.xml
+++ phpdoc/it/reference/xml/functions/xml-get-current-line-number.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.2 -->
<refentry id="function.xml-get-current-line-number">
<refnamediv>
<refname>xml_get_current_line_number</refname>
<refpurpose>Restituisce il numero di linea corrente da un parser XML</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>int</type><methodname>xml_get_current_line_number</methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
</methodsynopsis>
<para>
<variablelist>
<varlistentry>
<term><parameter>parser</parameter></term>
<listitem>
<simpara>
Il riferimento al parser XML da cui si vuole ottenere il numero di linea.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
Questa funzione restituisce &false; se <parameter>parser</parameter> non
si riferisce ad un parser valido, altrimenti la funzione restituisce in quale
linea del buffer dati si trova attualmente il parser.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/xml-get-error-code.xml
+++ phpdoc/it/reference/xml/functions/xml-get-error-code.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.2 -->
<refentry id="function.xml-get-error-code">
<refnamediv>
<refname>xml_get_error_code</refname>
<refpurpose>Restituisce il codice di errore dal parser XML</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>int</type><methodname>xml_get_error_code</methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
</methodsynopsis>
<para>
<variablelist>
<varlistentry>
<term><parameter>parser</parameter></term>
<listitem>
<simpara>
Il riferimento al parser XML da cui si vuole ottenere il codice di errore.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
Questa funzione restituisce &false; se <parameter>parser</parameter> non
si riferisce ad un parser valido, altrimenti la funzione restituisce uno
dei codici di errore elencati in <link linkend="xml.error-codes">codici
di errore</link>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/xml-parse-into-struct.xml
+++ phpdoc/it/reference/xml/functions/xml-parse-into-struct.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.11 -->
<refentry id="function.xml-parse-into-struct">
<refnamediv>
<refname>xml_parse_into_struct</refname>
<refpurpose>Analisi di dati XML in una struttura a matrice</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>int</type><methodname>xml_parse_into_struct</methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
<methodparam><type>string</type><parameter>data</parameter></methodparam>
<methodparam><type>array</type><parameter>&valori</parameter></methodparam>
<methodparam><type>array</type><parameter>&indice</parameter></methodparam>
</methodsynopsis>
<para>
Questa funzione registra un file XML in 2 strutture a
matrice, una (<parameter>indice</parameter>) contiene i puntatori
alla posizione dei valori nella matrice
<parameter>valori</parameter>. Questi due parametri devono essere
passati per riferimento.
</para>
<para>
Nell'esempio seguente si illustra la struttura interna delle matrici
generata dalla funzione. Qui si user� una semplice struttura con il
tag <literal>note</literal> inserito all'interno del tag
<literal>para</literal>, e quindi si analizzer� questo visualizzando
la struttura ottenuta:
<informalexample>
<programlisting role="php">
<![CDATA[
$simple = "<para><note>simple note</note></para>";
$p = xml_parser_create();
xml_parse_into_struct($p,$simple,$vals,$index);
xml_parser_free($p);
echo "Array indice\n";
print_r($index);
echo "\narray dei valori\n";
print_r($vals);
]]>
</programlisting>
</informalexample>
Eseguendo questo codice si otterr�:
<informalexample>
<screen>
<![CDATA[
Array indice
Array
(
[PARA] => Array
(
[0] => 0
[1] => 2
)
[NOTE] => Array
(
[0] => 1
)
)
Array dei valori
Array
(
[0] => Array
(
[tag] => PARA
[type] => open
[level] => 1
)
[1] => Array
(
[tag] => NOTE
[type] => complete
[level] => 2
[value] => simple note
)
[2] => Array
(
[tag] => PARA
[type] => close
[level] => 1
)
)
]]>
</screen>
</informalexample>
</para>
<para>
Un parsing event-driven (basato sulla libreria expat) pu� essere
molto complicato se si deve trattare un documento XML complesso.
Questa funzione non produce un oggetto in stile DOM, ma
genera una struttura che permette di essere gestita a modo di
albero. Quindi si pu� facilmente creare oggetti rappresentanti i dati
del file XML. Si consideri il seguente file XML rappresentante
un piccolo database di informazioni sugli aminoacidi.
<example>
<title>moldb.xml - piccolo database di informazioni sulle molecole</title>
<programlisting role="xml">
<![CDATA[
<?xml version="1.0"?>
<moldb>
<molecule>
<name>Alanine</name>
<symbol>ala</symbol>
<code>A</code>
<type>hydrophobic</type>
</molecule>
<molecule>
<name>Lysine</name>
<symbol>lys</symbol>
<code>K</code>
<type>charged</type>
</molecule>
</moldb>
]]>
</programlisting>
</example>
Un codice per analizzare il documento e generare gli oggetti
appropriati:
<example>
<title>
parsemoldb.php - analizza moldb.xml e genera una matrice
di oggetti molecole
</title>
<programlisting role="php">
<![CDATA[
<?php
class AminoAcid {
var $name; // aa nome
var $symbol; // simbolo di tre lettere
var $code; // codice di una lettera
var $type; // hydrophobic, charged or neutral
function AminoAcid ($aa) {
foreach ($aa as $k=>$v)
$this->$k = $aa[$k];
}
}
function readDatabase($filename) {
// legge il database degli aminoacidi
$data = implode("",file($filename));
$parser = xml_parser_create();
xml_parser_set_option($parser,XML_OPTION_CASE_FOLDING,0);
xml_parser_set_option($parser,XML_OPTION_SKIP_WHITE,1);
xml_parse_into_struct($parser,$data,$values,$tags);
xml_parser_free($parser);
// loop attraverso la struttura
foreach ($tags as $key=>$val) {
if ($key == "molecule") {
$molranges = $val;
// ciascuna coppia di elementi della matrice contigui
// sono il limite inferiore e superiore per la definizione di ciascuna
molecola
for ($i=0; $i < count($molranges); $i+=2) {
$offset = $molranges[$i] + 1;
$len = $molranges[$i + 1] - $offset;
$tdb[] = parseMol(array_slice($values, $offset, $len));
}
} else {
continue;
}
}
return $tdb;
}
function parseMol($mvalues) {
for ($i=0; $i < count($mvalues); $i++)
$mol[$mvalues[$i]["tag"]] = $mvalues[$i]["value"];
return new AminoAcid($mol);
}
$db = readDatabase("moldb.xml");
echo "** Database di oggetti Aminoacidi:\n";
print_r($db);
?>
]]>
</programlisting>
</example>
Dopo l'esecuzione di <filename>parsemoldb.php</filename>, la variabile
<varname>$db</varname> contiene una matrice di oggetti
<classname>AminoAcid</classname>, e ci� viene confermato
dall'output dello script:
<informalexample>
<screen>
<![CDATA[
** Database di oggetti Aminoacidi:
Array
(
[0] => aminoacid Object
(
[name] => Alanine
[symbol] => ala
[code] => A
[type] => hydrophobic
)
[1] => aminoacid Object
(
[name] => Lysine
[symbol] => lys
[code] => K
[type] => charged
)
)
]]>
</screen>
</informalexample>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/xml-parse.xml
+++ phpdoc/it/reference/xml/functions/xml-parse.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.2 -->
<refentry id="function.xml-parse">
<refnamediv>
<refname>xml_parse</refname>
<refpurpose>Inizia il parsing di un documento XML</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>bool</type><methodname>xml_parse</methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
<methodparam><type>string</type><parameter>data</parameter></methodparam>
<methodparam
choice="opt"><type>bool</type><parameter>e_finale</parameter></methodparam>
</methodsynopsis>
<para>
<variablelist>
<varlistentry>
<term><parameter>parser</parameter></term>
<listitem>
<simpara>
Il riferimento al parser XML da utilizzare.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<simpara>
Segmento di dati da analizzare. Un documento pu� essere elaborato
a segmenti richiamando <function>xml_parse</function> diverse volte con nuovi
dati,
con il parametro <parameter>e_finale</parameter> settato a
&true; quando si elabora l'ultimo segmento.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>e_finale</parameter> (optional)</term>
<listitem>
<simpara>
Se valorizzato a &true;, il parametro <parameter>data</parameter> rappresenta
l'ultimo segmento dei dati inviati al parser.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
Quando si esegue il parsing di un documento XML, i gestori configurati per gli
eventi vengono richiamati tutte le volte che � necessario, dopo i quali
questa funzione restituisce &true; oppure &false;.
</para>
<para>
La funzione restituisce &true; se il parsing riesce, altrimenti restituisce
&false;
se non riesce o se il parametro <parameter>parser</parameter> si riferisce ad un
parser
non valido. In caso di parsing non riuscito, si pu� recuperare informazioni
sull'errore usando <function>xml_get_error_code</function>,
<function>xml_error_string</function>,
<function>xml_get_current_line_number</function>,
<function>xml_get_current_column_number</function> e
<function>xml_get_current_byte_index</function>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/xml-parser-create-ns.xml
+++ phpdoc/it/reference/xml/functions/xml-parser-create-ns.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.24 -->
<refentry id='function.xml-parser-create-ns'>
<refnamediv>
<refname>xml_parser_create_ns</refname>
<refpurpose>
Crea un parser XML
</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>resource</type><methodname>xml_parser_create_ns</methodname>
<methodparam
choice="opt"><type>string</type><parameter>encoding</parameter></methodparam>
<methodparam
choice="opt"><type>string</type><parameter>sep</parameter></methodparam>
</methodsynopsis>
<para>
&warn.undocumented.func;
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/xml-parser-create.xml
+++ phpdoc/it/reference/xml/functions/xml-parser-create.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.2 -->
<refentry id="function.xml-parser-create">
<refnamediv>
<refname>xml_parser_create</refname>
<refpurpose>Crea un parser XML</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>resource</type><methodname>xml_parser_create</methodname>
<methodparam
choice="opt"><type>string</type><parameter>codifica</parameter></methodparam>
</methodsynopsis>
<para>
<variablelist>
<varlistentry>
<term><parameter>codifica</parameter> (optional)</term>
<listitem>
<para>
Quale codifica di carattere utilizzare. Sono supportate le seguenti
codifiche di carattere:
<simplelist>
<member><literal>ISO-8859-1</literal> (default)</member>
<member><literal>US-ASCII</literal></member>
<member><literal>UTF-8</literal></member>
</simplelist>
</para>
</listitem>
</varlistentry>
</variablelist>
Questa funzione crea un parser XML e restituisce un handle da usarsi
con le altre funzioni XML. Restituisce &false; in caso di errore.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/xml-parser-free.xml
+++ phpdoc/it/reference/xml/functions/xml-parser-free.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.2 -->
<refentry id="function.xml-parser-free">
<refnamediv>
<refname>xml_parser_free</refname>
<refpurpose>Cancella un parser XML</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>bool</type><methodname>xml_parser_free</methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
</methodsynopsis>
<para>
<variablelist>
<varlistentry>
<term><parameter>parser</parameter></term>
<listitem>
<simpara>
Riferimento al parser XML da cancellare.
</simpara>
</listitem>
</varlistentry>
</variablelist></para>
<para>
Questa funzione restituisce &false; se <parameter>parser</parameter> non
si riferisce ad un parser valido, altrimenti cancella il parser e restituisce
&true;
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/xml-parser-get-option.xml
+++ phpdoc/it/reference/xml/functions/xml-parser-get-option.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.2 -->
<refentry id="function.xml-parser-get-option">
<refnamediv>
<refname>xml_parser_get_option</refname>
<refpurpose>Restituisce le opzioni da un parser XML</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>mixed</type><methodname>xml_parser_get_option</methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
<methodparam><type>int</type><parameter>opzione</parameter></methodparam>
</methodsynopsis>
<para>
<variablelist>
<varlistentry>
<term><parameter>parser</parameter></term>
<listitem>
<simpara>
Riferimento al parser XML da cui ottenere l'opzione
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>opzione</parameter></term>
<listitem>
<simpara>
Quale opzione ottenere. Vedere
<function>xml_parser_set_option</function> per l'elenco delle opzioni.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
Questa funzione restituisce &false; se <parameter>parser</parameter> non
si riferisce ad un parser valido, o se l'opzione non pu� essere valorizzata.
Altrimenti viene restituito il valore dell'opzione.
</para>
<para>
Vedere <function>xml_parser_set_option</function> per l'elenco delle
opzioni.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/xml-parser-set-option.xml
+++ phpdoc/it/reference/xml/functions/xml-parser-set-option.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.2 -->
<refentry id="function.xml-parser-set-option">
<refnamediv>
<refname>xml_parser_set_option</refname>
<refpurpose>Valorizza un'opzione di un parser XML</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>bool</type><methodname>xml_parser_set_option</methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
<methodparam><type>int</type><parameter>opzione</parameter></methodparam>
<methodparam><type>mixed</type><parameter>valore</parameter></methodparam>
</methodsynopsis>
<para>
<variablelist>
<varlistentry>
<term><parameter>parser</parameter></term>
<listitem>
<simpara>
Riferimento al parser XML di cui si vuole valorizzare l'opzione,
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>opzione</parameter></term>
<listitem>
<simpara>
Quale opzione valorizzare. Vedere pi� avanti.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>valore</parameter></term>
<listitem>
<simpara>
Nuovo valore dell'opzione.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
Questa funzione restituisce &false; se <parameter>parser</parameter> non
si riferisce ad un parser valido, o se l'opzione non pu� essere valorizzata.
Altrimenti l'opzione viene valorizzata e la funzione restituisce &true;.
</para>
<para>
Sono disponibili le seguenti opzioni:
<table>
<title>Opzioni del parser XML</title>
<tgroup cols="3">
<thead>
<row>
<entry>Costante dell'opzione</entry>
<entry>tipo di dato</entry>
<entry>Descrizione</entry>
</row>
</thead>
<tbody>
<row>
<entry>XML_OPTION_CASE_FOLDING</entry>
<entry>integer</entry>
<entry>
Controlla se il <link
linkend="xml.case-folding">case-folding</link> � abilitato per
questo parser XML. Abilitato per default.
</entry>
</row>
<row>
<entry>XML_OPTION_TARGET_ENCODING</entry>
<entry>string</entry>
<entry>
Indica quale <link linkend="xml.encoding">target encoding</link> utilizzare
in questo parser XML. Per default, � valorizzato con la medesima codifica
del sorgente utilizzata da <function>xml_parser_create</function>.
Le codifiche supportate per il destinatario sono
<literal>ISO-8859-1</literal>,
<literal>US-ASCII</literal> e <literal>UTF-8</literal>.
</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/xml-set-character-data-handler.xml
+++ phpdoc/it/reference/xml/functions/xml-set-character-data-handler.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.2 -->
<refentry id="function.xml-set-character-data-handler">
<refnamediv>
<refname>xml_set_character_data_handler</refname>
<refpurpose>Valorizza il gestore dei dati</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>bool</type><methodname>xml_set_character_data_handler</methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
<methodparam><type>string</type><parameter>gestore</parameter></methodparam>
</methodsynopsis>
<para>
Valorizza la funzione di gestione dei dati per il parser XML
<parameter>parser</parameter>. Il parametro <parameter>gestore</parameter> � una
stringa contenente il nome di una funzione che deve esistere quando
viene richiamata la funzione <function>xml_parse</function>
per il <parameter>parser</parameter>.
</para>
<para>
La fuzione indicata in <parameter>gestore</parameter> deve accettare
due parametri:
<methodsynopsis>
<methodname><replaceable>gestore</replaceable></methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
<methodparam><type>string</type><parameter>dati</parameter></methodparam>
</methodsynopsis>
<variablelist>
<varlistentry>
<term><parameter>parser</parameter></term>
<listitem>
<simpara>
Il primo parametro, <replaceable>parser</replaceable>, � un riferimento
al parser XML chiamante il gestore.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>dati</parameter></term>
<listitem>
<simpara>
Il secondo parametro, <parameter>dati</parameter>, � una stringa
contenente i dati.
</simpara>
</listitem>
</varlistentry>
</variablelist></para>
<para>
Se il nome della funzione di gestione viene indicato come una stringa vuota o
&false;
il gestore in questione viene disabilitato.
</para>
<para>
La funzione restituisce &true; se il gestore viene valorizzato, oppure &false; se
<parameter>parser</parameter> non indica un parser.
</para>
¬e.func-callback;
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/xml-set-default-handler.xml
+++ phpdoc/it/reference/xml/functions/xml-set-default-handler.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.2 -->
<refentry id="function.xml-set-default-handler">
<refnamediv>
<refname>xml_set_default_handler</refname>
<refpurpose>Valorizza il gestore di default</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>bool</type><methodname>xml_set_default_handler</methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
<methodparam><type>string</type><parameter>gestore</parameter></methodparam>
</methodsynopsis>
<para>
Questa funzione valorizza il gestore di default per
<parameter>parser</parameter>. Il parametro <parameter>gestore</parameter>
� una stringa contenente il nome di una funzione che deve esistere quando
viene eseguito <function>xml_parse</function> per il
<parameter>parser</parameter> XML.
</para>
<para>
La funzione indicata da <parameter>gestore</parameter> deve accettare
due parametri:
<methodsynopsis>
<methodname><replaceable>gestore</replaceable></methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
<methodparam><type>string</type><parameter>dati</parameter></methodparam>
</methodsynopsis>
<variablelist>
<varlistentry>
<term>
<parameter>parser</parameter>
</term>
<listitem>
<simpara>
Il primo parametro, <replaceable>parser</replaceable>, � un riferimento
al parser XML chiamante il gestore.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<parameter>dati</parameter>
</term>
<listitem>
<simpara>
Il secondo parametro, <parameter>dati</parameter>, contiene
i dati. Questi possono essere dichiarazioni XML,
dichiarazioni di tipo documento, entit� oppure altri dati per
i quali non � definito il gestore.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
Se il nome della funzione del gestore viene valorizzato con una stringa vuota
oppure a &false;,
il gestore in questione viene disabilitato.
</para>
<para>
La funzione restituisce &true; se il gestore viene attivato, &false; se
<parameter>parser</parameter> non indica un parser XML.
</para>
¬e.func-callback;
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/xml-set-element-handler.xml
+++ phpdoc/it/reference/xml/functions/xml-set-element-handler.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.2 -->
<refentry id="function.xml-set-element-handler">
<refnamediv>
<refname>xml_set_element_handler</refname>
<refpurpose>Valorizza i gestori di inizio e fine elemento</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>bool</type><methodname>xml_set_element_handler</methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
<methodparam><type>string</type><parameter>gestore_inizio_elemento</parameter></methodparam>
<methodparam><type>string</type><parameter>gestore_fine_elemento</parameter></methodparam>
</methodsynopsis>
<para>
La funzione indica le funzioni di gestione di inizio e fine elemento per il
<parameter>parser</parameter> XML.
<parameter>gestore_inizio_elemento</parameter> e
<parameter>gestore_fine_elemento</parameter> sono stringhe contenenti
i nomi di funzioni che devono esistere quando
viene eseguito <function>xml_parse</function> per il
<parameter>parser</parameter>.
</para>
<para>
La funzione indicata da <parameter>gestore_inizio_elemento</parameter>
deve accettare tre parametri:
<methodsynopsis>
<methodname><replaceable>gestore</replaceable></methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
<methodparam><type>string</type><parameter>nome</parameter></methodparam>
<methodparam><type>array</type><parameter>attibuti</parameter></methodparam>
</methodsynopsis>
<variablelist>
<varlistentry>
<term><parameter>parser</parameter></term>
<listitem>
<simpara>
Il primo parametro, <replaceable>parser</replaceable>, � il riferimento
al parser XML chiamante il gestore.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>nome</parameter></term>
<listitem>
<simpara>
Il secondo parametro, <parameter>nome</parameter>, contiene il nome
dell'elemento per il quale viene chiamato il gestore. Se � attivo il
<link linkend="xml.case-folding">case-folding</link> per questo parser,
il nome dell'elemento sar� in maiuscolo.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>attributi</parameter></term>
<listitem>
<simpara>
Il terzo parametro, <parameter>attributi</parameter>, contiene un array
associativo con gli attributi dell'elemento (se presenti). Le chiavi
di questo array sono i nomi degli attributi, mentre i valori delle chiavi
sono i valori
degli attributi. I nomi degli attributi sono <link
linkend="xml.case-folding">case-folded</link> allo stesso modo dei
nomi degli elementi. I valori degli attributi <emphasis>non</emphasis>
lo sono.
</simpara>
<simpara>
L'ordine originale degli attributi pu� essere recuperato attraversando
<parameter>attributi</parameter> in modo normale utilizzando la funzione
<function>each</function>. La prima chiave dell'array � il primo attributo,
e cos� via.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
La funzione indicata da <parameter>gestore_fine_elemento</parameter>
deve accettare due parametri:
<methodsynopsis>
<methodname><replaceable>gestore</replaceable></methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
<methodparam><type>string</type><parameter>nome</parameter></methodparam>
</methodsynopsis>
<variablelist>
<varlistentry>
<term><parameter>parser</parameter></term>
<listitem>
<simpara>
Il primo parametro, <replaceable>parser</replaceable>, � il riferimento
al parser XML chiamante il gestore.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>nome</parameter></term>
<listitem>
<simpara>
Il secondo parametro, <parameter>nome</parameter>, contiene il nome
dell'elemento per il quale viene chiamato il gestore. Se � attivo il
<link linkend="xml.case-folding">case-folding</link> per questo parser,
il nome dell'elemento sar� in maiuscolo.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
Se il nome della funzione del gestore viene valorizzato con una stringa vuota
oppure a &false;,
il gestore in questione viene disabilitato.
</para>
<para>
La funzione restituisce &true; se il gestore viene attivato, &false; se
<parameter>parser</parameter> non indica un parser XML.
</para>
¬e.func-callback;
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/xml-set-end-namespace-decl-handler.xml
+++ phpdoc/it/reference/xml/functions/xml-set-end-namespace-decl-handler.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.24 -->
<refentry id='function.xml-set-end-namespace-decl-handler'>
<refnamediv>
<refname>xml_set_end_namespace_decl_handler</refname>
<refpurpose>
Valorizza il gestore dei dati
</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>bool</type><methodname>xml_set_end_namespace_decl_handler</methodname>
<methodparam><type>resource</type><parameter>pind</parameter></methodparam>
<methodparam><type>string</type><parameter>hdl</parameter></methodparam>
</methodsynopsis>
<para>
&warn.undocumented.func;
</para>
¬e.func-callback;
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/xml-set-external-entity-ref-handler.xml
+++ phpdoc/it/reference/xml/functions/xml-set-external-entity-ref-handler.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.4 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.2 -->
<refentry id="function.xml-set-external-entity-ref-handler">
<refnamediv>
<refname>xml_set_external_entity_ref_handler</refname>
<refpurpose>Valorizza il gestore dei riferimenti a entit� esterne</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>bool</type><methodname>xml_set_external_entity_ref_handler</methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
<methodparam><type>string</type><parameter>gestore</parameter></methodparam>
</methodsynopsis>
<para>
Indica al parser XML <parameter>parser</parameter> la funzione per la
gestione dei riferimenti a entit� esterne. Il <parameter>gestore</parameter> �
una stringa contenente il nome di una funzione che deve esistere quando
viene eseguita la funzione <function>xml_parse</function>
per il <parameter>parser</parameter>.
</para>
<para>
La funzione indicata da <parameter>gestore</parameter> deve accettare
cinque parametri, e dovrebbe restituire un intero. Se il valore restituito
dal gestore � &false; (valore assunto per default in caso di nessun valore
restituito), il parser XML ferma l'elaborazione e
<function>xml_get_error_code</function> restituir� <systemitem
class="constant">XML_ERROR_EXTERNAL_ENTITY_HANDLING</systemitem>.
<methodsynopsis>
<methodname><replaceable>gestore</replaceable></methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
<methodparam><type>string</type><parameter>nomi_entita_aperte</parameter></methodparam>
<methodparam><type>string</type><parameter>base</parameter></methodparam>
<methodparam><type>string</type><parameter>system_id</parameter></methodparam>
<methodparam><type>string</type><parameter>public_id</parameter></methodparam>
</methodsynopsis>
<variablelist>
<varlistentry>
<term><parameter>parser</parameter></term>
<listitem>
<simpara>
Il primo parametro, <replaceable>parser</replaceable>, � il riferimento
al parser XML chiamante il gestore.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>nome_entita_aperte</parameter></term>
<listitem>
<simpara>
Il secondo parametro, <parameter>nomi_entita_aperte</parameter>, � una lista
di nomi, separati da spazio, delle entit� che saranno aperte
per il parsing di questa entit� (compreso il nome dell'entit�
indicata)
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>base</parameter></term>
<listitem>
<simpara>
Questa � la base per la risoluzione dell'identificatore system
(<parameter>systemid</parameter>) delle entit� esterne. Attualmente questo
parametro � sempre valorizzato con una stringa vuota.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>system_id</parameter></term>
<listitem>
<simpara>
Il quarto parametro, <parameter>system_id</parameter>, �
l'identificatore system come specificato nella dichiarazione dell'entit�.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>public_id</parameter></term>
<listitem>
<simpara>
Il quinto parametro, <parameter>public_id</parameter>, �
l'identificatore public come specificato nella dichiarazione dell'entit�,
oppure una stringa vuota se non viene specificato; lo spazio
nell'identificatore public � normalizzato come richiesto dalle
specifiche XML.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
Se il nome della funzione del gestore viene valorizzato con una stringa vuota
oppure a &false;,
il gestore in questione viene disabilitato.
</para>
<para>
La funzione restituisce &true; se il gestore viene attivato, &false; se
<parameter>parser</parameter> non indica un parser XML.
</para>
¬e.func-callback;
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/xml-set-notation-decl-handler.xml
+++ phpdoc/it/reference/xml/functions/xml-set-notation-decl-handler.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.2 -->
<refentry id="function.xml-set-notation-decl-handler">
<refnamediv>
<refname>xml_set_notation_decl_handler</refname>
<refpurpose>Valorizza il gestore delle dichiarazione delle notazioni</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>bool</type><methodname>xml_set_notation_decl_handler</methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
<methodparam><type>string</type><parameter>handler</parameter></methodparam>
</methodsynopsis>
<para>
Indica al parser XML <parameter>parser</parameter> la funzione per la
gestione delle dichiarazioni delle notazioni. Il <parameter>gestore</parameter> �
una stringa contenente il nome di una funzione che deve esistere quando
viene eseguita la funzione <function>xml_parse</function>
per il <parameter>parser</parameter>.
</para>
<para>
La dichiarazione di una notazione � una parte della DTD del documento ed ha il
seguente formato: <programlisting role="xml"><!NOTATION
<parameter>name</parameter> {<parameter>system_id</parameter> |
<parameter>public_id</parameter>}></programlisting> Vedere <ulink
url="&url.rec-xml;#Notations">la sezione 4.7 delle specifiche XML 1.0
</ulink> per la definizione delle dichiarazioni delle notazioni.
</para>
<para>
La funzione indicata da <parameter>gestore</parameter> deve accettare
cinque parametri:
<methodsynopsis>
<methodname><replaceable>gestore</replaceable></methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
<methodparam><type>string</type><parameter>nome_notazione</parameter></methodparam>
<methodparam><type>string</type><parameter>base</parameter></methodparam>
<methodparam><type>string</type><parameter>system_id</parameter></methodparam>
<methodparam><type>string</type><parameter>public_id</parameter></methodparam>
</methodsynopsis>
<variablelist>
<varlistentry>
<term>
<parameter>parser</parameter>
</term>
<listitem>
<simpara>
Il primo parametro, <replaceable>parser</replaceable>, � il riferimento
al parser XML chiamante il gestore.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>nome_notazione</parameter></term>
<listitem>
<simpara>
Questo � il parametro <parameter>name</parameter> della notazione, come
dal formato descritto in precedenza.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<parameter>base</parameter>
</term>
<listitem>
<simpara>
Questa � la base per la risoluzione dell'identificatore system
(<parameter>system_id</parameter>) delle entit� esterne. Attualmente questo
parametro � sempre valorizzato con una stringa vuota.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>system_id</parameter></term>
<listitem>
<simpara>
Identificatore system della dichiarazione della notazione esterna.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
<parameter>public_id</parameter>
</term>
<listitem>
<simpara>
Identificatore public della dichiarazione della notazione esterna.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
Se il nome della funzione del gestore viene valorizzato con una stringa vuota
oppure a &false;,
il gestore in questione viene disabilitato.
</para>
<para>
La funzione restituisce &true; se il gestore viene attivato, &false; se
<parameter>parser</parameter> non indica un parser XML.
</para>
¬e.func-callback;
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/xml-set-object.xml
+++ phpdoc/it/reference/xml/functions/xml-set-object.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.2 -->
<refentry id="function.xml-set-object">
<refnamediv>
<refname>xml_set_object</refname>
<refpurpose>Utilizza il parser XML all'interno di un oggetto</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>void</type><methodname>xml_set_object</methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
<methodparam><type>object</type><parameter>&oggetto</parameter></methodparam>
</methodsynopsis>
<para>
Questa funzione permette l'uso del <parameter>parser</parameter> all'interno
di un <parameter>oggetto</parameter>. Tutte le funzioni di callback possono
essere indicate con
<function>xml_set_element_handler</function> e simili, e sono assunte come metodi
dell'<parameter>oggetto</parameter>.
</para>
<programlisting role="php">
<![CDATA[
<?php
class xml {
var $parser;
function xml()
{
$this->parser = xml_parser_create();
xml_set_object($this->parser, &$this);
xml_set_element_handler($this->parser, "tag_open", "tag_close");
xml_set_character_data_handler($this->parser, "cdata");
}
function parse($data)
{
xml_parse($this->parser, $data);
}
function tag_open($parser, $tag, $attributes)
{
var_dump($parser, $tag, $attributes);
}
function cdata($parser, $cdata)
{
var_dump($parser, $cdata);
}
function tag_close($parser, $tag)
{
var_dump($parser, $tag);
}
} // fine della classe xml
$xml_parser = new xml();
$xml_parser->parse("<A ID='hallo'>PHP</A>");
?>
]]>
</programlisting>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/xml-set-processing-instruction-handler.xml
+++ phpdoc/it/reference/xml/functions/xml-set-processing-instruction-handler.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.2 -->
<refentry id="function.xml-set-processing-instruction-handler">
<refnamediv>
<refname>xml_set_processing_instruction_handler</refname>
<refpurpose>
Indica il gestore delle istruzioni di processo (PI)
</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>bool</type><methodname>xml_set_processing_instruction_handler</methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
<methodparam><type>string</type><parameter>gestore</parameter></methodparam>
</methodsynopsis>
<para>
Indica al parser XML <parameter>parser</parameter> la funzione per la
gestione delle istruzioni di processo (PI). Il <parameter>gestore</parameter> �
una stringa contenente il nome di una funzione che deve esistere quando
viene eseguita la funzione <function>xml_parse</function>
per il <parameter>parser</parameter>.
</para>
<para>
Le istruzioni di processo hanno il seguente formato:
<informalexample>
<programlisting><?
<replaceable>target</replaceable>
<replaceable>data</replaceable>?>
</programlisting>
</informalexample>
Si pu� inserire codice PHP all'interno di questo tipo di tag, ma occorre fare
attenzione ad una limitazione:
in una PI XML, il tag di fine PI (<literal>?></literal>) non pu� essere tra
apici,
pertanto questa seguenza di caratteri non dovrebbe apparire nel codice PHP che si
inserisce nel documento XML con le PIs. Se ci� accade il resto del codice PHP,
come
il "reale" tag di fine PI, saranno trattati come caratteri di dati.
</para>
<para>
La funzione indicata da <parameter>gestore</parameter> deve accettare
tre parametri:
<methodsynopsis>
<methodname><replaceable>gestore</replaceable></methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
<methodparam><type>string</type><parameter>target</parameter></methodparam>
<methodparam><type>string</type><parameter>dati</parameter></methodparam>
</methodsynopsis>
<variablelist>
<varlistentry>
<term><parameter>parser</parameter></term>
<listitem>
<simpara>
Il primo parametro, <replaceable>parser</replaceable>, � il riferimento
al parser XML chiamante il gestore.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>target</parameter></term>
<listitem>
<simpara>
Il secondo parametro, <parameter>target</parameter>, contiene la PI
target.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>dati</parameter></term>
<listitem>
<simpara>
Il terzo parametro, <parameter>dati</parameter>, contiene i dati
del PI.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
Se il nome della funzione del gestore viene valorizzato con una stringa vuota
oppure a &false;,
il gestore in questione viene disabilitato.
</para>
<para>
La funzione restituisce &true; se il gestore viene attivato, &false; se
<parameter>parser</parameter> non indica un parser XML.
</para>
¬e.func-callback;
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/xml-set-start-namespace-decl-handler.xml
+++ phpdoc/it/reference/xml/functions/xml-set-start-namespace-decl-handler.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.24 -->
<refentry id='function.xml-set-start-namespace-decl-handler'>
<refnamediv>
<refname>xml_set_start_namespace_decl_handler</refname>
<refpurpose>
Valorizza il gestore dei caratteri di dati
</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>bool</type><methodname>xml_set_start_namespace_decl_handler</methodname>
<methodparam><type>resource</type><parameter>pind</parameter></methodparam>
<methodparam><type>string</type><parameter>hdl</parameter></methodparam>
</methodsynopsis>
<para>
&warn.undocumented.func;
</para>
¬e.func-callback;
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
Index: phpdoc/it/reference/xml/functions/xml-set-unparsed-entity-decl-handler.xml
+++ phpdoc/it/reference/xml/functions/xml-set-unparsed-entity-decl-handler.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: darvina Status: ready -->
<!-- splitted from ./en/functions/xml.xml, last change in rev 1.2 -->
<refentry id="function.xml-set-unparsed-entity-decl-handler">
<refnamediv>
<refname>xml_set_unparsed_entity_decl_handler</refname>
<refpurpose>
Valorizza il gestore delle dichiarazioni di entit� non analizzate
</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
<type>bool</type><methodname>xml_set_unparsed_entity_decl_handler</methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
<methodparam><type>string</type><parameter>gestore</parameter></methodparam>
</methodsynopsis>
<para>
Indica al parser XML <parameter>parser</parameter> la funzione per la
gestione delle dichiarazioni di entit� non analizzate. Il
<parameter>gestore</parameter> �
una stringa contenente il nome di una funzione che deve esistere quando
viene eseguita la funzione <function>xml_parse</function>
per il <parameter>parser</parameter>.
</para>
<para>
Questo gestore viene richiamato quando il parser XML incontra una
dichiarazione di entit� esterna con una dichiarazione NDATA, tipo la
seguente:
<programlisting role="xml">
<!ENTITY <parameter>name</parameter> {<parameter>publicId</parameter> |
<parameter>systemId</parameter>}
NDATA <parameter>notationName</parameter>>
</programlisting>
</para>
<para>
Vedere <ulink url="&url.rec-xml;#sec-external-ent">la sezione 4.2.2 delle
specifiche di XML 1.0</ulink> per la definizione di notazioni dichiarate
in entit� esterne.
</para>
<para>
La funzione indicata da <parameter>gestore</parameter> deve accettare
sei parametri:
<methodsynopsis>
<methodname><replaceable>gestore</replaceable></methodname>
<methodparam><type>resource</type><parameter>parser</parameter></methodparam>
<methodparam><type>string</type><parameter>nome_entit�</parameter></methodparam>
<methodparam><type>string</type><parameter>base</parameter></methodparam>
<methodparam><type>string</type><parameter>system_id</parameter></methodparam>
<methodparam><type>string</type><parameter>public_id</parameter></methodparam>
<methodparam><type>string</type><parameter>nome_notazione</parameter></methodparam>
</methodsynopsis>
<variablelist>
<varlistentry>
<term><parameter>parser</parameter></term>
<listitem>
<simpara>
Il primo parametro, <replaceable>parser</replaceable>, � il riferimento
al parser XML chiamante il
gestore.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>nome_entit�</parameter></term>
<listitem>
<simpara>
Il nome dell'entit� che sta per essere definita.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>base</parameter></term>
<listitem>
<simpara>
Questa � la base per la risoluzione dell'identificatore system
(<parameter>systemid</parameter>) delle entit� esterne. Attualmente questo
parametro � sempre valorizzato con una stringa vuota.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>system_id</parameter></term>
<listitem>
<simpara>
Identificatore system per l'entit� esterna.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>public_id</parameter></term>
<listitem>
<simpara>
Identificatore public per l'entit� esterna.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>nome_notazione</parameter></term>
<listitem>
<simpara>
Nome della notazione di questa entit� (vedere
<function>xml_set_notation_decl_handler</function>).
</simpara>
</listitem>
</varlistentry>
</variablelist></para>
<para>
Se il nome della funzione del gestore viene valorizzato con una stringa vuota
oppure a &false;,
il gestore in questione viene disabilitato.
</para>
<para>
La funzione restituisce &true; se il gestore viene attivato, &false; se
<parameter>parser</parameter> non indica un parser XML.
</para>
¬e.func-callback;
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->
