ChoiceFormat Classe

Définition

[Android.Runtime.Register("java/text/ChoiceFormat", DoNotGenerateAcw=true)]
public class ChoiceFormat : Java.Text.NumberFormat

[<Android.Runtime.Register("java/text/ChoiceFormat", DoNotGenerateAcw=true)>]
type ChoiceFormat = class
    inherit NumberFormat

Héritage

Object

JavaObject

Object

_Format

NumberFormat

ChoiceFormat

Attributs

RegisterAttribute

Remarques

A ChoiceFormat vous permet d’attacher un format à une plage de nombres. Il est généralement utilisé dans un MessageFormat pour gérer les pluriels. Le choix est spécifié avec une liste croissant de doubles, où chaque élément spécifie un intervalle demi-ouvert jusqu’à l’élément suivant : <blockquote>

X matches j if and only if limit[j] ≤ X < limit[j+1]

</blockquote> S’il n’existe aucune correspondance, le premier ou le dernier index est utilisé, selon que le nombre (X) est trop faible ou trop élevé. Si le tableau de limites n’est pas dans l’ordre croissant, les résultats de la mise en forme sont incorrects. ChoiceFormat accepte \u221E également comme équivalent à infinity(INF).

< >strong Remarque :</strong>ChoiceFormat diffère des autres Format classes dans lesquelles vous créez un ChoiceFormat objet avec un constructeur (et non avec une getInstance méthode de fabrique de style). Les méthodes de fabrique ne sont pas nécessaires, car ChoiceFormat aucune configuration complexe n’est nécessaire pour un paramètre régional donné. En fait, ChoiceFormat n’implémente aucun comportement spécifique aux paramètres régionaux.

Lors de la création d’un ChoiceFormat, vous devez spécifier un tableau de formats et un tableau de limites. La longueur de ces tableaux doit être la même. Par exemple, <ul><li><em>limits</em> = {1,2,3,4,5,6,7}<br><em>formats</em> = {"Sun »,"Mon »,"Tue »,"Wed »,"Thur »,"Fri »,"Sat"}<li><em>limits</em> = {0, 1, ChoiceFormat.nextDouble(1)}<br><em>formats</em> = {"no files », « one file », « many files"}<br> (nextDouble peut être utilisé pour obtenir le double supérieur suivant, pour rendre l’intervalle demi-ouvert.) </ul>

Voici un exemple simple qui montre la mise en forme et l’analyse : <blockquote>

{@code
            double[] limits = {1,2,3,4,5,6,7};
            String[] dayOfWeekNames = {"Sun","Mon","Tue","Wed","Thur","Fri","Sat"};
            ChoiceFormat form = new ChoiceFormat(limits, dayOfWeekNames);
            ParsePosition status = new ParsePosition(0);
            for (double i = 0.0; i <= 8.0; ++i) {
                status.setIndex(0);
                System.out.println(i + " -> " + form.format(i) + " -> "
                                         + form.parse(form.format(i),status));
            }
            }

</blockquote> Voici un exemple plus complexe, avec un format de modèle : <blockquote>

{@code
            double[] filelimits = {0,1,2};
            String[] filepart = {"are no files","is one file","are {2} files"};
            ChoiceFormat fileform = new ChoiceFormat(filelimits, filepart);
            Format[] testFormats = {fileform, null, NumberFormat.getInstance()};
            MessageFormat pattform = new MessageFormat("There {0} on {1}");
            pattform.setFormats(testFormats);
            Object[] testArgs = {null, "ADisk", null};
            for (int i = 0; i < 4; ++i) {
                testArgs[0] = new Integer(i);
                testArgs[2] = testArgs[0];
                System.out.println(pattform.format(testArgs));
            }
            }

</blockquote>

La spécification d’un modèle pour les objets ChoiceFormat est assez simple. Par exemple : <blockquote>

{@code
            ChoiceFormat fmt = new ChoiceFormat(
                 "-1#is negative| 0#is zero or fraction | 1#is one |1.0<is 1+ |2#is two |2<is more than 2.");
            System.out.println("Formatter Pattern : " + fmt.toPattern());

            System.out.println("Format with -INF : " + fmt.format(Double.NEGATIVE_INFINITY));
            System.out.println("Format with -1.0 : " + fmt.format(-1.0));
            System.out.println("Format with 0 : " + fmt.format(0));
            System.out.println("Format with 0.9 : " + fmt.format(0.9));
            System.out.println("Format with 1.0 : " + fmt.format(1));
            System.out.println("Format with 1.5 : " + fmt.format(1.5));
            System.out.println("Format with 2 : " + fmt.format(2));
            System.out.println("Format with 2.1 : " + fmt.format(2.1));
            System.out.println("Format with NaN : " + fmt.format(Double.NaN));
            System.out.println("Format with +INF : " + fmt.format(Double.POSITIVE_INFINITY));
            }

</blockquote> Et le résultat de sortie ressemble à ce qui suit : <blockquote>

{@code
            Format with -INF : is negative
            Format with -1.0 : is negative
            Format with 0 : is zero or fraction
            Format with 0.9 : is zero or fraction
            Format with 1.0 : is one
            Format with 1.5 : is 1+
            Format with 2 : is two
            Format with 2.1 : is more than 2.
            Format with NaN : is negative
            Format with +INF : is more than 2.
            }

</blockquote>

<h2>"synchronization">Synchronization</h2>

Les formats de choix ne sont pas synchronisés. Il est recommandé de créer des instances de format distinctes pour chaque thread. Si plusieurs threads accèdent simultanément à un format, il doit être synchronisé en externe.

Ajouté dans la version 1.1.

Documentation Java pour java.text.ChoiceFormat.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.