MessageFormat Classe

Definizione

[Android.Runtime.Register("android/icu/text/MessageFormat", ApiSince=24, DoNotGenerateAcw=true)]
public class MessageFormat : Android.Icu.Text.UFormat

[<Android.Runtime.Register("android/icu/text/MessageFormat", ApiSince=24, DoNotGenerateAcw=true)>]
type MessageFormat = class
    inherit UFormat

Ereditarietà

Object

Object

_Format

UFormat

MessageFormat

Attributi

RegisterAttribute

Commenti

<strong>[icu enhancement]</strong> ICU's replacement for java.text.MessageFormat.  Metodi, campi e altre funzionalità specifiche dell'ICU sono etichettati come "<strong>[icu]</strong>".

MessageFormat prepara le stringhe per la visualizzazione agli utenti, con argomenti facoltativi (variabili/segnaposto). Gli argomenti possono verificarsi in qualsiasi ordine, necessario per la traduzione in lingue con grammatiche diverse.

MessageFormat viene costruito da una <stringa em>pattern</em> con argomenti in {parentesi graffe} che verranno sostituiti da valori formattati.

MessageFormat differisce dalle altre Format classi in quanto si crea un MessageFormat oggetto con uno dei relativi costruttori (non con un getInstance metodo factory di stile). I metodi factory non sono necessari perché MessageFormat non implementa un comportamento specifico delle impostazioni locali. Qualsiasi comportamento specifico delle impostazioni locali viene definito dal modello fornito e dai sottoformatti usati per gli argomenti inseriti.

Gli argomenti possono essere denominati (usando identificatori) o numerati (usando numeri interi ASCII di piccole dimensioni). Alcuni metodi API funzionano solo con i numeri di argomento e generano un'eccezione se il criterio ha argomenti denominati (vedere #usesNamedArguments()).

Un argomento potrebbe non specificare alcun tipo di formato. In questo caso, un valore Number viene formattato con un valore predefinito (per le impostazioni locali) NumberFormat, un valore Date viene formattato con un valore predefinito (per le impostazioni locali) DateFormat e per qualsiasi altro valore viene utilizzato il valore toString().

Un argomento può specificare un tipo "semplice" per il quale viene creato, memorizzato nella cache e utilizzato l'oggetto Format specificato.

Un argomento potrebbe avere un tipo "complesso" con modelli secondari MessageFormat annidati. Durante la formattazione, uno di questi sotto-messaggi viene selezionato in base al valore dell'argomento e formattato in modo ricorsivo.

Dopo la costruzione, è possibile impostare un oggetto Format personalizzato per un argomento di primo livello, ignorando il comportamento di formattazione e analisi predefinito per tale argomento. Tuttavia, la formattazione personalizzata può essere ottenuta più semplicemente scrivendo un argomento senza tipi nella stringa del modello e fornendolo con un valore stringa preformattato.

Durante la formattazione, MessageFormat accetta una raccolta di valori di argomento e scrive una stringa di output. I valori dell'argomento possono essere passati come matrice (quando il criterio contiene solo argomenti numerati) o come oggetto Map (che funziona sia per gli argomenti denominati che per gli argomenti numerati).

Ogni argomento viene confrontato con uno dei valori di input in base all'indice di matrice o alla chiave della mappa e formattato in base alla specifica del modello o usando un oggetto Format personalizzato, se impostato. Un argomento pattern numerato viene confrontato con una chiave della mappa che contiene tale numero come stringa di cifre decimali ASCII (senza zero iniziale).

<h3>"patterns">Patterns and Their Interpretation</h3>

MessageFormat utilizza i modelli del formato seguente: <blockquote>

