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
-->
