Partager via


Formatter Classe

Définition

Interpréteur pour les chaînes de format de style printf.

[Android.Runtime.Register("java/util/Formatter", DoNotGenerateAcw=true)]
public sealed class Formatter : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.IO.ICloseable, Java.IO.IFlushable
[<Android.Runtime.Register("java/util/Formatter", DoNotGenerateAcw=true)>]
type Formatter = class
    inherit Object
    interface ICloseable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IFlushable
Héritage
Formatter
Attributs
Implémente

Remarques

Interpréteur pour les chaînes de format de style printf. Cette classe prend en charge la justification et l’alignement de la disposition, des formats courants pour les données numériques, chaînes et date/heure, ainsi que la sortie spécifique aux paramètres régionaux. Les types Java courants tels que byte, java.math.BigDecimal BigDecimalet Calendar sont pris en charge. La personnalisation de la mise en forme limitée pour les types d’utilisateurs arbitraires est fournie via l’interface Formattable .

Les formateurs ne sont pas nécessairement sécurisés pour l’accès multithread. La sécurité des threads est facultative et est la responsabilité des utilisateurs de méthodes dans cette classe.

L’impression mise en forme pour le langage Java est fortement inspirée de C’s printf. Bien que les chaînes de format soient similaires à C, certaines personnalisations ont été apportées pour prendre en charge le langage Java et exploiter certaines de ses fonctionnalités. En outre, la mise en forme Java est plus stricte que celle de C ; par exemple, si une conversion est incompatible avec un indicateur, une exception est levée. Dans les indicateurs inapplicables C, les indicateurs sont ignorés en mode silencieux. Les chaînes de format sont donc destinées à être reconnaissables aux programmeurs C, mais pas nécessairement entièrement compatibles avec celles en C.

Exemples d’utilisation attendue :

<blockquote>

StringBuilder sb = new StringBuilder();
              // Send all output to the Appendable object sb
              Formatter formatter = new Formatter(sb, Locale.US);

              // Explicit argument indices may be used to re-order output.
              formatter.format("%4$2s %3$2s %2$2s %1$2s", "a", "b", "c", "d")
              // -&gt; " d  c  b  a"

              // Optional locale as the first argument can be used to get
              // locale-specific formatting of numbers.  The precision and width can be
              // given to round and align the value.
              formatter.format(Locale.FRANCE, "e = %+10.4f", Math.E);
              // -&gt; "e =    +2,7183"

              // The '(' numeric flag may be used to format negative numbers with
              // parentheses rather than a minus sign.  Group separators are
              // automatically inserted.
              formatter.format("Amount gained or lost since last statement: $ %(,.2f",
                               balanceDelta);
              // -&gt; "Amount gained or lost since last statement: $ (6,217.58)"

</blockquote>

Les méthodes pratiques pour les demandes de mise en forme courantes existent, comme illustré par les appels suivants :

<blockquote>

// Writes a formatted string to System.out.
              System.out.format("Local time: %tT", Calendar.getInstance());
              // -&gt; "Local time: 13:34:18"

              // Writes formatted output to System.err.
              System.err.printf("Unable to open file '%1$s': %2$s",
                                fileName, exception.getMessage());
              // -&gt; "Unable to open file 'food': No such file or directory"

</blockquote>

Comme C’est sprintf(3)le cas, les chaînes peuvent être mises en forme à l’aide de la méthode String#format(String,Object...) String.formatstatique :

<blockquote>

// Format a string containing a date.
              import java.util.Calendar;
              import java.util.GregorianCalendar;
              import static java.util.Calendar.*;

              Calendar c = new GregorianCalendar(1995, MAY, 23);
              String s = String.format("Duke's Birthday: %1$tb %1$te, %1$tY", c);
              // -&gt; s == "Duke's Birthday: May 23, 1995"

</blockquote>

<h3>"org">Organization</h3>

Cette spécification est divisée en deux sections. La première section, Summary, couvre les concepts de mise en forme de base. Cette section est destinée aux utilisateurs qui souhaitent commencer rapidement et qui sont familiarisés avec l’impression mise en forme dans d’autres langages de programmation. La deuxième section, Details, couvre les détails spécifiques de l’implémentation. Il est destiné aux utilisateurs qui souhaitent une spécification plus précise du comportement de mise en forme.

<h3>"summary">Summary</h3>

Cette section est destinée à fournir une brève vue d’ensemble des concepts de mise en forme. Pour obtenir des détails comportementaux précis, reportez-vous à la section Détails.

<h4>"syntax">Format String Syntax</h4>

Chaque méthode qui produit une sortie mise en forme nécessite une chaîne de format et une liste d’arguments. La chaîne de format est une String chaîne qui peut contenir du texte fixe et un ou plusieurs spécificateurs de format incorporés. Prenons l’exemple suivant :

<blockquote>

Calendar c = ...;
              String s = String.format("Duke's Birthday: %1$tm %1$te,%1$tY", c);

</blockquote>

Cette chaîne de format est le premier argument de la format méthode. Il contient trois spécificateurs de format «%1$tm », «%1$te » et «%1$tY », qui indiquent comment les arguments doivent être traités et où ils doivent être insérés dans le texte. Les parties restantes de la chaîne de format sont du texte fixe, y compris "Dukes Birthday: " et tout autre espace ou ponctuation.

La liste d’arguments se compose de tous les arguments passés à la méthode après la chaîne de format. Dans l’exemple ci-dessus, la liste d’arguments est de taille 1 et se compose de l’objet java.util.Calendar Calendarc.

<ul>

<li> Les spécificateurs de format pour les types généraux, caractères et numériques ont la syntaxe suivante :

<blockquote>

%[argument_index$][flags][width][.precision]conversion

</blockquote>

Le argument_index facultatif est un entier décimal indiquant la position de l’argument dans la liste d’arguments. Le premier argument est référencé par «1$ », le second par «2$ », etc.

Les indicateurs facultatifs sont un ensemble de caractères qui modifient le format de sortie. L’ensemble d’indicateurs valides dépend de la conversion.

La largeur facultative est un entier décimal positif indiquant le nombre minimal de caractères à écrire dans la sortie.

La précision facultative est un entier décimal non négatif généralement utilisé pour limiter le nombre de caractères. Le comportement spécifique dépend de la conversion.

La conversion requise est un caractère indiquant comment l’argument doit être mis en forme. L’ensemble de conversions valides pour un argument donné dépend du type de données de l’argument.

<li> Les spécificateurs de format pour les types utilisés pour représenter des dates et des heures ont la syntaxe suivante :

<blockquote>

%[argument_index$][flags][width]conversion

</blockquote>

Les argument_index, indicateurs et largeur facultatifs sont définis comme ci-dessus.

La conversion requise est une séquence de deux caractères. Le premier caractère est 't' ou 'T'. Le deuxième caractère indique le format à utiliser. Ces caractères sont similaires mais pas complètement identiques à ceux définis par GNU date et POSIX strftime(3c).

<li> Les spécificateurs de format qui ne correspondent pas aux arguments ont la syntaxe suivante :

<blockquote>

%[flags][width]conversion

</blockquote>

Les indicateurs facultatifset la largeur sont définis comme ci-dessus.

La conversion requise est un caractère indiquant le contenu à insérer dans la sortie.

</ul>

<Conversions <h4> /h4>

Les conversions sont divisées en catégories suivantes :

<ol>

<li><b>General</b> - peut être appliqué à n’importe quel type d’argument

<li><b>Character</b> : peut être appliqué aux types de base qui représentent des caractères Unicode : char, , Character, byte, Byte, short, et Short. Cette conversion peut également être appliquée aux types int et quand elle Character#isValidCodePoint retourne true<li><b>Numeric<Integer/b>

<ol>

<li>b Integral/b> - peut être appliqué aux types intégraux Java : byte, , Byte, intShortshort, et longInteger, , Longet java.math.BigInteger BigInteger (mais pas char ou Character)<><

<li><b>Virgule< flottante/b> - peut être appliqué aux types à virgule flottante Java : float, , Float, double, Doubleet java.math.BigDecimal BigDecimal</ol>

<li>b Date/Heure</b> - peut être appliqué aux types Java capables d’encoder une date ou une heure : long, Long, DateCalendaret TemporalAccessor TemporalAccessor<li><b>Percent</b> - produit un littéral '%' ()'&#92;u0025'><

<li><b>Line Separator</b> : produit le séparateur de ligne spécifique à la plateforme

</ol>

Pour la catégorie General, Character, Numberic, Integral and Date/Time conversion, sauf indication contraire, si l’argument arg est null, le résultat est «null ».

Le tableau suivant récapitule les conversions prises en charge. Les conversions indiquées par un caractère majuscule (c’est-à-dire'B', , , 'S''H', 'E''X''C', , 'G', , 'A', et 'T') sont identiques à celles des caractères de conversion minuscules correspondants, sauf que le résultat est converti en majuscules en majuscules en fonction des règles de la situation dominantejava.util.Locale Locale. S’il n’existe aucun paramètre régional explicite spécifié, soit à la construction de l’instance, soit en tant que paramètre pour son appel de méthode, il java.util.Locale.Category#FORMAT default locale est utilisé.

<table class="striped">caption style="display :none">genConv</caption><thead><tr><th scope="col » style="vertical-align :bottom »> Conversion <th scope="col » style="vertical-align :bottom » Argument Category <th scope="col » style="vertical-align :bottom »> Description </thead><tbody><tr><th scope="row » style="vertical-align :top »>>'b', 'B'<td style="vertical-align :top »<> général <td> Si l’argument arg est null, le résultat est «false ». Si arg est un boolean ou Boolean, le résultat est la chaîne retournée par String#valueOf(boolean) String.valueOf(arg). Sinon, le résultat est « true ».

<tr><th scope="row » style="vertical-align :top »>'h',<'H' td style="vertical-align :top »> general <td> Le résultat est obtenu en appelant Integer.toHexString(arg.hashCode()).

