manpages-de 1.10 - en to de translation catalogue (96 entries)

note: type: TH
en: 2019-03-06
de: 6. März 2019

note: type: TH
en: Linux Programmer's Manual
de: Linux-Programmierhandbuch

note: type: SH
en: NAME
de: BEZEICHNUNG

note: type: Plain text
en: scanf, fscanf, sscanf, vscanf, vsscanf, vfscanf - input format conversion
de: scanf, fscanf, sscanf, vscanf, vsscanf, vfscanf - Anpassung des Eingabeformats

note: type: SH
en: SYNOPSIS
de: ÜBERSICHT

note: type: Plain text
en: B<int scanf(const char *>I<format>B<, ...);>
    B<int fscanf(FILE *>I<stream>B<, const char *>I<format>B<, ...);>
    B<int sscanf(const char *>I<str>B<, const char *>I<format>B<, ...);>
de: B<int scanf(const char *>I<format>B<, …);>
    B<int fscanf(FILE *>I<datenstrom>B<, const char *>I<format>B<, …);>
    B<int sscanf(const char *>I<zeichenkette>B<,>
    B<           const char *>I<format>B<, …);>

note: type: Plain text
en: B<int vscanf(const char *>I<format>B<, va_list >I<ap>B<);>
    B<int vsscanf(const char *>I<str>B<, const char *>I<format>B<, va_list >I<ap>B<);>
    B<int vfscanf(FILE *>I<stream>B<, const char *>I<format>B<, va_list >I<ap>B<);>
de: B<int vscanf(const char *>I<format>B<, va_list >I<ap>B<);>
    B<int vsscanf(const char *>I<zeichenkette>B<,>
    B<            const char *>I<format>B<, va_list >I<ap>B<);>
    B<int vfscanf(FILE *>I<datenstrom>B<,>
    B<            const char *>I<format>B<, va_list >I<ap>B<);>

note: type: Plain text
en: Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):
de: Mit Glibc erforderliche Makros (siehe B<feature_test_macros>(7)):

note: type: SH
en: DESCRIPTION
de: BESCHREIBUNG

note: type: Plain text
en: The B<scanf>()  family of functions scans input according to I<format> as described below.  This format may contain I<conversion specifications>; the results from such conversions, if any, are stored in the locations pointed to by the I<pointer> arguments that follow I<format>.  Each I<pointer> argument must be of a type that is appropriate for the value returned by the corresponding conversion specification.
de: Die Funktionenfamilie B<scanf>() prüft Eingaben in Bezug auf ein I<format>, wie es im Folgenden beschrieben wird. Dieses Format darf I<Umwandlungsspezifikationen> enthalten; die Ergebnisse solcher Umwandlungen, falls vorhanden, werden an den Stellen gespeichert, auf die die I<Zeiger>-Argumente verweisen, die sich an das I<format> halten. Jedes I<Zeiger>-Argument muss einen geeigneten Typ für den Rückgabewert durch die zugehörige Umwandlungsspezifikation haben.

note: type: Plain text
en: If the number of conversion specifications in I<format> exceeds the number of I<pointer> arguments, the results are undefined.  If the number of I<pointer> arguments exceeds the number of conversion specifications, then the excess I<pointer> arguments are evaluated, but are otherwise ignored.
de: Falls die Anzahl der Umwandlungsspezifikation in I<format> die Anzahl der I<Zeiger>-Argumente übersteigt, sind die Erbenisse undefiniert. Falls die Anzahl der I<Zeiger>-Argumente die Anzahl der Umwandlungsspezifikation übersteigt, werden die überzähligen I<Zeiger>-Argumente ausgewertet, aber ansonsten ignoriert.

note: type: Plain text
en: The B<scanf>()  function reads input from the standard input stream I<stdin>, B<fscanf>()  reads input from the stream pointer I<stream>, and B<sscanf>()  reads its input from the character string pointed to by I<str>.
de: Die Funktion B<scanf>() liest Eingaben von der Standardeingabe I<stdin>, B<fscanf> liest Eingaben von dem Datenstrom-Zeiger I<datenstrom> und B<sscanf> liest ihre Eingaben aus der Zeichenkette, auf den I<zeichenkette> zeigt.

