numfmt - Convertir des nombres en chaînes lisibles par l’homme et inversement
SYNTAXE
numfmt [OPTION]... [NOMBRE]...
DESCRIPTION
Reformatez le ou les NOMBRE(s), ou les nombres provenant de l’entrée standard s’il n’y en a pas.
Les arguments obligatoires pour les options longues sont également obligatoires pour les options courtes.
--debug
affiche les avertissements concernant les entrées non valides
-d, --delimiter=X
utiliser X au lieu de l’espace pour le délimiteur de champ
--field=CHAMPS
remplacer les nombres dans ces champs d’entrée (par défaut : 1) ; voir CHAMPS ci-dessous
--format=FORMAT
utiliser un FORMAT de type flottant de style printf ; voir FORMAT ci-dessous pour plus de détails
--from=UNITÉ
mettre automatiquement à l’échelle les nombres d’entrée vers des UNITÉS ; la valeur par défaut est « none » ; voir UNITÉ ci-dessous
--from-unit=N
spécifier la taille de l’unité d’entrée (au lieu de la valeur par défaut de 1)
--grouping
utiliser le regroupement de chiffres défini dans les paramètres régionaux, par exemple 1 000 000 (ce qui signifie que cela n’a aucun effet dans les paramètres régionaux C/POSIX)
--header[=N]
afficher (sans conversion) les N premières lignes d’en-tête ; si N n’est pas spécifié, la valeur par défaut est 1
--invalid=MODE
mode de gestion des nombres non valides : MODE peut être : abort (par défaut), fail, warn, ignore
--padding=N
remplir la sortie avec N caractères ; une valeur positive de N alignera à droite ; une valeur négative de N alignera à gauche ; le remplissage est ignoré si la sortie est plus large que N ; par défaut, un remplissage automatique est effectué si un espace est trouvé
--round=MÉTHODE
utiliser la MÉTHODE pour l’arrondi lors de la mise à l’échelle ; la MÉTHODE peut être : up, down, from-zero (par défaut), towards-zero, nearest
--suffix=SUFFIXE
ajouter le SUFFIXE aux nombres de sortie et accepter un SUFFIXE facultatif dans les nombres d’entrée
--to=UNITÉ
mettre automatiquement à l’échelle les nombres de sortie vers des UNITÉS ; voir UNITÉ ci-dessous
--to-unit=N
la taille de l’unité de sortie (au lieu de la valeur par défaut de 1)
-z, --zero-terminated
le délimiteur de ligne est NUL, et non une nouvelle ligne
--help afficher cette aide et quitter
--version
afficher les informations de version et quitter
Options UNITÉ :
none aucune mise à l’échelle automatique n’est effectuée ; les suffixes déclencheront une erreur
auto accepter un suffixe d’une ou deux lettres : 1K = 1000, 1k = 1000, 1Ki = 1024, 1M = 1000000,
1i = 1048576,
si accepter un suffixe d’une seule lettre : 1k = 1000, 1K = 1000, 1M = 1000000, ...
iec accepter un suffixe d’une seule lettre : 1K = 1024, 1k = 1024, 1M = 1048576, ...
iec-i accepter un suffixe de deux lettres : 1Ki = 1024, 1ki = 1024, 1Mi = 1048576, ...
CHAMPS prend en charge les plages de champs de type cut(1) :
N N-ième champ, en comptant à partir de 1
N- à partir du N-ième champ, jusqu’à la fin de la ligne
N-M du N-ième au M-ième champ (inclus)
-M du premier au M-ième champ (inclus)
- tous les champs
Plusieurs champs/plages peuvent être séparés par des virgules
FORMAT doit être adapté à l’impression d’un seul argument de type flottant « %f ». L’option guillemet (« %’f ») activera le regroupement (si elle est prise en charge par les paramètres régionaux actuels). Une valeur de largeur facultative (« %10f ») remplira la sortie. Une valeur de largeur facultative avec un zéro (« %010f ») remplira le nombre avec des zéros. Les valeurs négatives facultatives (« %-10f ») aligneront à gauche. La précision facultative (« %.1f ») remplacera la précision déterminée en entrée.
Le code de sortie est 0 si tous les nombres d’entrée ont été convertis avec succès. Par défaut, numfmt s’arrêtera à la première erreur de conversion et renverra un code de sortie de 2. Avec --invalid='fail', un avertissement est affiché pour chaque erreur de conversion et le code de sortie est de 2. Avec --invalid='warn', chaque erreur de conversion est signalée, mais le code de sortie est de 0. Avec --invalid='ignore', les erreurs de conversion ne sont pas signalées et le code de sortie est de 0.
EXEMPLES
$ numfmt --to=si 1000
-> "1.0k"
$ numfmt --to=iec 2048
-> "2.0K"
$ numfmt --to=iec-i 4096
-> "4.0Ki"
$ echo 1K | numfmt --from=si
-> "1000"
$ echo 1K | numfmt --from=iec
-> "1024"
$ df -B1 | numfmt --header --field 2-4 --to=si
$ ls -l | numfmt --header --field 5 --to=iec
$ ls -lh | numfmt --header --field 5 --from=iec --padding=10
$ ls -lh | numfmt --header --field 5 --from=iec --format %10f
AUTEUR
Écrit par Assaf Gordon.
SIGNALEMENT DES BUGS
Aide en ligne de GNU coreutils : [https://www.gnu.org/software/coreutils/] Signalez tout bug de traduction à [https://translationproject.org/team/]
CONSULTER ÉGALEMENT
Documentation complète [https://www.gnu.org/software/coreutils/numfmt] ou disponible localement via : info « (coreutils) numfmt invocation »
Emballé par Debian (9.7-3) Copyright © 2025 Free Software Foundation, Inc. Licence GPLv3+ : GNU GPL version 3 ou ultérieure [https://gnu.org/licenses/gpl.html]. Il s’agit d’un logiciel libre : vous êtes libre de le modifier et de le redistribuer. Il n’y a AUCUNE GARANTIE, dans la mesure permise par la loi.