<tr><th scope="row » style="vertical-align :top »'s'>,<'S' td style="vertical-align :top »> general <td> If arg implémenteFormattable, puis Formattable#formatTo arg.formatTo est appelé. Sinon, le résultat est obtenu en appelant arg.toString().

<tr><th scope="row » style="vertical-align :top »>'c', 'C'<td style="vertical-align :top »> caractère <td> Le résultat est un caractère Unicode

<tr><th scope="row » style="vertical-align :top"><'d'td style="vertical-align :top »> intégrale <td> Le résultat est mis en forme sous forme d’entier décimal

<tr><th scope="row » style="vertical-align :top"><'o'td style="vertical-align :top »> intégrale <td> Le résultat est mis en forme sous forme d’entier octal

<tr><th scope="row » style="vertical-align :top »>'x', 'X'<td style="vertical-align :top »> intégrale <td> Le résultat est mis en forme en tant qu’entier hexadécimal

<tr><th scope="row » style="vertical-align :top »'e'>,<'E' td style="vertical-align :top »><td> Le résultat est mis en forme comme nombre décimal dans la notation scientifique informatisée

<tr><th scope="row » style="vertical-align :top"><'f'td style="vertical-align :top »> en virgule <flottante td> Le résultat est mis en forme comme nombre décimal

<tr><th scope="row » style="vertical-align :top »'g'>,<'G' td style="vertical-align :top »><td> Le résultat est mis en forme à l’aide de la notation scientifique informatisée ou du format décimal, en fonction de la précision et de la valeur après l’arrondi.

<tr><th scope="row » style="vertical-align :top »'a'>,<'A' td style="vertical-align :top »><td> Le résultat est mis en forme sous forme de nombre à virgule flottante hexadécimale avec un significand et un exposant. Cette conversion n’est <pas< prise en charge par b>/b> pour le BigDecimal type malgré le fait qu’elle se trouve dans la catégorie d’argument à virgule flottante.

<tr><th scope="row » style="vertical-align :top »>'t', 'T'<td style="vertical-align :top »> date/heure <td> Préfixe pour les caractères de conversion de date et d’heure. Consultez les conversions de date/heure.

<tr><th scope="row » style="vertical-align :top"'%'><td style="vertical-align :top »> percent <td> Le résultat est un littéral '%' ()'&#92;u0025'

<tr><th scope="row » style="vertical-align :top"><'n'td style="vertical-align :top »> line séparateur <td> Le résultat est le séparateur de ligne spécifique à la plateforme

</tbody></table>

Tous les caractères non définis explicitement comme des conversions sont illégals et sont réservés aux extensions futures.

<h4>"dt">Conversions< de date/heure/h4>

Les caractères de suffixe de conversion de date et d’heure suivants sont définis pour les conversions et 'T' les 't' conversions. Les types sont similaires mais pas complètement identiques à ceux définis par GNU date et POSIX strftime(3c). Des types de conversion supplémentaires sont fournis pour accéder aux fonctionnalités spécifiques à Java (par exemple 'L' , pour les millisecondes au cours de la seconde).

Les caractères de conversion suivants sont utilisés pour la mise en forme des heures :

<table class="striped"><caption style="display :none">time</caption><tbody><tr><th scope="row » style="vertical-align :top"<>'H'td> Hour of the day pour l’horloge de 24 heures, mis en forme comme deux chiffres avec un zéro non significatif si nécessaire, c’est-à-dire . 00 - 23

<tr><th scope="row » style="vertical-align :top"><'I'td> Hour pour l’horloge de 12 heures, mise en forme sous forme de deux chiffres avec un zéro non significatif si nécessaire, c’est-à-dire . 01 - 12

<tr><th scope="row » style="vertical-align :top"><'k'td> Hour of the day for the 24-hour clock, i.e. . 0 - 23

<tr><th scope="row » style="vertical-align :top"><'l'td> Hour pour l’horloge de 12 heures, c’est-à-dire . 1 - 12

<tr><th scope="row » style="vertical-align :top"><'M'td> Minute dans l’heure mise en forme sous forme de deux chiffres avec un zéro non significatif si nécessaire, c’est-à-dire . 00 - 59

<tr><th scope="row » style="vertical-align :top"'S'<>td> Seconds dans la minute, mis en forme sous la forme de deux chiffres avec un zéro non significatif si nécessaire, c’est-à-dire 00 - 60 (« 60 » est une valeur spéciale nécessaire pour prendre en charge les secondes de saut).

<tr><th scope="row » style="vertical-align :top"><'L'td> Millisecond in the second formatted as three digits with leading zeros as necessary, i.e. . 000 - 999

<tr><th scope="row » style="vertical-align :top"><'N'td> Nanosecond dans le second, mis en forme comme neuf chiffres avec des zéros non significatifs si nécessaire, c’est-à-dire . 000000000 - 999999999

<tr><th scope="row » style="vertical-align :top"><'p'td> Locale-specific java.text.DateFormatSymbols#getAmPmStrings morning or afternoon marker in minuscules, par exemple. »am ou «pm ». L’utilisation du préfixe 'T' de conversion force cette sortie en majuscules.

<tr><th scope="row » style="vertical-align :top"'z'<>td>RFC 822 style timezone offset from GMT, par exemple . -0800 Cette valeur sera ajustée si nécessaire pour l’heure d’été. Pour long, Longet Date le fuseau horaire utilisé est le fuseau horaire timeZone#getDefault() par défaut pour cette instance de la machine virtuelle Java.

<tr><th scope="row » style="vertical-align :top"<>'Z'td> Une chaîne représentant l’abréviation du fuseau horaire. Cette valeur sera ajustée si nécessaire pour l’heure d’été. Pour long, Longet Date le fuseau horaire utilisé est le fuseau horaire timeZone#getDefault() par défaut pour cette instance de la machine virtuelle Java. Les paramètres régionaux du formateur remplacent les paramètres régionaux de l’argument (le cas échéant).

<tr><th scope="row » style="vertical-align :top"'s'><td> Seconds depuis le début de l’époque à partir du 1er janvier 1970 00:00:00 UTC, c’est-à-dire Long.MIN_VALUE/1000 à .Long.MAX_VALUE/1000

<tr><th scope="row » style="vertical-align :top"'Q'><td> Milliseconds depuis le début de l’époque à partir du 1er janvier 1970 00:00:00 UTC, c’est-à-dire Long.MIN_VALUE à .Long.MAX_VALUE

</tbody></table>

Les caractères de conversion suivants sont utilisés pour la mise en forme des dates :

<table class="striped"><caption style="display :none">date</caption><tbody>

<tr><th scope="row » style="vertical-align :top"'B'<>td> Locale-specific java.text.DateFormatSymbols#getMonths full month name, par exemple "January", . "February"

<tr><th scope="row » style="vertical-align :top"'b'<>td> Locale-specific java.text.DateFormatSymbols#getShortMonths abrégé month name, par exemple "Jan", . "Feb"

<tr><th scope="row » style="vertical-align :top"><'h'td> Identique à .'b'

<tr><th scope="row » style="vertical-align :top"'A'<>td> Locale-specific full name of the java.text.DateFormatSymbols#getWeekdays day of the week, par exemple"Sunday",<"Monday" tr><th scope="row » style="vertical-align :top"'a'><td> Locale-specific short name of the java.text.DateFormatSymbols#getShortWeekdays day of the week, par exemple"Sun", "Mon"<tr><th scope="row » style="vertical-align :top"'C'<>td> Four-digit year divisé par 100, mis en forme comme deux chiffres avec zéro non significatif si nécessaire, c’est-à-dire tr th scope="row » style="vertical-align :top"'Y'<>td> Year, mis en forme comme au moins quatre chiffres avec des zéros non significatifs si nécessaire, par exemple0092, correspond à 92 CE pour le calendrier grégorien.><00 - 99<

<tr><th scope="row » style="vertical-align :top"><'y'td> Les deux derniers chiffres de l’année, mis en forme avec des zéros non significatifs si nécessaire, c’est-à-dire . 00 - 99

<tr><th scope="row » style="vertical-align :top"><'j'td> Day of year, mis en forme comme trois chiffres avec des zéros non significatifs si nécessaire, par exemple 001 - 366 pour le calendrier grégorien.

<tr><th scope="row » style="vertical-align :top"><'m'td> Month, mis en forme comme deux chiffres avec des zéros non significatifs si nécessaire, c’est-à-dire . 01 - 13

<tr><th scope="row » style="vertical-align :top"<>'d'td> Day of month, mis en forme comme deux chiffres avec des zéros non significatifs si nécessaire, c’est-à-dire<01 - 31 tr><tr th scope="row » style="vertical-align :top"'e'<>td> Day of month, mis en forme comme deux chiffres, c’est-à-dire . 1 - 31

</tbody></table>

Les caractères de conversion suivants sont utilisés pour mettre en forme des compositions de date/heure communes.

<table class="striped"><caption style="display :none">composites</caption><tbody>

<tr><th scope="row » style="vertical-align :top"<'R'>td> Time formatted for the 24-hour clock as "%tH:%tM"<tr><th scope="row » style="vertical-align :top"'T'<>td> Time formatted for the 24-hour clock as ."%tH:%tM:%tS"

<tr><th scope="row » style="vertical-align :top"><'r'td> Time mis en forme pour l’horloge de 12 heures comme ."%tI:%tM:%tS %Tp" L’emplacement du marqueur du matin ou de l’après-midi ('%Tp') peut être dépendant des paramètres régionaux.

<tr><th scope="row » style="vertical-align :top"><'D'td> Date mis en forme comme ."%tm/%td/%ty"

<tr><th scope="row » style="vertical-align :top"'F'<>td>ISO 8601 date complète mise en forme comme ."%tY-%tm-%td"

<tr><th scope="row » style="vertical-align :top"'c'<>td> Date et heure mises en forme comme "%ta %tb %td %tT %tZ %tY", par exemple . "Sun Jul 20 16:17:00 EDT 1969"

</tbody></table>

Tous les caractères qui ne sont pas explicitement définis comme suffixes de conversion de date/heure ne sont pas valides et sont réservés aux extensions ultérieures.

