1. NOM

numfmt - Convertir des nombres vers ou à partir de formats lisibles par un humain

2. SYNOPSIS

numfmt [OPTION]... [NOMBRE]...

3. DESCRIPTION

Reformater le ou les NOMBREs, ou les nombres de l'entrée standard si aucun n'est indiqué.

Les paramètres obligatoires pour les options de forme longue le sont aussi pour les options de forme courte.

  • --debug
        Afficher les avertissements en cas d'entrée incorrecte
  • -d, --delimiter=X
        Utiliser X au lieu d'une tabulation comme délimiteur de champs
  • --field=N
        Remplacer le nombre dans le champs d'entrée N (1 par défaut)
  • --format=FORMAT
        Utiliser le le type printf de virgule flottante FORMAT ; consultez FORMAT plus bas pour des précisions
  • --from=UNIT
        Mettre automatiquement à l'échelle « UNIT » les nombres en entrée ; « none » par défaut ; consultez UNIT plus bas
  • --from-unit=N
        La taille d'unité en entrée (au lieu de 1 par défaut)
  • --grouping
        Grouper les chiffres ensemble (par exemple 1 000 000) en utilisant le groupement défini dans les paramètres régionaux (donc sans effet avec les locales C/POSIX)
  • --header[=N]
        Afficher (sans conversion) les N premières lignes d'en-tête ; N vaut 1 par défaut si non indiqué
  • --invalid=MODE
        Mode d'échec pour les nombres incorrects ; MODE peut être « abort » (par défaut), « fail », « warn » ou « ignore »
  • --padding=N
        Remplir la sortie avec N caractères ; N positif alignera à droite. N négatif alignera à gauche ; le remplissage est ignoré si la sortie est plus grande que N ; le remplissage est automatique par défaut si un blanc est trouvé
  • --round=MÉTHODE
        Utiliser MÉTHODE pour arrondir lors de la mise à l'échelle ; MÉTHODE peut être : « up », « down », « from-zero » (par défaut), « towards-zero » ou « nearest »
  • --suffix=SUFFIXE
        Ajouter le SUFFIXE aux nombres en sortie, et accepter le SUFFIXE facultatif aux nombres en entrée
  • --to=UNIT
        mettre à l'échelle automatiquement les nombres en sortie à « UNIT » ; consultez UNIT plus bas
  • --to-unit=N
        la taille d'unité en sortie (au lieu de 1 par défaut)
  • --help
        Afficher l'aide-mémoire et quitter
  • --version
        Afficher le nom et la version du logiciel et quitter

3.1. options UNIT

  • none
        aucune mise à l'échelle automatique n'est effectuée ; les suffixes déclencheront une erreur
  • auto
        accepter un suffixe facultatif d'une ou deux lettres :

1K = 1000, 1Ki = 1024, 1M = 1000000, 1Mi = 1048576, etc.

  • si
        accepter un suffixe facultatif d'une ou deux lettres :

1K = 1000, 1M = 1000000, etc.

  • iec
        accepter un suffixe facultatif d'une ou deux lettres :

1K = 1024, 1M = 1048576, etc.

  • iec-i
        accepter un suffixe facultatif de deux lettres :

1Ki = 1024, 1Mi = 1048576, etc.

FORMAT doit être adapté à l'affichage d'un argument de virgule flottante « %f ». Le guillemet facultatif (%'f) activera --grouping (si permis avec les paramètres régionaux actuels). Une valeur de largeur facultative (%10f) remplira la sortie. Une valeur de largeur négative facultative (%-10f) remplira la sortie à gauche.

Le code de retour est 0 si tous les nombres en entrée ont été convertis sans erreur. Par défaut, numfmt s'arrêtera à la première erreur de conversion avec un code de retour de 2. Avec --invalid='fail', un avertissement est affiché à chaque erreur de conversion et le code de retour est 2. Avec --invalid='warn', toutes les erreurs de conversion sont diagnostiquées, mais le code de retour est 0. Avec --invalid='ignore', les erreur de conversion ne sont pas diagnostiquées, et le code de retour est 0.

4. EXEMPLES

 
Sélectionnez
$ numfmt --to=si 1000 

-> "1.0K"

 
Sélectionnez
$ numfmt --to=iec 2048 

-> "2.0K"

 
Sélectionnez
$ numfmt --to=iec-i 4096 

-> "4.0Ki"

 
Sélectionnez
$ echo 1K | numfmt --from=si 

-> "1000"

 
Sélectionnez
$ echo 1K | numfmt --from=iec 

-> "1024"




 
Sélectionnez
$ df | numfmt --header --field 2 --to=si 
 
Sélectionnez
$ ls -l | numfmt --header --field 5 --to=iec 
 
Sélectionnez
$ ls -lh | numfmt --header --field 5 --from=iec --padding=10 
 
Sélectionnez
$ ls -lh | numfmt --header --field 5 --from=iec --format %10f 

5. AUTEUR

Écrit par Assaf Gordon.

6. SIGNALER DES BOGUES

Signaler toute anomalie de numfmt à
Page d'accueil de GNU coreutils : <http://www.gnu.org/software/coreutils/>
Aide générale sur l'utilisation des logiciels GNU : <http://www.gnu.org/gethelp/>
Signaler toute erreur de traduction de numfmt à <http://translationproject.org/team/>

7. COPYRIGHT

Copyright © 2013 Free Software Foundation, Inc. Licence GPLv3+ : GNU GPL version 3 ou supérieures <http://gnu.org/licenses/gpl.html>
Ce programme est un logiciel libre. Vous pouvez le modifier et le redistribuer. Il n'y a AUCUNE GARANTIE dans la mesure autorisée par la loi.

8. VOIR AUSSI

La documentation complète pour numfmt est disponible dans un manuel Texinfo. Si les programmes info et numfmt sont correctement installés sur le système, la commande

info coreutils numfmt invocation

devrait vous donner accès au manuel complet (en anglais).

9. TRADUCTION

Cette page de manuel a été traduite par Michel Robitaille <robitail AT iro DOT umontreal DOT ca> et mise à jour pour Debian par Bastien Scher < > et les membres de la liste <debian-l10n-french AT lists DOT debian DOT org>. Veuillez signaler toute erreur de traduction par un rapport de bogue sur le paquet manpages-fr-extra.