<?xml version="1.0" encoding="UTF-8"?>

<refentry xmlns="http://docbook.org/ns/docbook"

xml:id="function.xml-set-notation-decl-handler"

xmlns:xlink="http://www.w3.org/1999/xlink">

<refnamediv>

<refname>xml_set_notation_decl_handler</refname>

<refpurpose>Valorizza il gestore delle dichiarazione delle notazioni</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type>bool</type><methodname>xml_set_notation_decl_handler</methodname>

<methodparam><type>resource</type><parameter>parser</parameter></methodparam>

<methodparam><type>callable</type><parameter>handler</parameter></methodparam>

</methodsynopsis>

<para>

Valorizza il gestore delle dichiarazione delle notazioni per il parser XML

<parameter>parser</parameter>.

</para>

<para>

La dichiarazione di una notazione è una parte della DTD del documento ed ha il

seguente formato:

<programlisting role="xml">

</programlisting>

Vedere <link xlink:href="&url.rec-xml;#Notations">la sezione 4.7 delle specifiche

XML 1.0</link> per la definizione delle dichiarazioni delle notazioni.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>parser</parameter></term>

<listitem>

<para>

Un riferimento al parser XML per impostare la funzione del gestore della dichiarazione delle notazioni.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>handler</parameter></term>

<listitem>

<para>

<parameter>handler</parameter> è una stringa contenente il nome di una

funzione che deve esistere quando <function>xml_parse</function> è chiamata

per il <parameter>parser</parameter>.

</para>

<para>

La funzione indicata da <parameter>handler</parameter> deve accettare

cinque parametri:

<methodsynopsis>

<methodname><replaceable>handler</replaceable></methodname>

<methodparam><type>resource</type><parameter>parser</parameter></methodparam>

<methodparam><type>string</type><parameter>notation_name</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>, è un

riferimento al parser XML che chiama il gestore.

</simpara>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>notation_name</parameter></term>

<listitem>

<simpara>

Questo è il <parameter>name</parameter> della notazione, secondo

il formato della notazione descritto in precedenza.

</simpara>

</listitem>

</varlistentry>

<varlistentry>

<term>

<parameter>base</parameter>

</term>

<listitem>

<simpara>

Questa è la base per risolvere l'identificatore del sistema

(<parameter>system_id</parameter>) della dichiarazione della notazione.

Attualmente questo parametro sarà sempre impostato ad una stringa vuota.

</simpara>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>system_id</parameter></term>

<listitem>

<simpara>

L'identificatore del sistema della dichiarazione della notazione esterna.

</simpara>

</listitem>

</varlistentry>

<varlistentry>

<term>

<parameter>public_id</parameter>

</term>

<listitem>

<simpara>

Identificatore pubblico della dichiarazione della notazione esterna.

</simpara>

</listitem>

</varlistentry>

</variablelist>

</para>

<para>

Se una funzione di gestione è impostata con una stringa vuota, oppure &false;, il gestore

in questione è disabilitato.

</para>

&note.func-callback;

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

&return.success;

</para>

</refsect1>

</refentry>