<Indicateurs <h4> /h4>

Le tableau suivant récapitule les indicateurs pris en charge. y signifie que l’indicateur est pris en charge pour les types d’arguments indiqués.

<table class="striped"><caption style="display :none">genConv</caption><thead><tr><th scope="col » style="vertical-align :bottom »> Indicateur <th scope="col » style="vertical-align :bottom »> General <th scope="col » style="vertical-align :bottom » Caractère <th scope="col » style="vertical-align :bottom »> Intégrale <th scope="col » style="vertical-align :bottom »>> Virgule flottante <th scope="col » style= » vertical-align :bottom »> Date/Heure <th scope="col » style="vertical-align :bottom »> Description </thead<>tbody<>tr><th scope="row »> '-' <td style="text-align :center ; vertical-align :top »> y <td style="text-align :center ; vertical-align :top »> y <td style="text-align :center ; vertical-align :top »> y <td style="text-align :center ; vertical-align :top »> y <td style="text-align :center ; vertical-align :top"> y <td> Le résultat sera justifié à gauche.

<tr><th scope="row »> '#' <td style="text-align :center ; vertical-align :top »> y<sup>1</sup<>td style="text-align :center ; vertical-align :top »> - <td style="text-align :center ; vertical-align :top »> y<sup>3</sup<>td style="text-align :center ; vertical-align :top »> y <td style="text-align :center ; vertical-align :top »> - <td> Le résultat doit utiliser un autre formulaire dépendant de la conversion

<tr><th scope="row »> '+' <td style="text-align :center ; vertical-align :top »> - <td style="text-align :center ; vertical-align :top »> - <td style="text-align :center ; vertical-align :top »> y<sup>4</sup><td style="text-align :center ; vertical-align :top »> y <td style="text-align :center ; vertical-align :top »> - <td> Le résultat inclut toujours un signe

<tr><th scope="row »> '  ;   ;' <td style="text-align :center ; vertical-align :top »> - <td style="text-align :center ; vertical-align :top »> - <td style="text-align :center ; vertical-align :top »> y<sup>4</sup><td style="text-align :center ; vertical-align :top »> y <td style="text-align :center ; vertical-align :top »> - <Td> Le résultat inclut un espace de début pour les valeurs positives

<tr><th scope="row » '0'><td style="text-align :center ; vertical-align :top »> - <td style="text-align :center ; vertical-align :top »> - <td style="text-align :center ; vertical-align :top »> y <td style="text-align :center ; vertical-align :top »> y <td style="text-align :center ; vertical-align :top ; vertical-align :top »> - <td> Le résultat sera nul

<tr><th scope="row »> ',' <td style="text-align :center ; vertical-align :top »> - <td style="text-align :center ; vertical-align :top »> - <td style="text-align :center ; vertical-align :top » y<sup>2</sup><td style="text-align :center ; vertical-align :top »> y<sup>5</sup<>td style="text-align :center ; vertical-align :top »>> - td>< Le résultat inclut java.text.DecimalFormatSymbols#getGroupingSeparator grouping tr th scope="row »> '(' <td style="text-align :center ; vertical-align :top »> - <td style="text-align :center ; vertical-align :top »> - <td style="text-align :center ; vertical-align :top »> y<sup>4</sup<>td style="text-align :center ; vertical-align :top »> y<sup>5</sup><td><< style="text-align :center » -><td> Le résultat place les nombres négatifs entre parenthèses

</tbody></table>

<sup>1/sup> Dépend de la définition de Formattable<.

<sup>2</sup> pour 'd' la conversion uniquement.

<sup>3</sup> Pour 'o', 'x'et 'X' conversions uniquement.

<sup>4/sup> For 'd', 'o', , 'x'et 'X' conversions appliquées à java.math.BigInteger BigIntegerbyte'd' , Byte, short, intShort, et , longet IntegerLong.<

<sup>5</sup> Pour 'e', 'E', 'f', , 'g'et 'G' conversions uniquement.

Les caractères qui ne sont pas explicitement définis en tant qu’indicateurs ne sont pas valides et sont réservés aux extensions futures.

<largeur <h4> /h4>

La largeur correspond au nombre minimal de caractères à écrire dans la sortie. Pour la conversion du séparateur de trait, la largeur n’est pas applicable ; si elle est fournie, une exception est levée.

<précision <h4> /h4>

Pour les types d’arguments généraux, la précision est le nombre maximal de caractères à écrire dans la sortie.

Pour les conversions 'a'à virgule flottante , , 'A''e', 'E'et 'f' la précision est le nombre de chiffres après le point radix. Si la conversion est 'g' ou 'G', la précision est le nombre total de chiffres dans la magnitude résultante après l’arrondi.

Pour les types d’arguments caractère, intégral et date/heure et les conversions de séparateur de pourcentage et de trait, la précision n’est pas applicable ; si une précision est fournie, une exception est levée.

<Index <d’argument h4> /h4>

L’index d’argument est un entier décimal indiquant la position de l’argument dans la liste d’arguments. Le premier argument est référencé par «1$ », le second par «2$ », etc.

Une autre façon de référencer des arguments par position consiste à utiliser l’indicateur '<' ('&#92;u003c'), ce qui entraîne la réutilisation de l’argument du spécificateur de format précédent. Par exemple, les deux instructions suivantes produisent des chaînes identiques :

<blockquote>

Calendar c = ...;
              String s1 = String.format("Duke's Birthday: %1$tm %1$te,%1$tY", c);

              String s2 = String.format("Duke's Birthday: %1$tm %&lt;te,%&lt;tY", c);

</blockquote>

<hr><h3>"detail">Details</h3>

Cette section est destinée à fournir des détails comportementaux pour la mise en forme, notamment les conditions et les exceptions, les types de données pris en charge, la localisation et les interactions entre les indicateurs, les conversions et les types de données. Pour obtenir une vue d’ensemble des concepts de mise en forme, reportez-vous au résumé

Les caractères qui ne sont pas explicitement définis comme conversions, suffixes de conversion date/heure ou indicateurs ne sont pas valides et sont réservés aux futures extensions. L’utilisation d’un tel caractère dans une chaîne de format entraîne une UnknownFormatConversionException levée ou UnknownFormatFlagsException une levée.

Si le spécificateur de format contient une largeur ou une précision avec une valeur non valide ou qui n’est pas prise en charge, une IllegalFormatWidthException ou IllegalFormatPrecisionException respectivement sera levée.

Si un spécificateur de format contient un caractère de conversion qui n’est pas applicable à l’argument correspondant, une IllegalFormatConversionException exception est levée.

Toutes les exceptions spécifiées peuvent être levées par l’une format des méthodes de Formatter , ainsi que par toutes format les méthodes pratiques telles que String#format(String,Object...) String.format et java.io.PrintStream#printf(String,Object...) PrintStream.printf.

Pour la catégorie General, Character, Numberic, Integral and Date/Time conversion, sauf indication contraire, si l’argument arg est null, le résultat est «null ».

Les conversions indiquées par un caractère majuscule (c’est-à-dire'B', , , 'S''H', 'E''X''C', , 'G', , 'A', et 'T') sont identiques à celles des caractères de conversion minuscules correspondants, sauf que le résultat est converti en majuscules en majuscules en fonction des règles de la situation dominantejava.util.Locale Locale. S’il n’existe aucun paramètre régional explicite spécifié, soit à la construction de l’instance, soit en tant que paramètre pour son appel de méthode, il java.util.Locale.Category#FORMAT default locale est utilisé.

<h4>"dgen">General</h4>

Les conversions générales suivantes peuvent être appliquées à n’importe quel type d’argument :

<table class="striped"><caption style="display :none">dgConv</caption><tbody>

<tr><th scope="row » style="vertical-align :top"<'b'>td style="vertical-align :top"'&#92;u0062'><td> Produit « true » ou « false » comme retourné par .Boolean#toString(boolean)

Si l’argument est null, le résultat est «false ». Si l’argument est un boolean ou Boolean, le résultat est la chaîne retournée par String#valueOf(boolean) String.valueOf(). Sinon, le résultat est «true ».

Si l’indicateur '#' est donné, une FormatFlagsConversionMismatchException exception est levée.

<tr><th scope="row » style="vertical-align :top">'B'<td style="vertical-align :top"td"'&#92;u0042'<>td> La variante majuscule de .'b'

<tr><th scope="row » style="vertical-align :top">'h'<td style="vertical-align :top"'&#92;u0068'><td"td> Produit une chaîne représentant la valeur du code de hachage de l’objet.

Le résultat est obtenu en appelant Integer.toHexString(arg.hashCode()).

Si l’indicateur '#' est donné, une FormatFlagsConversionMismatchException exception est levée.

<tr><th scope="row » style="vertical-align :top">'H'<td style="vertical-align :top"td"'&#92;u0048'<>td> La variante majuscule de .'h'

<tr><th scope="row » style="vertical-align :top">'s'<td style="vertical-align :top"'&#92;u0073'><td"td> Produit une chaîne.

Si l’argument implémente Formattable, sa Formattable#formatTo formatTo méthode est appelée. Sinon, le résultat est obtenu en appelant la méthode de l’argument toString() .

Si l’indicateur est donné et que l’argument '#' n’est pas un Formattable , un FormatFlagsConversionMismatchException sera levée.

<tr><th scope="row » style="vertical-align :top">'S'<td style="vertical-align :top"td"'&#92;u0053'<>td> La variante majuscule de .'s'

</tbody></table>

Les indicateurs « dFlags »> suivants s’appliquent aux conversions générales :

<table class="striped"><caption style="display :none">dFlags</caption><tbody>

<tr><th scope="row » style="vertical-align :top"><'-'td style="vertical-align :top"td> Left>'&#92;u002d'< justifie la sortie. Les espaces ('&#92;u0020') sont ajoutés à la fin de la valeur convertie selon les besoins pour remplir la largeur minimale du champ. Si la largeur n’est pas fournie, une MissingFormatWidthException levée est levée. Si cet indicateur n’est pas donné, la sortie est justifiée à droite.