message = messageText (argument messageText)*
            argument = noneArg | simpleArg | complexArg
            complexArg = choiceArg | pluralArg | selectArg | selectordinalArg

            noneArg = '{' argNameOrNumber '}'
            simpleArg = '{' argNameOrNumber ',' argType [',' argStyle] '}'
            choiceArg = '{' argNameOrNumber ',' "choice" ',' choiceStyle '}'
            pluralArg = '{' argNameOrNumber ',' "plural" ',' pluralStyle '}'
            selectArg = '{' argNameOrNumber ',' "select" ',' selectStyle '}'
            selectordinalArg = '{' argNameOrNumber ',' "selectordinal" ',' pluralStyle '}'

            choiceStyle: see {@link ChoiceFormat}
            pluralStyle: see {@link PluralFormat}
            selectStyle: see {@link SelectFormat}

            argNameOrNumber = argName | argNumber
            argName = [^[[:Pattern_Syntax:][:Pattern_White_Space:]]]+
            argNumber = '0' | ('1'..'9' ('0'..'9')*)

            argType = "number" | "date" | "time" | "spellout" | "ordinal" | "duration"
            argStyle = "short" | "medium" | "long" | "full" | "integer" | "currency" | "percent" | argStyleText

</blockquote>

<ul><li>messageText può contenere stringhe letterali tra virgolette, inclusi i caratteri di sintassi. Una stringa letterale tra virgolette inizia con un apostrofo ASCII e un carattere di sintassi (in genere una parentesi graffa}) e continua fino al successivo apostrofo singolo. Un apostrofo ASCII doppio all'interno o all'esterno di una stringa tra virgolette rappresenta un apostrofo letterale. <I caratteri di sintassi tra virgolette li>sono le {parentesi graffe} in tutte le parti messageText, più il segno '#' in un messageText immediatamente all'interno di un pluralStyle e il simbolo '|' in un messageText immediatamente all'interno di un oggetto choiceStyle. <li>Vedi anche MessagePattern.ApostropheMode<li>In argStyleText, ogni singolo apostrofo ASCII inizia e termina il testo letterale tra virgolette e {parentesi graffe} senza virgolette} deve verificarsi in coppie corrispondenti. </ul>

Raccomandazione: usare il carattere apostrofo reale (virgolette singole) \\u2019 per il testo leggibile e usare l'apostrofo ASCII (\\u0027 ' ) solo nella sintassi del programma, come la citazione in MessageFormat. Vedere le annotazioni per U+0027 Apostrofo nello standard Unicode.

Il choice tipo di argomento è deprecato. Usare plural gli argomenti per la selezione plurale appropriata e select gli argomenti per la selezione semplice tra un set fisso di scelte.

I argType valori e argStyle vengono usati per creare un'istanza Format per l'elemento di formato. Nella tabella seguente viene illustrato il mapping dei valori alle istanze formatta. Le combinazioni non visualizzate nella tabella non sono valide. Qualsiasi argStyleText deve essere una stringa di pattern valida per la sottoclasse Format utilizzata.

<table border=1><tr><th argType >th<argStyle >th<>risultante Oggetto <Format tr><td colspan=2>(none)<td>null<tr><td rowspan=5>number<td>(none)<td tr>NumberFormat.getInstance(getLocale())td td<><>integer<>NumberFormat.getIntegerInstance(getLocale())<tr><td>currency<>NumberFormat.getCurrencyInstance(getLocale())<td tr><td td td tr td td tr>percent<>NumberFormat.getPercentInstance(getLocale())<><td>argStyleText<td>new DecimalFormat(argStyleText, new DecimalFormatSymbols(getLocale()))<tr><td rowspan=6>date<td>(none)<td>DateFormat.getDateInstance(DateFormat.DEFAULT, getLocale())<tr><td>short<td>DateFormat.getDateInstance(DateFormat.SHORT, getLocale())<tr><td>medium<td>DateFormat.getDateInstance(DateFormat.DEFAULT, getLocale())<tr><td>long<td>DateFormat.getDateInstance(DateFormat.LONG, getLocale())<tr><td td td>full<tr>DateFormat.getDateInstance(DateFormat.FULL, getLocale())td<><>argStyleText <td>new SimpleDateFormat(argStyleText, getLocale())<tr><td rowspan=6>time<td>(none)<td tr>DateFormat.getTimeInstance(DateFormat.DEFAULT, getLocale())td<><td>short<>DateFormat.getTimeInstance(DateFormat.SHORT, getLocale())<tr><td>medium<>DateFormat.getTimeInstance(DateFormat.DEFAULT, getLocale())<td tr><td td>long<td>DateFormat.getTimeInstance(DateFormat.LONG, getLocale())<tr><td td>full<tr>DateFormat.getTimeInstance(DateFormat.FULL, getLocale())td<><> argStyleText <td tr>new SimpleDateFormat(argStyleText, getLocale())<><td td>spellout<>argStyleText (facoltativo)td<>new RuleBasedNumberFormat(getLocale(), RuleBasedNumberFormat.SPELLOUT) <br>&nbsp;&nbsp;&nbsp;&nbsp;.setDefaultRuleset(argStyleText);tr<>td td<>ordinal<> argStyleText (facoltativo)td<>new RuleBasedNumberFormat(getLocale(), RuleBasedNumberFormat.ORDINAL) <br>&nbsp;&nbsp;&nbsp;&nbsp;.setDefaultRuleset(argStyleText);tr<>td td<>duration<> argStyleText (facoltativo)<td>new RuleBasedNumberFormat(getLocale(), RuleBasedNumberFormat.DURATION) <br>&nbsp;&nbsp;&nbsp;&nbsp;.setDefaultRuleset(argStyleText);</table>