note: type: Plain text
en: The B<vfscanf>()  function is analogous to B<vfprintf>(3)  and reads input from the stream pointer I<stream> using a variable argument list of pointers (see B<stdarg>(3).  The B<vscanf>()  function scans a variable argument list from the standard input and the B<vsscanf>()  function scans it from a string; these are analogous to the B<vprintf>(3)  and B<vsprintf>(3)  functions respectively.
de: Die Funktion B<vfscanf>() verhält sich analog zu B<vfprintf>(3) und liest Eingaben von dem Datenstrom-Zeiger I<datenstrom>, wobei eine variable Argumentliste von Zeigern benutzt wird (siehe B<stdarg>(3)). Die Funktion B<vscanf>() liest eine variable Argumentliste von der Standardeingabe und die Funktion B<vsscanf>() liest sie aus einer Zeichenkette; diese sind analog zu den Funktionen B<vprintf>(3) beziehungsweise B<vsprintf>(3).

note: type: Plain text
en: The I<format> string consists of a sequence of I<directives> which describe how to process the sequence of input characters.  If processing of a directive fails, no further input is read, and B<scanf>()  returns.  A "failure" can be either of the following: I<input failure>, meaning that input characters were unavailable, or I<matching failure>, meaning that the input was inappropriate (see below).
de: Die Zeichenkette I<format> besteht aus einer Abfolge von I<Richtlinien>, die beschreiben, wie die Abfolge der Eingabezeichen verarbeitet wird. Wenn das Verarbeiten einer Richtlinie fehlschlägt, werden keine weiteren Eingaben gelesen und B<scanf>() kehrt zurück. Ein »Fehlschlagen« kann folgendes sein: I<input failure> bedeutet, dass Eingabezeichen nicht verfügbar sind. I<matching failure> heißt, dass die Eingabe ungeeignet war (siehe unten).

note: type: Plain text
en: A directive is one of the following:
de: Eine Richtlinie kann Folgendes sein:

note: type: Plain text
en: A sequence of white-space characters (space, tab, newline, etc.; see B<isspace>(3)).  This directive matches any amount of white space, including none, in the input.
de: eine Abfolge von Leerräumen (Leerzeichen, Tabulator, Zeilenvorschub, etc.; siehe B<isspace>(3)). Diese Richtlinie passt auf jede Menge von Leerräumen, einschließlich keinen in der Eingabe.

note: type: Plain text
en: An ordinary character (i.e., one other than white space or \(aq%\(aq).  This character must exactly match the next character of input.
de: ein normales Zeichen (d.h. ein anderes, als ein Leerraum oder »%«). Dieses Zeichen muss exakt mit dem nächsten Zeichen der Eingabe übereinstimmen.

note: type: Plain text
en: A conversion specification, which commences with a \(aq%\(aq (percent) character.  A sequence of characters from the input is converted according to this specification, and the result is placed in the corresponding I<pointer> argument.  If the next item of input does not match the conversion specification, the conversion fails\(emthis is a I<matching failure>.
de: eine Umwandlungsspezifikation, die mit dem Zeichen »%« (Prozent) beginnt. Eine Abfolge von Zeichen wird gemäß dieser Spezifikation umgewandelt und das Ergebnis wird in das zugehörige I<Zeiger>-Argument platziert. Falls das nächste Element nicht der Umwandlungsspezifikation entspricht, schlägt die Umwandlung fehl – dies ist ein I<matching failure>.

note: type: Plain text
en: Each I<conversion specification> in I<format> begins with either the character \(aq%\(aq or the character sequence "B<%>I<n>B<$>" (see below for the distinction) followed by:
de: Jede I<Umwandlungsspezifikation> in I<format> fängt entweder mit dem Zeichen »%« an oder der Zeichensequenz »B<%>I<n>B<$>« (siehe unten für die Unterscheidung) gefolgt von:

note: type: Plain text
en: An optional \(aq*\(aq assignment-suppression character: B<scanf>()  reads input as directed by the conversion specification, but discards the input.  No corresponding I<pointer> argument is required, and this specification is not included in the count of successful assignments returned by B<scanf>().
de: ein optionales »*«-Zeichen zur Unterdrückung der Zuweisung: B<scanf>() liest die Eingabe gemäß der Umwandlungsspezifikation, verwirft aber die Eingabe. Es wird kein zugehöriges I<Zeiger>-Argument benötigt und diese Spezifikation ist nicht in der Anzahl der erfolgreichen Zuweisungen enthalten, die von B<scanf>() zurückgegeben werden.

note: type: Plain text
en: For decimal conversions, an optional quote character (\(aq).  This specifies that the input number may include thousands' separators as defined by the B<LC_NUMERIC> category of the current locale.  (See B<setlocale>(3).)  The quote character may precede or follow the \(aq*\(aq assignment-suppression character.
de: ein optionales Maskierungszeichen (\(aq) für dezimale Umwandlungen. Dies legt fest, dass die Eingabezahl einen Tausendertrenner wie in der Kategorie B<LC_NUMERIC> der aktuellen Locale definiert enthalten kann (siehe B<setlocale>(3)). Das Maskierungszeichen kann dem »*«-Zuweisungsunterdrückungszeichen folgen oder ihm vorangehen.

note: type: Plain text
en: An optional \(aqm\(aq character.  This is used with string conversions (I<%s>, I<%c>, I<%[>), and relieves the caller of the need to allocate a corresponding buffer to hold the input: instead, B<scanf>()  allocates a buffer of sufficient size, and assigns the address of this buffer to the corresponding I<pointer> argument, which should be a pointer to a I<char\ *> variable (this variable does not need to be initialized before the call).  The caller should subsequently B<free>(3)  this buffer when it is no longer required.
de: ein optionales »m«-Zeichen. Dies wird mit Zeichenkettenumwandlungen benutzt (I<%s>, I<%c>, I<%[>) und entlastet den Aufrufenden von der Notwendigkeit, einen zugehörigen Puffer zu reservieren, der die Eingabe erhält: Stattdessen reserviert B<scanf>() einen Puffer von ausreichender Größe und weist die Adresse dieses Puffers dem zugehörigen I<Zeiger>-Argument zu, das ein Zeiger auf eine I<char\ *>-Variable sein sollte. (Diese Variable muss nicht vor dem Aufruf initialisiert werden.) Der Aufrufende sollte diesen Puffer danach mit B<free>(3) freigeben, wenn er nicht länger benötigt wird.

note: type: Plain text
en: An optional decimal integer which specifies the I<maximum field width>.  Reading of characters stops either when this maximum is reached or when a nonmatching character is found, whichever happens first.  Most conversions discard initial white space characters (the exceptions are noted below), and these discarded characters don't count toward the maximum field width.  String input conversions store a terminating null byte (\(aq\e0\(aq)  to mark the end of the input; the maximum field width does not include this terminator.
de: eine optionale dezimale Ganzzahl, die die I<maximale Feldbreite> angibt. Das Lesen von Zeichen stoppt entweder wenn dieses Maximum erreicht wurde oder wenn ein unpassendes Zeichen gefunden wurde, je nachdem, was eher auftrat. Die meisten Umwandlungen verwerfen Leerräume am Anfang (die Ausnahmen sind nachfolgend vermerkt). Diese verworfenen Zeichen werden nicht bei der Berechnung der maximalen Feldbreite mitgezählt. Eingabeumwandlung von Zeichenketten speichert ein terminierendes Null-Byte (»\e0«), um das Ende der Eingabe zu kennzeichnen; die maximale Feldbreite enthält dieses Endezeichen nicht.

note: type: Plain text
en: An optional I<type modifier character>.  For example, the B<l> type modifier is used with integer conversions such as B<%d> to specify that the corresponding I<pointer> argument refers to a I<long int> rather than a pointer to an I<int>.
de: ein optionales I<Typ-Änderungszeichen>. Das Typ-Änderungszeichen B<l> wird zum Beispiel bei Ganzzahlumwandlungen, wie B<%d> benutzt, um anzugeben, dass sich das zugehörige I<Zeiger>-Argument auf I<long int> statt auf einen Zeiger vom Typ I<int> bezieht.

note: type: Plain text
en: A I<conversion specifier> that specifies the type of input conversion to be performed.
de: ein I<Umwandlungskennzeichner>, der den Typ der durchzuführenden Eingabeumwandlung angibt.

note: type: Plain text
en: The conversion specifications in I<format> are of two forms, either beginning with \(aq%\(aq or beginning with "B<%>I<n>B<$>".  The two forms should not be mixed in the same I<format> string, except that a string containing "B<%>I<n>B<$>" specifications can include B<%%> and B<%*>.  If I<format> contains \(aq%\(aq specifications, then these correspond in order with successive I<pointer> arguments.  In the "B<%>I<n>B<$>" form (which is specified in POSIX.1-2001, but not C99), I<n> is a decimal integer that specifies that the converted input should be placed in the location referred to by the I<n>-th I<pointer> argument following I<format>.
de: Die Umwandlungsspezifikationen in I<format> haben zwei Formen, entweder mit »%« oder mit »B<%>I<n>B<$>« beginnend. Die beiden Formen sollten nicht in der gleichen Formatzeichenkette gemischt werden, außer dass eine Zeichenkette die »B<%>I<n>B<$>«-Spezifikationen enthält B<%%> und B<%*> umfassen kann. Falls I<format> »%«-Spezifikationen enthält, dann korrespondieren diese in der Reihenfolge mit nachfolgenden I<Zeiger>-Argumenten. In der Form »B<%>I<n>B<$>« (die in POSIX.1-2001, aber nicht in C99 spezifiziert ist), ist I<n> eine dezimale Ganzzahl, die anzeigt, dass die umgewandelte Eingabe  an die Stelle platziert werden sollte, auf die sich das dem I<n>ten I<Zeiger>-Argument folgende I<format> bezieht.

note: type: SS
en: Conversions
de: Umwandlungen

note: type: Plain text
en: The following I<type modifier characters> can appear in a conversion specification:
de: Die folgenden I<Typ-Änderungszeichen> können in einer Umwandlungsspezifikation erscheinen:

note: type: Plain text
en: Indicates that the conversion will be one of B<d>, B<i>, B<o>, B<u>, B<x>, B<X>, or B<n> and the next pointer is a pointer to a I<short int> or I<unsigned short int> (rather than I<int>).
de: zeigt an, dass die Umwandlung entweder B<d>, B<i>, B<o>, B<u>, B<x>, B<X> oder B<n> sein wird und der nächste Zeiger ein Zeiger auf ein I<short int> oder I<unsigned short int> (statt I<int>) sein wird.

note: type: Plain text
en: As for B<h>, but the next pointer is a pointer to a I<signed char> or I<unsigned char>.
de: wie für B<h>, aber der nächste Zeiger ist ein Zeiger auf ein I<signed char> oder ein I<unsigned char>.

note: type: Plain text
en: As for B<h>, but the next pointer is a pointer to an I<intmax_t> or a I<uintmax_t>.  This modifier was introduced in C99.
de: wie für B<h>, aber der nächste Zeiger ist ein Zeiger auf ein I<intmax_t> oder ein I<uintmax_t>. Dieses Änderungszeichen wurde in C99 eingeführt.

note: This use of l was introduced in Amendment 1 to ISO C90. type: Plain text
en: Indicates either that the conversion will be one of B<d>, B<i>, B<o>, B<u>, B<x>, B<X>, or B<n> and the next pointer is a pointer to a I<long int> or I<unsigned long int> (rather than I<int>), or that the conversion will be one of B<e>, B<f>, or B<g> and the next pointer is a pointer to I<double> (rather than I<float>).  Specifying two B<l> characters is equivalent to B<L>.  If used with B<%c> or B<%s>, the corresponding parameter is considered as a pointer to a wide character or wide-character string respectively.
de: zeigt an, dass die Umwandlung entweder B<d>, B<i>, B<o>, B<u>, B<x>, B<X> oder B<n> sein wird und der nächste Zeiger ein Zeiger auf ein I<long int> oder ein I<unsigned long int> (statt I<int>) sein wird oder dass die Umwandlung entweder B<e>, B<f> oder B<g> sein wird und der nächste Zeiger ein Zeiger auf ein I<double> (statt I<float> ) sein wird. Die Angabe von zwei B<l>-Zeichen ist äquivalent zu B<L>. Falls sie zusammen mit B<%c> oder B<%s> benutzt werden, wird der zugehörige Parameter als ein Zeiger auf ein Wide-Character beziehungsweise eine Wide-Character-Zeichenkette betrachtet.

note: MTK, Jul 05: The following is no longer true for modern ANSI C (i.e., C99): (Note that long long is not an ANSI C type. Any program using this will not be portable to all architectures). type: Plain text
en: Indicates that the conversion will be either B<e>, B<f>, or B<g> and the next pointer is a pointer to I<long double> or the conversion will be B<d>, B<i>, B<o>, B<u>, or B<x> and the next pointer is a pointer to I<long long>.
de: zeigt an, dass die Umwandlung entweder B<e>, B<f> oder B<g> sein wird und der nächste Zeiger ein Zeiger auf ein I<long double> ist oder dass die Umwandlung entweder B<d>, B<i>, B<o>, B<u> oder B<x> sein wird und der nächste Zeiger ein Zeiger auf ein I<long long> sein wird.

note: type: Plain text
en: equivalent to B<L>.  This specifier does not exist in ANSI C.
de: ist äquivalent zu B<L>. Dieser Kennzeichner existiert in ANSI-C nicht.

note: type: Plain text
en: As for B<h>, but the next pointer is a pointer to a I<ptrdiff_t>.  This modifier was introduced in C99.
de: wie für B<h>, der nächste Zeiger ist aber ein Zeiger auf ein I<ptrdiff_t>. Dieses Änderungszeichen wurde in C99 eingeführt.

note: type: Plain text
en: As for B<h>, but the next pointer is a pointer to a I<size_t>.  This modifier was introduced in C99.
de: wie für B<h>, der nächste Zeiger ist aber ein Zeiger auf ein I<size_t>. Dieses Änderungszeichen wurde in C99 eingeführt.

note: type: Plain text
en: The following I<conversion specifiers> are available:
de: Die folgenden I<Umwandlungskennzeichner> sind verfügbar:

note: type: Plain text
en: Matches a literal \(aq%\(aq.  That is, B<%\&%> in the format string matches a single input \(aq%\(aq character.  No conversion is done (but initial white space characters are discarded), and assignment does not occur.
de: passt zum Buchstabensymbol »%«. Das heißt, B<%\&%> im Formatstring passt zum einzelnen Eingabezeichnen »%«. Es findet keine Umwandlung statt (aber Leerräume am Anfang werden verworfen) und eine Zuweisung tritt nicht auf.

note: type: Plain text
en: Matches an optionally signed decimal integer; the next pointer must be a pointer to I<int>.
de: passt zu einer optionalen vorzeichenbehafteten dezimalen Ganzzahl; der nächste Zeiger muss ein Zeiger auf I<int> sein.

note: type: Plain text
en: Equivalent to I<ld>; this exists only for backward compatibility.  (Note: thus only in libc4.  In libc5 and glibc the B<%D> is silently ignored, causing old programs to fail mysteriously.)
de: äquivalent zu B<ld>; dies existiert nur aus Gründen der Rückwärtskompatibilität. (Beachten Sie, dass dies daher nur in Libc4 der Fall ist. In Libc5 und Glibc wird das B<%D> stillschweigend ignoriert, was alte Programme zu mysteriösem Fehlschlagen veranlasst.)

note: type: Plain text
en: Matches an optionally signed integer; the next pointer must be a pointer to I<int>.  The integer is read in base 16 if it begins with I<0x> or I<0X>, in base 8 if it begins with I<0>, and in base 10 otherwise.  Only characters that correspond to the base are used.
de: passt zu einer optionalen vorzeichenbehafteten Ganzzahl; der nächste Zeiger muss ein Zeiger auf I<int> sein. Die Ganzzahl wird zur Basis 16 gelesen, wenn sie mit I<0x> oder I<0X> beginnt, zur Basis 8, wenn sie mit I<0> beginnt, anderenfalls zur Basis 10. Nur Zeichen, die zur Basis passen, werden benutzt.

note: type: Plain text
en: Matches an unsigned octal integer; the next pointer must be a pointer to I<unsigned int>.
de: passt zu einer vorzeichenlosen oktalen Ganzzahl; der nächste Zeiger muss ein Zeiger auf ein I<unsigned int> sein.

note: type: Plain text
en: Matches an unsigned decimal integer; the next pointer must be a pointer to I<unsigned int>.
de: passt zu einer vorzeichenlosen dezimalen Ganzzahl; der nächste Zeiger muss ein Zeiger auf ein I<unsigned int> sein.

note: type: Plain text
en: Matches an unsigned hexadecimal integer; the next pointer must be a pointer to I<unsigned int>.
de: passt zu einer vorzeichenlosen hexadezimalen Ganzzahl; der nächste Zeiger muss ein Zeiger auf ein I<unsigned int> sein.

note: type: Plain text
en: Equivalent to B<x>.
de: äquivalent zu B<x>

note: type: Plain text
en: Matches an optionally signed floating-point number; the next pointer must be a pointer to I<float>.
de: passt zu einer optionalen vorzeichenbehafteten Fließkommazahl; der nächste Zeiger muss ein Zeiger auf ein I<float> sein.

note: type: Plain text
en: Equivalent to B<f>.
de: äquivalent zu B<f>.

note: type: Plain text
en: (C99) Equivalent to B<f>.
de: (C99) äquivalent zu B<f>.

note: type: Plain text
en: Matches a sequence of non-white-space characters; the next pointer must be a pointer to the initial element of a character array that is long enough to hold the input sequence and the terminating null byte (\(aq\e0\(aq), which is added automatically.  The input string stops at white space or at the maximum field width, whichever occurs first.
de: passt zu einer Zeichenfolge, die keinen Leerraum darstellt; der nächste Zeiger muss Zeiger auf das erste Element eines Zeichenfelds sein, das groß genug ist, um die Eingabesequenz und das abschließende Null-Byte (»\e0«), das automatisch hinzugefügt wird, aufnehmen zu können. Die Eingabezeichenkette stoppt an Leerräumen oder an der maximalen Feldgröße, je nachdem, was zuerst auftritt.

note: type: Plain text
en: Matches a sequence of characters whose length is specified by the I<maximum field width> (default 1); the next pointer must be a pointer to I<char>, and there must be enough room for all the characters (no terminating null byte is added).  The usual skip of leading white space is suppressed.  To skip white space first, use an explicit space in the format.
de: passt zu einer Zeichenfolge, deren Länge durch die I<maximale Feldgröße> (Vorgabe 1) angegeben wird; der nächste Zeiger muss ein Zeiger auf ein I<char> sein und es muss genug Platz für alle Zeichen vorhanden sein (es wird keine abschließende Null angehängt.) Das übliche Überspringen der führenden Leerräume wird unterdrückt. Benutzen Sie ein explizites Leerzeichen im Format, um Leerräume zu überspringen .

note: type: Plain text
en: Matches a nonempty sequence of characters from the specified set of accepted characters; the next pointer must be a pointer to I<char>, and there must be enough room for all the characters in the string, plus a terminating null byte.  The usual skip of leading white space is suppressed.  The string is to be made up of characters in (or not in) a particular set; the set is defined by the characters between the open bracket B<[> character and a close bracket B<]> character.  The set I<excludes> those characters if the first character after the open bracket is a circumflex (B<^>).  To include a close bracket in the set, make it the first character after the open bracket or the circumflex; any other position will end the set.  The hyphen character B<-> is also special; when placed between two other characters, it adds all intervening characters to the set.  To include a hyphen, make it the last character before the final close bracket.  For instance, B<[^]0-9-]> means the set "everything except close bracket, zero through nine, and hyphen".  The string ends with the appearance of a character not in the (or, with a circumflex, in) set or when the field width runs out.
de: passt zu einer nicht leeren Abfolge von Zeichen aus der angegebenen Zusammenstellung akzeptierter Zeichen; der nächste Zeiger muss ein Zeiger auf I<char> sein und genug Platz für alle Zeichen der Zeichenkette einschließlich abschließendem Null-Byte bieten. Das übliche Überspringen der führenden Leerräume wird unterdrückt. Die Zeichenkette soll aus Zeichen in einer (oder keiner) besonderen Zusammenstellung bestehen; die Zusammenstellung wird durch die Zeichen zwischen der öffnenden B<[> und schließenden B<]> Klammer definiert. Die Zusammenstellung I<schließt> jene Zeichen I<aus>, wenn das erste Zeichen nach der öffnenden Klammer ein Zirkumflex (B<^>) ist. Um der Zusammenstellung eine schließende Klammer hinzuzufügen, setzen Sie sie als erstes Zeichen nach der öffnenden Klammer oder dem Zirkumflex; jede andere Position würde die Zusammenstellung beenden. Um einen Bindestrich einzufügen, setzen Sie ihn als letztes Zeichen vor der schließenden Klammer am Ende. B<[^]0-9-]> bedeutet zum Beispiel, die Zusammenstellung »alles außer schließender Klammer, null bis neun und Bindestrich«. Die Zeichenkette endet mit dem Erscheinen eines nicht in der Zusammenstellung enthaltenen Zeichens (oder mit einem enthaltenen Zirkumflex) oder wenn die Feldgröße erschöpft ist.

note: type: Plain text
en: Matches a pointer value (as printed by B<%p> in B<printf>(3); the next pointer must be a pointer to a pointer to I<void>.
de: passt zu einem Zeigerwert (wie durch »%p« in B<printf>(3) ausgegeben); der nächste Zeiger muss ein Zeiger auf I<void> sein.

note: type: Plain text
en: Nothing is expected; instead, the number of characters consumed thus far from the input is stored through the next pointer, which must be a pointer to I<int>.  This is I<not> a conversion and does I<not> increase the count returned by the function.  The assignment can be suppressed with the B<*> assignment-suppression character, but the effect on the return value is undefined.  Therefore B<%*n> conversions should not be used.
de: es wird nichts erwartet; stattdessen wird die Anzahl der Zeichen, die bis jetzt eingelesen wurden, im nächsten Zeiger gespeichert, welcher ein Zeiger auf I<int> sein muss. Dies ist I<keine> Umwandlung und erhöht I<nicht> die von der Funktion zurückgegebene Anzahl. Die Zuweisung kann durch das Zuweisungsunterdrückungszeichen B<*> unterdrückt werden, die Auswirkung auf den Rückgabewert ist jedoch nicht definiert. Daher sollten keine B<%*n>-Umwandlungen benutzt werden.

note: type: SH
en: RETURN VALUE
de: RÜCKGABEWERT

note: type: Plain text
en: On success, these functions return the number of input items successfully matched and assigned; this can be fewer than provided for, or even zero, in the event of an early matching failure.
de: Bei Erfolg geben diese Funktionen die Anzahl der Eingabeelemente zurück, die erfolgreich übereinstimmten und zugewiesen wurden. Dies können weniger sein, als bereitgestellt wurden oder null, wenn ein früherer Abgleich scheiterte.

note: type: Plain text
en: The value B<EOF> is returned if the end of input is reached before either the first successful conversion or a matching failure occurs.  B<EOF> is also returned if a read error occurs, in which case the error indicator for the stream (see B<ferror>(3))  is set, and I<errno> is set to indicate the error.
de: Der Wert B<EOF> wird zurückgegeben, wenn das Ende der Eingabe erreicht wird, bevor entweder die erste erfolgreiche Umwandlung oder das erste Fehlschlagen eines Abgleichs auftrat. B<EOF> wird auch zurückgegeben, wenn ein Lesefehler auftritt. In diesem Fall wird die Fehleranzeige für den Datenstrom gesetzt (siehe B<ferror>(3)) und I<errno> so gesetzt, dass es den Fehler angibt.

note: type: SH
en: ERRORS
de: FEHLER

note: type: Plain text
en: The file descriptor underlying I<stream> is marked nonblocking, and the read operation would block.
de: Der Dateideskriptor, der I<datenstrom> zugrundeliegt, ist als nicht blockierend gekennzeichnet und die Leseaktion würde blockieren.

note: type: Plain text
en: The file descriptor underlying I<stream> is invalid, or not open for reading.
de: Der Dateideskriptor, der I<datenstrom> zugrundeliegt, ist ungültig oder nicht zum Lesen geöffnet.

note: type: Plain text
en: Input byte sequence does not form a valid character.
de: Eingabebyte-Abfolge bildet kein gültiges Zeichen

note: type: Plain text
en: The read operation was interrupted by a signal; see B<signal>(7).
de: Die Leseaktion wurde durch ein Signal unterbrochen; siehe B<signal>(7).

note: type: Plain text
en: Not enough arguments; or I<format> is NULL.
de: nicht genug Argumente oder I<format> ist NULL

note: type: Plain text
en: Out of memory.
de: Speicher aufgebraucht.

note: type: Plain text
en: The result of an integer conversion would exceed the size that can be stored in the corresponding integer type.
de: Das Ergebnis einer Ganzzahl-Umwandlung würde die Größe überschreiten, die in dem zugehörigen Ganzzahl-Typ gespeichert werden könnte.

note: type: SH
en: ATTRIBUTES
de: ATTRIBUTE

note: type: Plain text
en: For an explanation of the terms used in this section, see B<attributes>(7).
de: Siehe B<attributes>(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

note: type: tbl table
en: Interface
de: Schnittstelle

note: type: tbl table
en: Attribute
de: Attribut

note: type: tbl table
en: Value
de: Wert

note: type: tbl table
en: Thread safety
de: Multithread-Fähigkeit

note: type: SH
en: CONFORMING TO
de: KONFORM ZU

note: type: Plain text
en: The functions B<fscanf>(), B<scanf>(), and B<sscanf>()  conform to C89 and C99 and POSIX.1-2001.  These standards do not specify the B<ERANGE> error.
de: Die Funktionen B<fscanf>(), B<scanf>() und B<sscanf>() sind konform zu c89, C99 und POSIX.1-2001. Diese Vorgaben spezifizieren nicht den Fehler B<ERANGE>.

note: type: Plain text
en: The B<q> specifier is the 4.4BSD notation for I<long long>, while B<ll> or the usage of B<L> in integer conversions is the GNU notation.
de: Der Kennzeichner B<q> ist die 4.4BSD-Schreibweise für I<long long>, während B<ll> oder die Benutzung von B<L> in Ganzzahlumwandlungen die GNU-Schreibweise ist.

note: type: Plain text
en: The Linux version of these functions is based on the I<GNU> I<libio> library.  Take a look at the I<info> documentation of I<GNU> I<libc (glibc-1.08)> for a more concise description.
de: Die Linuxversion dieser Funktionen basiert auf der I<GNU>-Bibliothek I<libio> Eine präzisere Beschreibung findet sich in der I<info>-Dokumentation von I<GNU> I<libc (glibc-1.08).>

note: type: SH
en: NOTES
de: ANMERKUNGEN

note: type: SS
en: The 'a' assignment-allocation modifier
de: Der Zuweisungs- und Reservierungsmodifikator »a«

note: type: Plain text
en: Originally, the GNU C library supported dynamic allocation for string inputs (as a nonstandard extension) via the B<a> character.  (This feature is present at least as far back as glibc 2.0.)  Thus, one could write the following to have B<scanf>()  allocate a buffer for an input string, with a pointer to that buffer being returned in I<*buf>:
de: Ursprünglich unterstützte die GNU-C-Bibliothek die dynamische Reservierung für Eingabezeichenketten (als eine Nichtstandarderweiterung) über das Zeichen B<a>. (Diese Funktionalität ist bis mindestens Glibc 2.0 zurück verfügbar.) Daher könnte jemand das Folgende schreiben, um B<scanf>() einen Puffer für eine Eingabezeichenkette reservieren zu lassen. Ein Zeiger auf diesen Puffer wird in I<*buf> zurückgegeben:

note: type: Plain text
en: The use of the letter B<a> for this purpose was problematic, since B<a> is also specified by the ISO C standard as a synonym for B<f> (floating-point input).  POSIX.1-2008 instead specifies the B<m> modifier for assignment allocation (as documented in DESCRIPTION, above).
de: Die Verwendung des Buchstabens B<a> für diesen Zweck war problematisch, da B<a> auch im ISO-C-Standard als andere Bezeichnung für B<f> (Fließkommaeingabe) spezifiziert ist. POSIX.1-2008 spezifiziert stattdessen den Modifikator B<m> für die Zuweisungsreservierung (wie oben unter BESCHREIBUNG dokumentiert).

note: type: Plain text
en: Note that the B<a> modifier is not available if the program is compiled with I<gcc -std=c99> or I<gcc -D_ISOC99_SOURCE> (unless B<_GNU_SOURCE> is also specified), in which case the B<a> is interpreted as a specifier for floating-point numbers (see above).
de: Beachten Sie, dass der Modifikator B<a> nicht verfügbar ist, falls das Programm mit I<gcc -std=c99> oder I<gcc -D_ISOC99_SOURCE> kompiliert wurde (außer wenn auch B<_GNU_SOURCE> angegeben wurde). In diesem Fall wird B<a> als Kennzeichner für Fließkommazahlen interpretiert (siehe oben).

note: type: Plain text
en: Support for the B<m> modifier was added to glibc starting with version 2.7, and new programs should use that modifier instead of B<a>.
de: Ab Version 2.7 wurde Glibc Unterstützung für dem Modifikator B<m> hinzugefügt. Neue Programme sollten diesen Modifikator anstelle von B<a> benutzen.

note: type: Plain text
en: As well as being standardized by POSIX, the B<m> modifier has the following further advantages over the use of B<a:>
de: Neben der Standardisierung durch POSIX, hat der Modifikator B<m> auch die folgenden Vorteile gegenüber der Verwendung von B<a:>

note: type: Plain text
en: It may also be applied to B<%c> conversion specifiers (e.g., B<%3mc>).
de: Es könnte auch auf B<%c>-Umwandlungskennzeichner angewandt werden (z.B. B<%3mc>).

note: type: Plain text
en: It avoids ambiguity with respect to the B<%a> floating-point conversion specifier (and is unaffected by I<gcc -std=c99> etc.).
de: Es vermeidet Mehrdeutigkeit bezüglich der Umwandlungskennzeichner für Fließkommazahlen B<%a> (und wird nicht von I<gcc -std=c99> etc. beeinflusst).

note: type: SH
en: BUGS
de: FEHLER

note: type: Plain text
en: All functions are fully C89 conformant, but provide the additional specifiers B<q> and B<a> as well as an additional behavior of the B<L> and B<l> specifiers.  The latter may be considered to be a bug, as it changes the behavior of specifiers defined in C89.
de: Alle Funktionen sind vollkommen konform zu C89, stellen jedoch die zusätzlichen Kennzeichner B<q> und B<a> sowie ein zusätzliches Verhalten des Kennzeichners B<L> und B<l> zur Verfügung. Letzteres kann als Fehler angesehen werden, da es das Verhalten der Kennzeichner verändert, die in C89 definiert sind.

note: type: Plain text
en: Some combinations of the type modifiers and conversion specifiers defined by ANSI C do not make sense (e.g., B<%Ld>).  While they may have a well-defined behavior on Linux, this need not to be so on other architectures.  Therefore it usually is better to use modifiers that are not defined by ANSI C at all, that is, use B<q> instead of B<L> in combination with B<d>, B<i>, B<o>, B<u>, B<x>, and B<X> conversions or B<ll>.
de: Einige Kombinationen von Typänderungssymbolen und Umwandlungskennzeichner, die durch ANSI-C definiert sind, sind sinnlos (z.B. B<%Ld>). Während sie ein wohldefiniertes Verhalten unter Linux haben, braucht dies auf anderen Architekturen nicht der Fall zu sein. Daher ist es gewöhnlich besser Änderungssymbole zu benutzen, die gar nicht durch ANSI-C definiert sind, also B<q> anstelle von B<L> in Kombination mit der Umwandlungen B<d>, B<i>, B<o>, B<u>, B<x> und B<X> oder B<ll>.

note: type: Plain text
en: The usage of B<q> is not the same as on 4.4BSD, as it may be used in float conversions equivalently to B<L>.
de: Die Benutzung von B<q> ist nicht die gleiche wie auf 4.4BSD, da sie in Fließkommaumwandlungen äquivalent zu B<L> benutzt werden kann.

note: type: SH
en: EXAMPLE
de: BEISPIEL

note: type: Plain text
en: To use the dynamic allocation conversion specifier, specify B<m> as a length modifier (thus B<%ms> or B<%m[>I<range>B<]>).  The caller must B<free>(3)  the returned string, as in the following example:
de: Um den Kennzeichner für die dynamische Reservierungsumwandlung zu verwenden, geben Sie als Längenmodifikator B<m> an (also B<%ms> oder B<%m[>I<Bereich>B<]>). Der Aufrufende muss die zurückgegebene Zeichenkette mit B<free>(3), wie im folgenden Beispiel, freigeben:

note: type: Plain text
en: errno = 0;
    n = scanf("%m[a-z]", &p);
    if (n == 1) {
        printf("read: %s\en", p);
        free(p);
    } else if (errno != 0) {
        perror("scanf");
    } else {
        fprintf(stderr, "No matching characters\en");
    }
de: errno = 0;
    n = scanf("%m[a-z]", &p);
    if (n == 1) {
        printf("read: %s\en", p);
        free(p);
    } else if (errno != 0) {
        perror("scanf");
    } else {
        fprintf(stderr, "Keine passenden Zeichen\en");
    }

note: type: Plain text
en: As shown in the above example, it is necessary to call B<free>(3)  only if the B<scanf>()  call successfully read a string.
de: Wie im vorstehenden Beispiel gezeigt, ist es nur nötig B<free>(3) aufzurufen, wenn der Aufruf von B<scanf>() eine Zeichenkette erfolgreich gelesen hat.

note: type: SH
en: SEE ALSO
de: SIEHE AUCH

note: type: SH
en: COLOPHON
de: KOLOPHON

note: type: Plain text
en: This page is part of release 5.03 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
de: Diese Seite ist Teil der Veröffentlichung 5.03 des Projekts Linux-I<man-pages>. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter \%https://www.kernel.org/doc/man-pages/.

note: type: Plain text
en: This page is part of release 5.02 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
de: Diese Seite ist Teil der Veröffentlichung 5.02 des Projekts Linux-I<man-pages>. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter \%https://www.kernel.org/doc/man-pages/.

note: type: Plain text
en: This page is part of release 5.01 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
de: Diese Seite ist Teil der Veröffentlichung 5.01 des Projekts Linux-I<man-pages>. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter \%https://www.kernel.org/doc/man-pages/.