<tr><th scope="row » style="vertical-align :top">'#'<td style="vertical-align :top"'&#92;u0023'><td> Nécessite que la sortie utilise un autre formulaire. La définition du formulaire est spécifiée par la conversion.

</tbody></table>

La largeur « genWidth »> est le nombre minimal de caractères à écrire dans la sortie. Si la longueur de la valeur convertie est inférieure à la largeur, la sortie est complétée par '&nbsp;&nbsp;' ('&#92;u0020') jusqu’à ce que le nombre total de caractères soit égal à la largeur. Le remplissage se trouve à gauche par défaut. Si l’indicateur '-' est donné, le remplissage est à droite. Si la largeur n’est pas spécifiée, il n’y a pas de minimum.

La précision est le nombre maximal de caractères à écrire dans la sortie. La précision est appliquée avant la largeur. La sortie est donc tronquée en precision caractères même si la largeur est supérieure à la précision. Si la précision n’est pas spécifiée, il n’existe aucune limite explicite sur le nombre de caractères.

<h4>"dchar">Character</h4>

Cette conversion peut être appliquée à char et Character. Elle peut également être appliquée aux types byte, Byte, shortet ShortIntegerint quand Character#isValidCodePoint elle est retournée .true Si elle retourne false , une IllegalFormatCodePointException exception est levée.

<table class="striped"><caption style="display :none">charConv</caption><tbody>

<tr><th scope="row » style="vertical-align :top">'c'<td style="vertical-align :top"'&#92;u0063'><td> Met l’argument en tant que caractère Unicode comme décrit dans La représentation de caractères Unicode. Il peut s’agir de plusieurs 16 bits char dans le cas où l’argument représente un caractère supplémentaire.

Si l’indicateur '#' est donné, une FormatFlagsConversionMismatchException exception est levée.

<tr><th scope="row » style="vertical-align :top">'C'<td style="vertical-align :top"td"'&#92;u0043'<>td> La variante majuscule de .'c'

</tbody></table>

L’indicateur '-' défini pour les conversions générales s’applique. Si l’indicateur '#' est donné, une FormatFlagsConversionMismatchException exception est levée.

La largeur est définie comme pour les conversions générales.

La précision n’est pas applicable. Si la précision est spécifiée, une IllegalFormatPrecisionException valeur est levée.

<h4>"dnum">Numeric</h4>

Les conversions numériques sont divisées en catégories suivantes :

<ol>

<li>b Byte, Short, Integer et Long</b li><b><>BigInteger</b li<>b><>Float et Double</b li<>b>><BigDecimal</b></ol><>

Les types numériques seront mis en forme en fonction de l’algorithme suivant :

<b>"L10nAlgorithm »> Number Localization Algorithm</b>

Une fois les chiffres obtenus pour la partie entière, la partie fractionnaire et l’exposant (le cas échéant pour le type de données), la transformation suivante est appliquée :

<ol>

<li> Chaque caractère numérique de la chaîne est remplacé par un chiffre spécifique aux paramètres régionaux calculés par rapport à la valeur java.text.DecimalFormatSymbols#getZeroDigit() zéro chiffrez ; qui est d  ;-  ;'0'  ;+  ; z.

<li> Si un séparateur décimal est présent, un séparateur décimal spécifique à java.text.DecimalFormatSymbols#getDecimalSeparator est substitué.

<li> If the ',' ('&#92;u002c') « L10nGroup">flag is given, the locale-specific java.text.DecimalFormatSymbols#getGroupingSeparator grouping séparateur is inserted by scan the integer part of the string from least significant to most significatives digits and inserting a séparateur at intervals defined by the locale’s java.text.DecimalFormat#getGroupingSize().

<li> If the '0' flag is given, the locale-specific java.text.DecimalFormatSymbols#getZeroDigit() zero digits are inserted after the sign character, if any, and before the first non-zero digit, until the length of the string is equal to the requested field width.

<li> Si la valeur est négative et que l’indicateur '(' est donné, un '(' ('&#92;u0028') est ajouté et un ')' ('&#92;u0029') est ajouté.

<li> Si la valeur est négative (ou zéro négatif à virgule flottante) et '(' que l’indicateur n’est pas donné, un '-' ('&#92;u002d') est précédé.

<li> Si l’indicateur est donné et que la '+' valeur est positive ou zéro (ou zéro positif à virgule flottante), un '+' ('&#92;u002b') sera précédé.

</ol>

Si la valeur est NaN ou l’infini positif, les chaînes littérales « NaN » ou « Infini » respectivement sont générées. Si la valeur est l’infini négatif, la sortie est « (Infini) » si l’indicateur '(' est donné sinon la sortie est « -Infini ». Ces valeurs ne sont pas localisées.

« dnint"><b> Byte, Short, Integer et Long </b>

Les conversions suivantes peuvent être appliquées à byte, , Byteshort, intShortet Integerlong, et Long.

<table class="striped"><caption style="display :none">IntConv</caption><tbody>

<tr><th scope="row » style="vertical-align :top">'d'<td style="vertical-align :top"'&#92;u0064'><td> Met l’argument en tant qu’entier décimal. L’algorithme de localisation est appliqué.

Si l’indicateur '0' est donné et que la valeur est négative, le remplissage zéro se produit après le signe.

Si l’indicateur '#' est donné, un FormatFlagsConversionMismatchException sera levée.

<tr><th scope="row » style="vertical-align :top">'o'<td style="vertical-align :top"'&#92;u006f'><td> Met l’argument en tant qu’entier en base huit. Aucune localisation n’est appliquée.

Si x est négatif, le résultat est une valeur non signée générée en ajoutant 2<sup>n</sup> à la valeur où n correspond le nombre de bits du type retourné par le champ statique SIZE dans l’octet#SIZE Byte, Short#SIZE Short, Integer#SIZE Integer ou Long#SIZE Long classes comme il convient.

Si l’indicateur '#' est donné, la sortie commence toujours par l’indicateur '0'radix.

Si l’indicateur '0' est donné, la sortie est complétée par des zéros non significatifs à la largeur du champ en suivant n’importe quelle indication de signe.

Si '(', '+''  ;   ;', ou ',' les indicateurs sont donnés alors une FormatFlagsConversionMismatchException levée sera levée.

<tr><th scope="row » style="vertical-align :top">'x'<td style="vertical-align :top"'&#92;u0078'><td> Met l’argument en tant qu’entier en base seize. Aucune localisation n’est appliquée.

Si x est négatif, le résultat est une valeur non signée générée en ajoutant 2<sup>n</sup> à la valeur où n correspond le nombre de bits du type retourné par le champ statique SIZE dans l’octet#SIZE Byte, Short#SIZE Short, Integer#SIZE Integer ou Long#SIZE Long classes comme il convient.

Si l’indicateur '#' est donné, la sortie commence toujours par l’indicateur "0x"radix.

Si l’indicateur '0' est donné, la sortie est rembourrée à la largeur du champ avec des zéros de début après l’indicateur ou le signe radix (le cas échéant).

Si '(', , '&nbsp;&nbsp;'ou '+'',' indicateurs sont donnés, un FormatFlagsConversionMismatchException sera levée.

<tr><th scope="row » style="vertical-align :top">'X'<td style="vertical-align :top"td"'&#92;u0058'<>td> La variante majuscule de .'x' La chaîne entière représentant le nombre sera convertie en majuscules String#toUpperCase, y compris les 'x' chiffres hexadécimaux (le cas échéant) et tous les chiffres'f' - 'a' hexadécimaux ().'&#92;u0061' - '&#92;u0066'

</tbody></table>

Si la conversion est 'o', 'x'ou 'X' et les deux et les '#''0' indicateurs sont donnés, le résultat contient l’indicateur radix ('0' pour octal et "0x" ou "0X" pour hexadécimal), un certain nombre de zéros (en fonction de la largeur) et la valeur.

Si l’indicateur '-' n’est pas donné, le remplissage de l’espace se produit avant le signe.

Les indicateurs « intFlags »> suivants s’appliquent aux conversions intégrales numériques :

<table class="striped"><caption style="display :none">intFlags</caption><tbody>

<tr><th scope="row » style="vertical-align :top">'+'<td style="vertical-align :top"'&#92;u002b'><td> Nécessite que la sortie inclue un signe positif pour tous les nombres positifs. Si cet indicateur n’est pas donné, seules les valeurs négatives incluent un signe.

Si les indicateurs et '&nbsp;&nbsp;' les '+' indicateurs sont donnés, un IllegalFormatFlagsException sera levée.

<tr><th scope="row » style="vertical-align :top"'&nbsp;&nbsp;'><td style="vertical-align :top"'&#92;u0020'<>td> Nécessite que la sortie inclue un espace supplémentaire unique ('&#92;u0020') pour les valeurs non négatives.

Si les indicateurs et '&nbsp;&nbsp;' les '+' indicateurs sont donnés, un IllegalFormatFlagsException sera levée.

<tr><th scope="row » style="vertical-align :top">'0'<td style="vertical-align :top"'&#92;u0030'><td> Nécessite que la sortie soit rembourrée avec java.text.DecimalFormatSymbols#getZeroDigit zéros en largeur de champ minimale à la suite d’un signe ou d’un indicateur radix, sauf lors de la conversion de NaN ou d’infini. Si la largeur n’est pas fournie, une MissingFormatWidthException levée est levée.

Si les indicateurs et '0' les '-' indicateurs sont donnés, un IllegalFormatFlagsException sera levée.

<tr><th scope="row » style="vertical-align :top">','<td style="vertical-align :top"'&#92;u002c'><td> Nécessite que la sortie inclue les séparateurs de groupes java.text.DecimalFormatSymbols#getGroupingSeparator, comme décrit dans la section « group » de l’algorithme de localisation.

<tr><th scope="row » style="vertical-align :top"'('<>td style="vertical-align :top">'&#92;u0028'<td> Nécessite que la sortie précède un '(' ('&#92;u0028') et ajoute un ')' ('&#92;u0029') à des valeurs négatives.

</tbody></table>

