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

<!-- EN-Revision: n/a Maintainer: darvina Status: ready -->

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

<refnamediv>

<refname>money_format</refname>

<refpurpose>Formattazione di un numero come stringa monetaria</refpurpose>

</refnamediv>

<refsect1>

<title>Descrizione</title>

<methodsynopsis>

<type>string</type><methodname>money_format</methodname>

<methodparam><type>string</type><parameter>format</parameter></methodparam>

<methodparam><type>float</type><parameter>number</parameter></methodparam>

</methodsynopsis>

<para>

<function>money_format</function> restituisce una versione formattata di

<parameter>number</parameter>. Questa funzione è un'interfaccia alla funzione C

<function>strfmon</function>, con la differenza che questa funzione

converte un solo numero alla volta.

</para>

<note>

<para>

La funzione <function>money_format</function> esiste solo se il

sistema suppporta strfmon. Ad esempio, Windows non lo supporta

perciò la funzione <function>money_format</function> non è definita su Windows.

</para>

</note>

<para>

LA specifica del formato consiste nella seguente sequenza:

<itemizedlist>

<listitem><para>un carattere <literal>%</literal></para></listitem>

<listitem><para>un flag opzionale flags</para></listitem>

<listitem><para>la lunghezza del campo, opzionale</para></listitem>

<listitem><para>la precisione a sinistra, opzionale</para></listitem>

<listitem><para>la precisione a destra, opzionale</para></listitem>

<listitem><para>un carattere di conversione, obbligatorio</para></listitem>

</itemizedlist>

</para>

<formalpara>

<title>Flag</title>

<para>

Si possono utilizzare uno o più dei seguenti flag:

<variablelist>

<varlistentry>

<term><literal>=</literal><replaceable>f</replaceable></term>

<listitem>

<para>

Il carattere <literal>=</literal> seguito da un singolo carattere (singolo byte)

<replaceable>f</replaceable> è utilizzato come carattere di riempimento numerico.

Il carattere di default è lo spazio.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>^</literal></term>

<listitem>

<para>

Disabilita l'utilizzo del raggruppamento dei caratetrei (come definito

