Handbücher für die Kommandozeile

Man » numfmt Manual online - detaillierte Online-Dokumentation für die numfmt-Manpage

🌍
numfmt - Zahlen in lesbare Zeichenketten und umgekehrt konvertieren

SYNOPSIS

numfmt [OPTION]... [ZAHL]...

BESCHREIBUNG

Formatiert ZAHL(EN) neu oder liest die Zahlen aus der Standardeingabe, falls keine angegeben sind.

Obligatorische Argumente für lange Optionen sind auch für kurze Optionen obligatorisch.

--debug
gibt Warnungen über ungültige Eingaben aus

-d, --delimiter=X
verwendet X anstelle von Leerzeichen als Feldtrennzeichen

--field=FELDER
ersetzt die Zahlen in diesen Eingabefeldern (Standard = 1); siehe FELDER unten

--format=FORMAT
verwendet ein printf-ähnliches Format für Gleitkommazahlen; siehe FORMAT unten für Details

--from=EINHEIT
skaliert die Eingabezahlen automatisch auf EINHEITen; Standard ist 'none'; siehe EINHEIT unten

--from-unit=N
gibt die Größe der Eingabeeinheit an (anstelle des Standardwerts 1)

--grouping
verwendet die lokalspezifische Gruppierung von Ziffern, z. B. 1.000.000 (was in der C/POSIX-Umgebung keine Auswirkung hat)

--header[=N]
gibt die ersten N-Headerzeilen unverändert aus; wenn N nicht angegeben ist, ist der Standardwert 1

--invalid=MODUS
legt den Fehlerbehandlungsmodus für ungültige Zahlen fest: MODUS kann sein: abort (Standard), fail, warn, ignore

--padding=N
füllt die Ausgabe auf N Zeichen auf; ein positiver Wert für N richtet die Ausgabe rechtsbündig aus; ein negativer Wert für N richtet sie linksbündig aus; die Auffüllung wird ignoriert, wenn die Ausgabe breiter als N ist; Standard ist, dass automatisch aufgefüllt wird, wenn ein Leerzeichen vorhanden ist

--round=METHODE
verwendet die METHODE für die Rundung beim Skalieren; METHODE kann sein: up, down, from-zero (Standard), towards-zero, nearest

--suffix=SUFFIX
fügt ein SUFFIX an die Ausgabezahlen an und akzeptiert ein optionales SUFFIX in den Eingabezahlen

--to=EINHEIT
skaliert die Ausgabezahlen automatisch auf EINHEITen; siehe EINHEIT unten

--to-unit=N
die Ausgabeeinheit (anstelle des Standardwerts 1)

-z, --zero-terminated
das Zeilentrennzeichen ist NUL und nicht Zeilenumbruch

--help zeigt diese Hilfe an und beendet das Programm

--version
gibt Versionsinformationen aus und beendet das Programm

EINHEIT-Optionen:

none   keine automatische Skalierung; Suffixe führen zu einem Fehler

auto   akzeptiert ein optionales ein- oder zweizeiliges Suffix: 1K = 1000, 1k = 1000, 1Ki = 1024, 1M = 1000000,
1i = 1048576,

si     akzeptiert ein optionales einzeiliges Suffix: 1k = 1000, 1K = 1000, 1M = 1000000, ...

iec    akzeptiert ein optionales einzeiliges Suffix: 1K = 1024, 1k = 1024, 1M = 1048576, ...

iec-i  akzeptiert ein optionales zweizeiliges Suffix: 1Ki = 1024, 1ki = 1024, 1Mi = 1048576, ...

FELDER unterstützt cut(1)-ähnliche Feldreihen:

N      das N-te Feld, gezählt ab 1

N-     ab dem N-ten Feld bis zum Ende der Zeile

N-M    vom N-ten bis zum M-ten Feld (einschließlich)

-M     vom ersten bis zum M-ten Feld (einschließlich)

-      alle Felder

Mehrere Felder/Bereiche können durch Kommas getrennt werden

FORMAT muss für die Ausgabe eines einzelnen Gleitkommaarguments '%f' geeignet sein. Ein optionales Anführungszeichen (%'f) aktiviert --grouping (falls von der aktuellen Umgebung unterstützt). Ein optionaler Breitenwert (%10f) füllt die Ausgabe auf. Ein optionaler Breitenwert mit führenden Nullen (%010f) füllt die Zahl mit Nullen auf. Optionale negative Werte (%-10f) richten die Ausgabe linksbündig aus. Ein optionaler Präzisionswert (%.1f) überschreibt die durch die Eingabe bestimmte Präzision.

Der Exit-Status ist 0, wenn alle Eingabezahlen erfolgreich konvertiert wurden. Standardmäßig beendet numfmt das Programm beim ersten Konvertierungsfehler mit dem Exit-Status 2. Mit --invalid='fail' wird für jeden Konvertierungsfehler eine Warnung ausgegeben und das Programm beendet sich mit dem Exit-Status 2. Mit --invalid='warn' wird jeder Konvertierungsfehler gemeldet, aber das Programm beendet sich mit dem Exit-Status 0. Mit --invalid='ignore' werden Konvertierungsfehler nicht gemeldet und das Programm beendet sich mit dem Exit-Status 0.

BEISPIELE

$ 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

AUTOR

Geschrieben von Assaf Gordon.

FEHLERMELDUNGEN

GNU coreutils Online-Hilfe: [https://www.gnu.org/software/coreutils/] Melden Sie Übersetzungsfehler unter [https://translationproject.org/team/].

SIEHE AUCH

Vollständige Dokumentation [https://www.gnu.org/software/coreutils/numfmt] oder lokal verfügbar über: info '(coreutils) numfmt invocation'

Verpackt von Debian (9.7-3) Copyright © 2025 Free Software Foundation, Inc. Lizenz GPLv3+: GNU GPL Version 3 oder neuer [https://gnu.org/licenses/gpl.html]. Dies ist freie Software: Sie können sie ändern und weiterverbreiten. Es gibt KEINE GARANTIE, soweit dies gesetzlich zulässig ist.