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

<refentry xml:id="function.ini-get" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>ini_get</refname>

<refpurpose>Restituisce il valore delle opzioni di configurazione</refpurpose>

</refnamediv>

<refsect1>

<title>Descrizione</title>

<methodsynopsis>

<type>string</type><methodname>ini_get</methodname>

<methodparam><type>string</type><parameter>varname</parameter></methodparam>

</methodsynopsis>

<para>

Restituisce il valore delle opzioni di configurazione. In caso di errore, tipo

la richiesta per un valore inesistente, sarà restituita una stringa vuota.

</para>

<note>

<title>Richieste per valori booleani</title>

<para>

Nel file ini, il valore booleano <literal>off</literal> sarà restituito come

stringa vuota o "0", mentre il valore <literal>on</literal> sarà restituito come

"1".

</para>

</note>

<note>

<title>Richieste per le dimensioni della memoria</title>

<para>

Diversi parametri attinenti alle dimensioni di memoria, tipo

<link linkend="ini.upload-max-filesize">upload_max_filesize</link>

sono registrati nel &php.ini; in notazione abbreviata. La funzione <function>ini_get</function>

restituirà l'esatto valore presente nel &php.ini;, e <emphasis>NON</emphasis>

l'<type>intero</type> equivalente. L'esecuzione delle normali funzioni aritmetiche su questi valori

potrà dare risultati inattesi. L'esempio seguente illustra come

si possa convertire la notazione breve in byte in modo molto simile a come

fa il PHP.

</para>

</note>

<para>

<example>

<title>Qualche esempio di <function>ini_get</function></title>

<programlisting role="php">

</programlisting>

<para>

Lo script produrrà:

</para>

<screen>

</screen>

</example>

</para>

<para>

Vedere anche:

<function>get_cfg_var</function>,

<function>ini_get_all</function>,

<function>ini_restore</function> e

<function>ini_set</function>.

</para>

</refsect1>

</refentry>