nelle impostazioni locali).

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>+</literal> oppure <literal>(</literal></term>

<listitem>

<para>

Specifica lo stile di formattazione per i numeri positivi e negativi.

Se si utilizza <literal>+</literal>, sarà utilizzato l'equivalente valore locale per

<literal>+</literal> e <literal>-</literal>. Se si utilizza

<literal>(</literal>, i valori negativi saranno racchiusi tra

parentesi. Se non si da specifica, il default è

<literal>+</literal>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>!</literal></term>

<listitem>

<para>

Sopprime il simbolo della moneta nella stringa di output.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>-</literal></term>

<listitem>

<para>

Se presente, rende tutti i campi giustificati a sinistra (riempiti a

a destra), il default prevede i campi allineati a destra

(riempiti a sinistra).

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</formalpara>

<formalpara>

<title>Dimensioni del campo</title>

<para>

<variablelist>

<varlistentry>

<term><replaceable>w</replaceable></term>

<listitem>

<para>

Una stringa numerica che specifica la lunghezza minima del campo. Il campo sarà

allineato a destra a meno di non avere impostato il flag <literal>-</literal>.

Il valore di default è 0 (zero).

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</formalpara>

<formalpara>

<title>Precisione a sinistra</title>

<para>

<variablelist>

<varlistentry>

<term><literal>#</literal><replaceable>n</replaceable></term>

<listitem>

<para>

Sono attesi un numero massimo di (<replaceable>n</replaceable>) numeri

a sinistra del carattere decimale (es. il punto decimale). Solitamente si utilizza

per mantenere allineato l'output nella medesima colonna, utilizzando

il carattere di riempimento, se il numero delle cifre è inferiore a

<replaceable>n</replaceable>. Se il numero delle cifre è superiore

a <replaceable>n</replaceable>, questa specifica viene

ignorata.

</para>

<para>

Se il raggruppamento delle cifre non è soppresso tramite <literal>^</literal>,

saranno inseriti i separatori di raggruppamento prima dei caratteri

di riempimento (se presenti). I separatori di gruppo non saranno applicati

ai caratteri di riempimento, anche se il carattere di riempimento è un numero.

</para>

<para>

Per garantire l'allineamento, ogni carattere che, nella stringa formattata, appare prima o dopo

il numero, tipo il simbolo della moneta o il segno,

viene riempito con gli spazi necessari affinché la corrispondente stringa

risultante da un valore positivo o negativo abbia la medesima lunghezza.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</formalpara>

<formalpara>

<title>

Precisione di destra

</title>

<para>

<variablelist>

<varlistentry>

<term><literal>.</literal><replaceable>p</replaceable></term>

<listitem>

<para>

Un punto seguito da un numero di cifre

(<replaceable>p</replaceable>) dopo il carattere decimale. Se il valore di

<replaceable>p</replaceable> è 0 (zero), il carattere decimale

e le cifre alla sua destra saranno omesse. Se non vi

è indicazione della precisione a destra, il default sarà preso della impostazioni

locali. L'importo sarà arrontondato alle cifre

decimali richieste prima di essere formattato.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</formalpara>

<formalpara>

<title>

Caratteri di conversione

</title>

<para>

<variablelist>

<varlistentry>

<term><literal>i</literal></term>

<listitem>

<para>

Il numero sarà formattato in base alle impostazioni internazionali

locali (es. le impostazioni locali USA: USD 1,234.56).

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>n</literal></term>

<listitem>

<para>

Il numero sarà formattato in base alle locali impostazioni nazionali

di moneta (es. per de_DE: DM1.234,56).

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>%</literal></term>

<listitem>

<para>

Restituisce il carattere <literal>%</literal>.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</formalpara>

<note>

<para>

La categoria <constant>LC_MONETARY</constant> delle impostazioni locali

influisce sul comportamento di questa funzione. Utilizzare

<function>setlocale</function> per impostare il default appropriato

prima di utilizzare questa funzione.

</para>

<para>

I caratteri prima e dopo la stringa di formattazione saranno restituiti

immutati.

</para>

</note>

<para>

<example>

<title>Esempio di uso di <function>money_format</function></title>

<para>

Per illustrare il funzionamento della funzione utilizzeremo

diversi formati di impostazioni locali.

</para>

<programlisting role="php">

<![CDATA[

<?php

$number = 1234.56;

// stampa nel formato internazionale per l'impostazione en_US

setlocale(LC_MONETARY, 'en_US');

echo money_format('%i', $number) . "\n";

// USD 1,234.56

// Fromato italiano con 2 cifre decimali`

setlocale(LC_MONETARY, 'it_IT');

echo money_format('%.2n', $number) . "\n";

// L. 1.234,56

// Numeri negativi

$number = -1234.5672;

// Formato nazionale US, Utilizzo di () per i numeri negativi

// e 10 cifre di precisione a sinistra

setlocale(LC_MONETARY, 'en_US');

echo money_format('%(#10n', $number) . "\n";

// ($ 1,234.57)

// Simile al precente con 2 cifre di precisione a destra

// e '*' come carattere di riempimento

echo money_format('%=*(#10.2n', $number) . "\n";

// ($********1,234.57)

// Giustificazione a sinistra, con 14 posizioni di lunghezza, 8 cifre di

// precisione a sinistra, 2 di precisione a destra, senza carattere di raggruppamento

// e utilizzando l'impostazione locale de_DE.

setlocale(LC_MONETARY, 'de_DE');

echo money_format('%=*^-14#8.2i', 1234.56) . "\n";

// DEM 1234,56****

// Qualche carattere prima e dopo la specifica di formattazione

setlocale(LC_MONETARY, 'en_GB');

$fmt = 'The final value is %i (after a 10%% discount)';

echo money_format($fmt, 1234.56) . "\n";

// The final value is GBP 1,234.56 (after a 10% discount)

?>

]]>

</programlisting>

</example>

</para>

<para>

Vedere anche <function>setlocale</function>,

<function>number_format</function>,<function>sprintf</function>,

<function>printf</function> e <function>sscanf</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:"~/.phpdoc/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

-->