Si aucun indicateur « intdFlags »> n’est spécifié, la mise en forme par défaut est la suivante :

<ul>

<li> La sortie est justifiée à droite dans les width<nombres négatifs li> commençant par un '-' ('&#92;u002d')

<les nombres positifs> et zéro n’incluent pas de signe ou d’espace de début supplémentaire

<Les séparateurs li> No grouping sont inclus

</ul>

La largeur « intWidth »> est le nombre minimal de caractères à écrire dans la sortie. Cela inclut tous les signes, chiffres, séparateurs de regroupement, indicateur radix et parenthèses. Si la longueur de la valeur convertie est inférieure à la largeur, la sortie est complétée par des espaces ('&#92;u0020') jusqu’à ce que le nombre total de caractères soit égal à la largeur. Le remplissage se trouve à gauche par défaut. Si '-' l’indicateur est donné, le remplissage sera à droite. Si la largeur n’est pas spécifiée, il n’y a pas de minimum.

La précision n’est pas applicable. Si la précision est spécifiée, une IllegalFormatPrecisionException exception est levée.

« dnbint"><b> BigInteger </b>

Les conversions suivantes peuvent être appliquées à java.math.BigInteger.

<table class="striped"><caption style="display :none">bIntConv</caption><tbody>

<tr><th scope="row » style="vertical-align :top">'d'<td style="vertical-align :top"'&#92;u0064'><td> Nécessite que la sortie soit mise en forme sous forme d’entier décimal. L’algorithme de localisation est appliqué.

Si l’indicateur '#' est donné FormatFlagsConversionMismatchException , il est levée.

<tr><th scope="row » style="vertical-align :top">'o'<td style="vertical-align :top"'&#92;u006f'><td> Nécessite que la sortie soit mise en forme sous forme d’entier en base huit. Aucune localisation n’est appliquée.

Si x est négatif, le résultat est une valeur signée commençant par '-' ('&#92;u002d'). La sortie signée est autorisée pour ce type, car contrairement aux types primitifs, il n’est pas possible de créer un équivalent non signé sans supposer une taille de type de données explicite.

Si x est positif ou zéro et que l’indicateur '+' est donné, le résultat commence par '+' ('&#92;u002b').

Si l’indicateur '#' est donné, la sortie commence toujours par '0' le préfixe.

Si l’indicateur '0' est donné, la sortie est complétée par des zéros non significatifs à la largeur du champ en suivant n’importe quelle indication de signe.

Si l’indicateur ',' est donné, un FormatFlagsConversionMismatchException sera levée.

<tr><th scope="row » style="vertical-align :top">'x'<td style="vertical-align :top"'&#92;u0078'><td"td> Nécessite que la sortie soit mise en forme sous forme d’entier en base seize. Aucune localisation n’est appliquée.

Si x est négatif, le résultat est une valeur signée commençant par '-' ('&#92;u002d'). La sortie signée est autorisée pour ce type, car contrairement aux types primitifs, il n’est pas possible de créer un équivalent non signé sans supposer une taille de type de données explicite.

Si x est positif ou zéro et que l’indicateur '+' est donné, le résultat commence par '+' ('&#92;u002b').

Si l’indicateur '#' est donné, la sortie commence toujours par l’indicateur "0x"radix.

Si l’indicateur '0' est donné, la sortie est rembourrée à la largeur du champ avec des zéros de début après l’indicateur ou le signe radix (le cas échéant).

Si l’indicateur ',' est donné, un FormatFlagsConversionMismatchException sera levée.

<tr><th scope="row » style="vertical-align :top">'X'<td style="vertical-align :top"td"'&#92;u0058'<>td> La variante majuscule de .'x' La chaîne entière représentant le nombre sera convertie en majuscules String#toUpperCase, y compris les 'x' chiffres hexadécimaux (le cas échéant) et tous les chiffres'f' - 'a' hexadécimaux ().'&#92;u0061' - '&#92;u0066'

</tbody></table>

Si la conversion est 'o', 'x'ou 'X' et que les indicateurs et '0' les '#' indicateurs sont donnés, le résultat contient l’indicateur de base ('0' pour octal et "0x" ou "0X" pour hexadécimal), un certain nombre de zéros (en fonction de la largeur) et la valeur.

Si l’indicateur '0' est donné et que la valeur est négative, le remplissage zéro se produit après le signe.

Si l’indicateur '-' n’est pas donné, le remplissage de l’espace se produit avant le signe.

Tous les indicateurs définis pour Byte, Short, Integer et Long s’appliquent. Le comportement par défaut lorsqu’aucun indicateur n’est donné est le même que pour Byte, Short, Integer et Long.

La spécification de la largeur est la même que celle définie pour Byte, Short, Integer et Long.

La précision n’est pas applicable. Si la précision est spécifiée, une IllegalFormatPrecisionException exception est levée.

« dndec"><b> Float et Double</b>

Les conversions suivantes peuvent être appliquées à float, doubleFloatet Double.

<table class="striped"><caption style="display :none">floatConv</caption><tbody>

<tr><th scope="row » style="vertical-align :top"'e'><td style="vertical-align :top"'&#92;u0065'<>td> Nécessite que la sortie soit mise en forme à l’aide de la notation scientifique « scientifique ».> L’algorithme de localisation est appliqué.

La mise en forme du m de magnitude dépend de sa valeur.

Si m est NaN ou infini, les chaînes littérales « NaN » ou « Infini », respectivement, seront sorties. Ces valeurs ne sont pas localisées.

Si m est positif-zéro ou négatif-zéro, l’exposant sera "+00".

Sinon, le résultat est une chaîne qui représente le signe et la magnitude (valeur absolue) de l’argument. La mise en forme du signe est décrite dans l’algorithme de localisation. La mise en forme du m de magnitude dépend de sa valeur.

Laissez n être l’entier unique de sorte que 10<sup>n</sup> <= m < 10<sup>n+1</sup> ; alors laissez un quotient mathématiquement exact de m et 10<sup>n</sup> afin que 1 <= a < 10. La magnitude est ensuite représentée sous la forme d’une partie entière d’un chiffre, sous la forme d’un chiffre décimal unique, suivie du séparateur décimal suivi des chiffres décimaux représentant la partie fractionnaire d’un, suivi de la partie locale minuscule spécifique à java.text.DecimalFormatSymbols#getExponentSeparator séparateur d’exposants (par exemple'e'), suivi du signe de l’exposant, suivi d’une représentation de n comme entier décimal, comme produit par la méthodeLong#toString(long, int), et zéro rembourré pour inclure au moins deux chiffres.

Le nombre de chiffres dans le résultat pour la partie fractionnaire de m ou un est égal à la précision. Si la précision n’est pas spécifiée, la valeur par défaut est 6. Si la précision est inférieure au nombre de chiffres qui s’affichent après le point décimal de la chaîne retournée par Float#toString(float) ou Double#toString(double) respectivement, la valeur est arrondie à l’aide de l’algorithme java.math.RoundingMode#HALF_UP arrondir la moitié de l’algorithme. Sinon, les zéros peuvent être ajoutés pour atteindre la précision. Pour une représentation canonique de la valeur, utilisez Float#toString(float) ou Double#toString(double) le cas échéant.

Si l’indicateur ',' est donné, une FormatFlagsConversionMismatchException exception est levée.

<tr><th scope="row » style="vertical-align :top">'E'<td style="vertical-align :top"td"'&#92;u0045'<>td> La variante majuscule de .'e' Le symbole d’exposant sera le séparateur d’exposants java.text.DecimalFormatSymbols#getExponentSeparator (par exemple 'E').

<tr><th scope="row » style="vertical-align :top">'g'<td style="vertical-align :top"'&#92;u0067'><td> Exige que la sortie soit mise en forme en notation scientifique générale, comme décrit ci-dessous. L’algorithme de localisation est appliqué.

Après l’arrondi pour la précision, la mise en forme du m de magnitude résultant dépend de sa valeur.

Si m est supérieur ou égal à 10<sup-4></sup mais inférieur à 10<sup>> précision</sup>, il est représenté au format décimal.

Si m est inférieur à 10<sup-4></sup> ou supérieur ou égal à 10<sup>précision</sup>, il est représenté en notation scientifique informatisée.

Le nombre total de chiffres significatifs en m est égal à la précision. Si la précision n’est pas spécifiée, la valeur par défaut est 6. Si la précision est 0, alors il est pris pour être 1.

Si l’indicateur '#' est donné, une FormatFlagsConversionMismatchException exception est levée.

<tr><th scope="row » style="vertical-align :top">'G'<td style="vertical-align :top"td"'&#92;u0047'<>td> La variante majuscule de .'g'

<tr><th scope="row » style="vertical-align :top"'f'><td style="vertical-align :top"'&#92;u0066'<>td> Nécessite que la sortie soit mise en forme à l’aide du format décimal.> L’algorithme de localisation est appliqué.

Le résultat est une chaîne qui représente le signe et la magnitude (valeur absolue) de l’argument. La mise en forme du signe est décrite dans l’algorithme de localisation. La mise en forme du m de magnitude dépend de sa valeur.

Si m NaN ou infini, les chaînes littérales « NaN » ou « Infini », respectivement, seront sorties. Ces valeurs ne sont pas localisées.

La magnitude est mise en forme comme partie entière de m, sans zéros non significatifs, suivie du séparateur décimal suivi d’un ou plusieurs chiffres décimaux représentant la partie fractionnaire de m.

Le nombre de chiffres dans le résultat pour la partie fractionnaire de m ou un est égal à la précision. Si la précision n’est pas spécifiée, la valeur par défaut est 6. Si la précision est inférieure au nombre de chiffres qui s’affichent après le point décimal de la chaîne retournée par Float#toString(float) ou Double#toString(double) respectivement, la valeur est arrondie à l’aide de l’algorithme java.math.RoundingMode#HALF_UP arrondir la moitié de l’algorithme. Sinon, les zéros peuvent être ajoutés pour atteindre la précision. Pour une représentation canonique de la valeur, utilisez Float#toString(float) ou Double#toString(double) le cas échéant.