<h4>"diffsjdk">Differenze da java.text.MessageFormat</h4>

ICU MessageFormat supporta argomenti denominati e numerati, mentre JDK MessageFormat supporta solo argomenti numerati. Gli argomenti denominati rendono i modelli più leggibili.

L'ICU implementa una sintassi di apostrofo più intuitiva. Nel testo del messaggio, un apostrofo inizia solo tra virgolette di testo letterale se precede immediatamente un carattere di sintassi (principalmente {parentesi graffe}).<br> In JDK MessageFormat, un apostrofo inizia sempre tra virgolette, che richiede testo comune come "don't" e "aujourd'hui" per essere scritto con apostrofi doubled come "don't" e "aujourd''hui". Per altri dettagli, vedere MessagePattern.ApostropheMode.

L'ICU non crea un oggetto ChoiceFormat per un oggetto choiceArg, pluralArg o selectArg, ma gestisce tali argomenti. JDK MessageFormat crea e usa un oggetto ChoiceFormat (new ChoiceFormat(argStyleText)). JDK non supporta affatto argomenti plurali e di selezione.

<h4>Usage Information</h4>

Ecco alcuni esempi di utilizzo: <blockquote>

Object[] arguments = {
                7,
                new Date(System.currentTimeMillis()),
                "a disturbance in the Force"
            };

            String result = MessageFormat.format(
                "At {1,time} on {1,date}, there was {2} on planet {0,number,integer}.",
                arguments);

<em>output</em>: At 12:30 PM on Jul 3, 2053, there was a disturbance
                      in the Force on planet 7.

</blockquote> In genere, il formato del messaggio proviene dalle risorse e gli argomenti verranno impostati in modo dinamico in fase di esecuzione.

Esempio 2: <blockquote>

Object[] testArgs = { 3, "MyDisk" };

            MessageFormat form = new MessageFormat(
                "The disk \"{1}\" contains {0} file(s).");

            System.out.println(form.format(testArgs));

            // output, with different testArgs
<em>output</em>: The disk "MyDisk" contains 0 file(s).
<em>output</em>: The disk "MyDisk" contains 1 file(s).
<em>output</em>: The disk "MyDisk" contains 1,273 file(s).

</blockquote>

Per i messaggi che includono forme plurali, è possibile usare un argomento plurale:

MessageFormat msgFmt = new MessageFormat(
                "{num_files, plural, " +
                "=0{There are no files on disk \"{disk_name}\".}" +
                "=1{There is one file on disk \"{disk_name}\".}" +
                "other{There are # files on disk \"{disk_name}\".}}",
                ULocale.ENGLISH);
            Map args = new HashMap();
            args.put("num_files", 0);
            args.put("disk_name", "MyDisk");
            System.out.println(msgFmt.format(args));
            args.put("num_files", 3);
            System.out.println(msgFmt.format(args));

<em>output</em>:
            There are no files on disk "MyDisk".
            There are 3 files on "MyDisk".

Vedere PluralFormat e PluralRules per informazioni dettagliate.

<h4>"synchronization">Synchronization</h4>

MessageFormats non è sincronizzato. È consigliabile creare istanze di formato separate per ogni thread. Se più thread accedono contemporaneamente a un formato, deve essere sincronizzato esternamente.

per android.icu.text.MessageFormat.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.