<tr><th scope="row » style="vertical-align :top">'a'<td style="vertical-align :top"'&#92;u0061'><td> Nécessite que la sortie soit mise en forme sous forme exponentielle hexadécimale. Aucune localisation n’est appliquée.

Le résultat est une chaîne qui représente le signe et la magnitude (valeur absolue) de l’argument x.

Si x est négatif ou une valeur négative zéro, le résultat commence par '-' ('&#92;u002d').

Si x est positif ou une valeur positive zéro et que l’indicateur est donné, le '+' résultat commence par '+' ('&#92;u002b').

La mise en forme du m de magnitude dépend de sa valeur.

<ul>

<li> Si la valeur est NaN ou infinie, les chaînes littérales « NaN » ou « Infini », respectivement, seront sorties.

<li> Si m est égal à zéro, il est représenté par la chaîne "0x0.0p0".

<li> If m est une double valeur avec une représentation normalisée, les sous-chaînes sont utilisées pour représenter les champs significand et exposant. Le significand est représenté par les caractères "0x1." suivis de la représentation hexadécimale du reste du significand sous forme de fraction. L’exposant est représenté par 'p' ('&#92;u0070') suivi d’une chaîne décimale de l’exposant non biaisé comme s’il est produit en appelant Integer#toString(int) Integer.toString la valeur d’exposant. Si la précision est spécifiée, la valeur est arrondie au nombre donné de chiffres hexadécimaux.

<li> Si m est une valeur avec une double représentation subnormale, alors, sauf si la précision est spécifiée comme étant comprise entre 1 et 12, inclusive, le significand est représenté par les caractères '0x0.' suivis de la représentation hexadécimale du reste du significand sous forme de fraction, et l’exposant représenté par 'p-1022'. Si la précision est dans l’intervalle [1,  ; 12], la valeur subnormale est normalisée de telle sorte qu’elle commence par les caractères '0x1.', arrondie au nombre de chiffres hexadécimaux de précision et à l’exposant ajusté en conséquence. Notez qu’il doit y avoir au moins un chiffre différent de zéro dans un signe subnormal.

</ul>

Si les '(' indicateurs ',' sont donnés, une FormatFlagsConversionMismatchException exception est levée.

<tr><th scope="row » style="vertical-align :top">'A'<td style="vertical-align :top"td"'&#92;u0041'<>td> La variante majuscule de .'a' La chaîne entière représentant le nombre est convertie en majuscules, y compris les 'x' chiffres ('&#92;u0078') et ('&#92;u0070' et 'p' tous les chiffres'f' - 'a' hexadécimaux ().'&#92;u0061' - '&#92;u0066'

</tbody></table>

Tous les indicateurs définis pour Byte, Short, Integer et Long s’appliquent.

Si l’indicateur '#' est donné, le séparateur décimal est toujours présent.

Si aucun indicateur « floatdFlags »> n’est donné la mise en forme par défaut est la suivante :

<ul>

<li> La sortie est justifiée à droite dans les<width nombres négatifs li> commencent par un '-'<nombre positif li> et zéro positif n’incluent pas un signe ou un espace de début supplémentaire

<Les séparateurs li> No grouping sont inclus

<li> Le séparateur décimal n’apparaît que si un chiffre le suit

</ul>

La largeur « floatDWidth »> est le nombre minimal de caractères à écrire dans la sortie. Cela inclut tous les signes, chiffres, séparateurs de regroupement, séparateurs décimaux, symbole exponentiel, indicateur radix, parenthèses et chaînes représentant l’infini et naN, le cas échéant. Si la longueur de la valeur convertie est inférieure à la largeur, la sortie est complétée par des espaces ('&#92;u0020') jusqu’à ce que le nombre total de caractères soit égal à la largeur. Le remplissage se trouve à gauche par défaut. Si l’indicateur '-' est donné, le remplissage sera à droite. Si la largeur n’est pas spécifiée, il n’y a pas de minimum.

Si la conversion « floatDPrec »> est 'e', 'E' ou 'f', la précision est le nombre de chiffres après le séparateur décimal. Si la précision n’est pas spécifiée, elle est supposée être 6.

Si la conversion est 'g' ou 'G', la précision est le nombre total de chiffres significatifs dans la magnitude résultante après l’arrondi. Si la précision n’est pas spécifiée, la valeur par défaut est 6. Si la précision est 0, alors il est pris pour être 1.

Si la conversion est 'a' ou 'A', la précision est le nombre de chiffres hexadécimaux après le point radix. Si la précision n’est pas fournie, tous les chiffres retournés par Double#toHexString(double) seront générés.

« dnbdec"><b> BigDecimal </b>

Les conversions suivantes peuvent être appliquées java.math.BigDecimal BigDecimal.

<table class="striped"><caption style="display :none">floatConv</caption><tbody>

<tr><th scope="row » style="vertical-align :top"'e'><td style="vertical-align :top"'&#92;u0065'<>td> Nécessite la mise en forme de la sortie à l’aide de la notation scientifique informatisée « jsonentific ».> L’algorithme de localisation est appliqué.

La mise en forme du m de magnitude dépend de sa valeur.

Si m est positif-zéro ou négatif-zéro, l’exposant sera "+00".

Sinon, le résultat est une chaîne qui représente le signe et la magnitude (valeur absolue) de l’argument. La mise en forme du signe est décrite dans l’algorithme de localisation. La mise en forme du m de magnitude dépend de sa valeur.

Laissez n être l’entier unique de sorte que 10<sup>n</sup> <= m < 10<sup>n+1</sup> ; alors laissez un quotient mathématiquement exact de m et 10<sup>n</sup> afin que 1 <= a < 10. La magnitude est ensuite représentée sous la forme d’une partie entière d’un chiffre, sous la forme d’un chiffre décimal unique, suivie du séparateur décimal suivi de chiffres décimaux représentant la partie fractionnaire d’un, suivi du symbole 'e' exposant ('&#92;u0065'), suivi du signe de l’exposant, suivi d’une représentation de n comme entier décimal, comme produit par la méthode Long#toString(long, int), et zéro rembourré pour inclure au moins deux chiffres.

Le nombre de chiffres dans le résultat pour la partie fractionnaire de m ou un est égal à la précision. Si la précision n’est pas spécifiée, la valeur par défaut est 6. Si la précision est inférieure au nombre de chiffres à droite de la virgule décimale, la valeur est arrondie à l’aide de l’algorithme java.math.RoundingMode#HALF_UP demi-up. Sinon, les zéros peuvent être ajoutés pour atteindre la précision. Pour une représentation canonique de la valeur, utilisez BigDecimal#toString().

Si l’indicateur ',' est donné, une FormatFlagsConversionMismatchException exception est levée.

<tr><th scope="row » style="vertical-align :top">'E'<td style="vertical-align :top"td"'&#92;u0045'<>td> La variante majuscule de .'e' Le symbole d’exposant sera 'E' ('&#92;u0045').

<tr><th scope="row » style="vertical-align :top">'g'<td style="vertical-align :top"'&#92;u0067'><td> Exige que la sortie soit mise en forme en notation scientifique générale, comme décrit ci-dessous. L’algorithme de localisation est appliqué.

Après l’arrondi pour la précision, la mise en forme du m de magnitude résultant dépend de sa valeur.

Si m est supérieur ou égal à 10<sup-4></sup mais inférieur à 10<sup>> précision</sup>, il est représenté au format décimal.

Si m est inférieur à 10<sup-4></sup> ou supérieur ou égal à 10<sup>précision</sup>, il est représenté en notation scientifique informatisée.

Le nombre total de chiffres significatifs en m est égal à la précision. Si la précision n’est pas spécifiée, la valeur par défaut est 6. Si la précision est 0, alors il est pris pour être 1.

Si l’indicateur '#' est donné, une FormatFlagsConversionMismatchException exception est levée.

<tr><th scope="row » style="vertical-align :top">'G'<td style="vertical-align :top"td"'&#92;u0047'<>td> La variante majuscule de .'g'

<tr><th scope="row » style="vertical-align :top"'f'><td style="vertical-align :top"'&#92;u0066'<>td> Nécessite que la sortie soit mise en forme à l’aide du format « bdecimal">decimal ». L’algorithme de localisation est appliqué.

Le résultat est une chaîne qui représente le signe et la magnitude (valeur absolue) de l’argument. La mise en forme du signe est décrite dans l’algorithme de localisation. La mise en forme du m de magnitude dépend de sa valeur.

La magnitude est mise en forme comme partie entière de m, sans zéros non significatifs, suivie du séparateur décimal suivi d’un ou plusieurs chiffres décimaux représentant la partie fractionnaire de m.

Le nombre de chiffres dans le résultat pour la partie fractionnaire de m ou un est égal à la précision. Si la précision n’est pas spécifiée, la valeur par défaut est 6. Si la précision est inférieure au nombre de chiffres à droite de la virgule décimale, la valeur est arrondie à l’aide de l’algorithme java.math.RoundingMode#HALF_UP demi-up. Sinon, les zéros peuvent être ajoutés pour atteindre la précision. Pour une représentation canonique de la valeur, utilisez BigDecimal#toString().

</tbody></table>

Tous les indicateurs définis pour Byte, Short, Integer et Long s’appliquent.

Si l’indicateur '#' est donné, le séparateur décimal est toujours présent.

Le comportement par défaut lorsqu’aucun indicateur n’est donné est le même que pour Float et Double.

La spécification de la largeur et de la précision est la même que celle définie pour Float et Double.

<h4>"ddt">Date/Heure</h4>

Cette conversion peut être appliquée à long, Long, CalendarDate et<TemporalAccessor TemporalAccessor table class="striped"caption style="<>display :none">DTConv</caption><tbody>

<tr><th scope="row » style="vertical-align :top">'t'<td style="vertical-align :top"'&#92;u0074'><td> Prefix for date and time conversion characters. <tr><th scope="row » style="vertical-align :top">'T'<td style="vertical-align :top"td"'&#92;u0054'<>td> La variante majuscule de .'t'

</tbody></table>

Les suffixes de caractères de conversion de date et d’heure suivants sont définis pour les conversions et 'T' les 't' conversions. Les types sont similaires mais pas complètement identiques à ceux définis par GNU date et POSIX strftime(3c). Des types de conversion supplémentaires sont fournis pour accéder aux fonctionnalités spécifiques à Java (par exemple 'L' , pour les millisecondes au cours de la seconde).

Les caractères de conversion suivants sont utilisés pour la mise en forme des heures :

<table class="striped"><caption style="display :none">time</caption><tbody>

<tr><th scope="row » style="vertical-align :top"><'H'td style="vertical-align :top"<>'&#92;u0048'td> Hour of the day for the 24-hour clock, formaté en deux chiffres avec un zéro non significatif si nécessaire, c’est-à-dire 00 - 2300 à minuit.

<tr><th scope="row » style="vertical-align :top"'I'><td style="vertical-align :top"'&#92;u0049'<>td> Hour pour l’horloge de 12 heures, mis en forme sous la forme de deux chiffres avec un zéro non significatif si nécessaire, c’est-à-dire . 01 - 12 01 correspond à une heure (le matin ou l’après-midi).

<tr><th scope="row » style="vertical-align :top"><'k'td style="vertical-align :top"<>'&#92;u006b'td> Hour of the day for the 24-hour clock, i.e. 0 - 230 correspond à minuit.

<tr><th scope="row » style="vertical-align :top"><'l'td style="vertical-align :top"<>'&#92;u006c'td> Hour pour l’horloge de 12 heures, c’est-à-dire 1 - 12. 1 correspond à une heure (le matin ou l’après-midi).

<tr><th scope="row » style="vertical-align :top"'M'><td style="vertical-align :top"'&#92;u004d'<>td> Minute dans l’heure mise en forme sous forme de deux chiffres avec un zéro non significatif si nécessaire, c’est-à-dire . 00 - 59

<tr><th scope="row » style="vertical-align :top"><'S'td style="vertical-align :top"<>'&#92;u0053'td> Secondes dans la minute, mis en forme sous forme de deux chiffres avec un zéro non significatif si nécessaire, c’est-à-dire 00 - 60 (« 60 » est une valeur spéciale nécessaire pour prendre en charge les secondes de saut).

<tr><th scope="row » style="vertical-align :top"'L'><td style="vertical-align :top"'&#92;u004c'<>td> Millisecond in the second formatted as three digits with leading zeros as necessary, i.e. . 000 - 999

<tr><th scope="row » style="vertical-align :top"'N'><td style="vertical-align :top"'&#92;u004e'<>td> Nanosecond in the second, formaté comme neuf chiffres avec des zéros non significatifs si nécessaire, c’est-à-dire . 000000000 - 999999999 La précision de cette valeur est limitée par la résolution du système d’exploitation ou du matériel sous-jacent.

<tr><th scope="row » style="vertical-align :top"'p'><td style="vertical-align :top"'&#92;u0070'<>td> Locale-specific java.text.DateFormatSymbols#getAmPmStrings matin ou après-midi en minuscules, par exemple. »am ou «pm ». L’utilisation du préfixe 'T' de conversion force cette sortie en majuscules. (Notez que 'p' produit une sortie en minuscules. Ceci est différent de GNU date et POSIX strftime(3c) qui produisent une sortie majuscule.)

<tr><th scope="row » style="vertical-align :top"<'z'>td style="vertical-align :top">'&#92;u007a'<td>RFC 822 style timezone offset from GMT, par exemple . -0800 Cette valeur sera ajustée si nécessaire pour l’heure d’été. Pour long, Longet Date le fuseau horaire utilisé est le fuseau horaire timeZone#getDefault() par défaut pour cette instance de la machine virtuelle Java.

<tr><th scope="row » style="vertical-align :top">'Z'<td style="vertical-align :top"'&#92;u005a'><td> A string représentant l’abréviation du fuseau horaire. Cette valeur sera ajustée si nécessaire pour l’heure d’été. Pour long, Longet Date le fuseau horaire utilisé est le fuseau horaire timeZone#getDefault() par défaut pour cette instance de la machine virtuelle Java. Les paramètres régionaux du formateur remplacent les paramètres régionaux de l’argument (le cas échéant).

<tr><th scope="row » style="vertical-align :top"<'s'>td style="vertical-align :top"><'&#92;u0073'td> Seconds depuis le début de l’époque à partir du 1er janvier 1970 00:00:00 UTC, c’est-à-dire Long.MIN_VALUE/1000 à .Long.MAX_VALUE/1000

<tr><th scope="row » style="vertical-align :top"<'Q'>td style="vertical-align :top"><'&#92;u004f'td> Milliseconds depuis le début de l’époque à partir du 1er janvier 1970 00:00:00 UTC, c’est-à-dire Long.MIN_VALUE à .Long.MAX_VALUE La précision de cette valeur est limitée par la résolution du système d’exploitation ou du matériel sous-jacent.

</tbody></table>

Les caractères de conversion suivants sont utilisés pour la mise en forme des dates :

<table class="striped"><caption style="display :none">date</caption><tbody>

<tr><th scope="row » style="vertical-align :top"><'B'td style="vertical-align :top"<>'&#92;u0042'td> Locale-specific java.text.DateFormatSymbols#getMonths full month name, par exemple "January", . "February"

<tr><th scope="row » style="vertical-align :top"><'b'td style="vertical-align :top"<>'&#92;u0062'td> Locale-specific java.text.DateFormatSymbols#getShortMonths abbreviated month name, par exemple "Jan", . "Feb"

<tr><th scope="row » style="vertical-align :top">'h'<td style="vertical-align :top"td"'&#92;u0068'<>same> as .'b'

<tr><th scope="row » style="vertical-align :top">'A'<td style="vertical-align :top"<'&#92;u0041'>td> Locale-specific full name of the java.text.DateFormatSymbols#getWeekdays day of the week, par exemple"Sunday",<"Monday" tr><th scope="row » style="vertical-align :top"td style="><'a'vertical-align :top"'&#92;u0061'><td> Locale-specific short name of the java.text.DateFormatSymbols#getShortWeekdays day of the week, par exemple"Sun", "Mon"<tr tr><th scope="row » style="vertical-align :top">'C'<td style="vertical-align :top"td">'&#92;u0043'<td> Four-digit year divisé par 100, mis en forme comme deux chiffres avec zéro non significatif si nécessaire, c’est-à-dire tr<><00 - 99 th scope="row » style="vertical-align :top"'Y'><td style="vertical-align :top"<>'&#92;u0059'td> Year, mis en forme sur au moins quatre chiffres avec des zéros non significatifs si nécessaire, par exemple0092, correspond à 92 CE pour le calendrier grégorien.

<tr><th scope="row » style="vertical-align :top"><'y'td style="vertical-align :top"td>"'&#92;u0079'><Last two digits of the year, mis en forme avec des zéros non significatifs si nécessaire, c’est-à-dire . 00 - 99

<tr><th scope="row » style="vertical-align :top">'j'<td style="vertical-align :top"td"'&#92;u006a'<>td> Day of year, mis en forme comme trois chiffres avec des zéros non significatifs si nécessaire, par exemple 001 - 366 pour le calendrier grégorien. 001 correspond au premier jour de l’année.

<tr><th scope="row » style="vertical-align :top"<'m'>td style="vertical-align :top"'&#92;u006d'><td> Month, mis en forme comme deux chiffres avec des zéros non significatifs si nécessaire, c’est-à-dire01 - 13, où « 01 » est le premier mois de l’année et (« 13 » est une valeur spéciale requise pour prendre en charge les calendriers lunaires).

<tr><th scope="row » style="vertical-align :top"><'d'td style="vertical-align :top"<>'&#92;u0064'td>"day of month, mis en forme comme deux chiffres avec des zéros non significatifs si nécessaire, c’est-à-dire 01 - 31où « 01 » est le premier jour du mois.

<tr><th scope="row » style="vertical-align :top"><'e'td style="vertical-align :top"<>'&#92;u0065'td>"day of month, mis en forme comme deux chiffres, c’est-à-dire 1 - 31 où « 1 » est le premier jour du mois.

</tbody></table>

Les caractères de conversion suivants sont utilisés pour mettre en forme des compositions de date/heure communes.

<table class="striped"><caption style="display :none">composites</caption><tbody>

<tr><th scope="row » style="vertical-align :top"<'R'>td style="vertical-align :top"'&#92;u0052'><td> Time mis en forme pour l’horloge de 24 heures comme "%tH:%tM"<tr><th scope="row » style="vertical-align :top"<'T'>td style="vertical-align :top"'&#92;u0054'<>td> Time mis en forme pour l’horloge de 24 heures comme ."%tH:%tM:%tS"

<tr><th scope="row » style="vertical-align :top"'r'><td style="vertical-align :top"'&#92;u0072'<>td> Time mis en forme pour l’horloge de 12 heures comme ."%tI:%tM:%tS %Tp" L’emplacement du marqueur du matin ou de l’après-midi ('%Tp') peut être dépendant des paramètres régionaux.

<tr><th scope="row » style="vertical-align :top"'D'><td style="vertical-align :top"'&#92;u0044'<>td> Date mise en forme "%tm/%td/%ty"comme .

<tr><th scope="row » style="vertical-align :top"<'F'>td style="vertical-align :top">'&#92;u0046'<td>ISO 8601 complete date formatée en ."%tY-%tm-%td"

<tr><th scope="row » style="vertical-align :top"><'c'td style="vertical-align :top"<>'&#92;u0063'td> Date and time formatted as "%ta %tb %td %tT %tZ %tY", par exemple . "Sun Jul 20 16:17:00 EDT 1969"

</tbody></table>

L’indicateur '-' défini pour les conversions générales s’applique. Si l’indicateur '#' est donné, une FormatFlagsConversionMismatchException exception est levée.

La largeur correspond au nombre minimal de caractères à écrire dans la sortie. Si la longueur de la valeur convertie est inférieure à la width sortie, la sortie est complétée par des espaces ('&#92;u0020') jusqu’à ce que le nombre total de caractères soit égal à la largeur. Le remplissage se trouve à gauche par défaut. Si l’indicateur '-' est donné, le remplissage sera à droite. Si la largeur n’est pas spécifiée, il n’y a pas de minimum.

La précision n’est pas applicable. Si la précision est spécifiée, une IllegalFormatPrecisionException valeur est levée.

<h4>"dper">Percent</h4>

La conversion ne correspond à aucun argument.

<table class="striped"><caption style="display :none">DTConv</caption><tbody>

<tr><th scope="row » style="vertical-align :top"'%'<>td> Le résultat est un littéral '%' ()'&#92;u0025'

La largeur est le nombre minimal de caractères à écrire dans la sortie, y compris le '%'. Si la longueur de la valeur convertie est inférieure à la width sortie, la sortie est complétée par des espaces ('&#92;u0020') jusqu’à ce que le nombre total de caractères soit égal à la largeur. Le remplissage est à gauche. Si la largeur n’est pas spécifiée, il s’agit simplement de la '%' sortie.

L’indicateur '-' défini pour les conversions générales s’applique. Si d’autres indicateurs sont fournis, un FormatFlagsConversionMismatchException indicateur est levée.

La précision n’est pas applicable. Si la précision est spécifiée, une IllegalFormatPrecisionException exception est levée.

</tbody></table>

<h4>"dls">Séparateur< de ligne/h4>

La conversion ne correspond à aucun argument.

<table class="striped"><caption style="display :none">DTConv</caption><tbody>

<tr><th scope="row » style="vertical-align :top"><'n'td> le séparateur de ligne spécifique à la plateforme tel qu’il est retourné par .System#lineSeparator()

</tbody></table>

Les indicateurs, la largeur et la précision ne sont pas applicables. Si un élément est fourni, IllegalFormatFlagsExceptionun , IllegalFormatWidthExceptionet IllegalFormatPrecisionException, respectivement, sera levée.

<h4>"dpos">Index< d’argument/h4>

Les spécificateurs de format peuvent référencer des arguments de trois façons :

<ul>

<l’indexation explicite>est utilisée lorsque le spécificateur de format contient un index d’argument. L’index d’argument est un entier décimal indiquant la position de l’argument dans la liste d’arguments. Le premier argument est référencé par «1$ », le second par «2$ », etc. Un argument peut être référencé plusieurs fois.

Par exemple :

<blockquote>

formatter.format("%4$s %3$s %2$s %1$s %4$s %3$s %2$s %1$s",
                               "a", "b", "c", "d")
              // -&gt; "d c b a d c b a"

</blockquote>

<l’indexation> relative est utilisée lorsque le spécificateur de format contient un '<' indicateur ('&#92;u003c') qui entraîne la réutilisation de l’argument du spécificateur de format précédent. S’il n’existe aucun argument précédent, un MissingFormatArgumentException argument est levée.

<blockquote>

formatter.format("%s %s %&lt;s %&lt;s", "a", "b", "c", "d")
               // -&gt; "a b b b"
               // "c" and "d" are ignored because they are not referenced

</blockquote>

<l’indexation ordinaire>est utilisée lorsque le spécificateur de format ne contient ni un index d’argument ni un '<' indicateur. Chaque spécificateur de format qui utilise l’indexation ordinaire est affecté à un index implicite séquentiel dans la liste d’arguments, indépendant des index utilisés par l’indexation explicite ou relative.

<blockquote>

formatter.format("%s %s %s %s", "a", "b", "c", "d")
              // -&gt; "a b c d"

</blockquote>

</ul>

Il est possible d’avoir une chaîne de format qui utilise toutes les formes d’indexation, par exemple :

<blockquote>

formatter.format("%2$s %s %&lt;s %s", "a", "b", "c", "d")
              // -&gt; "b a a b"
              // "c" and "d" are ignored because they are not referenced

</blockquote>

Le nombre maximal d’arguments est limité par la dimension maximale d’un tableau Java tel que défini par <citer>le >Java ; Spécification</cite> de machine virtuelle. Si l’index d’argument ne correspond pas à un argument disponible, un MissingFormatArgumentException argument est levée.

S’il existe plus d’arguments que de spécificateurs de format, les arguments supplémentaires sont ignorés.

Sauf indication contraire, le passage d’un null argument à n’importe quelle méthode ou constructeur de cette classe entraîne la levée d’un NullPointerException argument.

Ajouté à la version 1.5.

Documentation Java pour java.util.Formatter.

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.

Constructeurs

Formatter()

Construit un nouveau formateur.

Formatter(File)

Construit un nouveau formateur avec le fichier spécifié.

Formatter(File, Charset, Locale)

Construit un nouveau formateur avec le fichier, le charset et les paramètres régionaux spécifiés.

Formatter(File, String)

Construit un nouveau formateur avec le fichier et l’ensemble de caractères spécifiés.

Formatter(File, String, Locale)

Construit un nouveau formateur avec le fichier, le charset et les paramètres régionaux spécifiés.

Formatter(IAppendable)

Construit un nouveau formateur avec la destination spécifiée.

Formatter(IAppendable, Locale)

Construit un nouveau formateur avec la destination et les paramètres régionaux spécifiés.

Formatter(Locale)

Construit un nouveau formateur avec les paramètres régionaux spécifiés.

Formatter(PrintStream)

Construit un nouveau formateur avec le flux d’impression spécifié.

Formatter(Stream)

Construit un nouveau formateur avec le flux de sortie spécifié.

Formatter(Stream, Charset, Locale)

Construit un nouveau formateur avec le flux de sortie, le charset et les paramètres régionaux spécifiés.

Formatter(Stream, String)

Construit un nouveau formateur avec le flux de sortie et l’ensemble de caractères spécifiés.

Formatter(Stream, String, Locale)

Construit un nouveau formateur avec le flux de sortie, le charset et les paramètres régionaux spécifiés.

Formatter(String)

Construit un nouveau formateur avec le nom de fichier spécifié.

Formatter(String, Charset, Locale)

Construit un nouveau formateur avec le nom de fichier, le charset et les paramètres régionaux spécifiés.

Formatter(String, String)

Construit un nouveau formateur avec le nom de fichier et l’ensemble de caractères spécifiés.

Formatter(String, String, Locale)

Construit un nouveau formateur avec le nom de fichier, le charset et les paramètres régionaux spécifiés.

Propriétés

Class

Retourne la classe runtime de ce Object.

(Hérité de Object)
Handle

Handle de l’instance Android sous-jacente.

(Hérité de Object)
JniIdentityHashCode

Interpréteur pour les chaînes de format de style printf.

(Hérité de Object)
JniPeerMembers

Interpréteur pour les chaînes de format de style printf.

PeerReference

Interpréteur pour les chaînes de format de style printf.

(Hérité de Object)
ThresholdClass

Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code.

(Hérité de Object)
ThresholdType

Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code.

(Hérité de Object)

Méthodes

Clone()

Crée et retourne une copie de cet objet.

(Hérité de Object)
Close()

Ferme ce formateur.

Dispose()

Interpréteur pour les chaînes de format de style printf.

(Hérité de Object)
Dispose(Boolean)

Interpréteur pour les chaînes de format de style printf.

(Hérité de Object)
Equals(Object)

Indique si un autre objet est « égal à » celui-ci.

(Hérité de Object)
Flush()

Vide ce formateur.

Format(Locale, String, Object[])

Écrit une chaîne mise en forme dans la destination de cet objet à l’aide de la chaîne de format et des arguments spécifiés.

Format(String, Object[])

Écrit une chaîne mise en forme dans la destination de cet objet à l’aide de la chaîne de format et des arguments spécifiés.

GetHashCode()

Retourne une valeur de code de hachage pour l'objet.

(Hérité de Object)
IoException()

Retourne la IOException dernière levée par le formateur Appendable.

JavaFinalize()

Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet.

(Hérité de Object)
Locale()

Retourne les paramètres régionaux définis par la construction de ce formateur.

Notify()

Réveille un thread unique qui attend le moniteur de cet objet.

(Hérité de Object)
NotifyAll()

Réveille tous les threads qui attendent le moniteur de cet objet.

(Hérité de Object)
Out()

Retourne la destination de la sortie.

SetHandle(IntPtr, JniHandleOwnership)

Définit la propriété Handle.

(Hérité de Object)
ToArray<T>()

Interpréteur pour les chaînes de format de style printf.

(Hérité de Object)
ToString()

Retourne une représentation de chaîne de l'objet.

(Hérité de Object)
UnregisterFromRuntime()

Interpréteur pour les chaînes de format de style printf.

(Hérité de Object)
Wait()

Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<>

(Hérité de Object)
Wait(Int64)

Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée.

(Hérité de Object)
Wait(Int64, Int32)

Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée.

(Hérité de Object)

Implémentations d’interfaces explicites

IJavaPeerable.Disposed()

Interpréteur pour les chaînes de format de style printf.

(Hérité de Object)
IJavaPeerable.DisposeUnlessReferenced()

Interpréteur pour les chaînes de format de style printf.

(Hérité de Object)
IJavaPeerable.Finalized()

Interpréteur pour les chaînes de format de style printf.

(Hérité de Object)
IJavaPeerable.JniManagedPeerState

Interpréteur pour les chaînes de format de style printf.

(Hérité de Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)

Interpréteur pour les chaînes de format de style printf.

(Hérité de Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

Interpréteur pour les chaînes de format de style printf.

(Hérité de Object)
IJavaPeerable.SetPeerReference(JniObjectReference)

Interpréteur pour les chaînes de format de style printf.

(Hérité de Object)

Méthodes d’extension

JavaCast<TResult>(IJavaObject)

Effectue une conversion de type vérifiée par le runtime Android.

JavaCast<TResult>(IJavaObject)

Interpréteur pour les chaînes de format de style printf.

GetJniTypeName(IJavaPeerable)

Interpréteur pour les chaînes de format de style printf.

FlushAsync(IFlushable)

Interpréteur pour les chaînes de format de style printf.

S’applique à