Manpages

•

Une séquence de caractères blancs (espace, tabulation, nouvelle ligne, etc. ; consultez isspace(3)). Cette directive correspond à un nombre quelconque de caractères blancs, y compris aucun, dans l’entrée.

•

Un caractère ordinaire (c’est-à-dire autre qu’un caractère blanc et que le caractère « % ». Ce caractère doit exactement correspondre au caractère suivant de l’entrée.

•

Une spécification de conversion qui débute avec le caractère « % ». Une séquence de caractères de l’entrée est convertie conformément à la spécification et le résultat est placé dans l’argument pointeur correspondant. Si l’élément suivant de l’entrée ne correspond pas à la spécification de conversion, la conversion échoue — c’est un échec de correspondance.

•

Un caractère d’affectation-suppression optionnel « * » : scanf() lit l’entrée comme indiqué par la spécification de conversion mais ne tient pas compte de l’entrée. Aucun argument pointeur n’est nécessaire et cette spécification n’est pas comptabilisée dans le nombre d’affectations réussies renvoyé par scanf().

•

For decimal conversions, an optional quote character ('). This specifies that the input number may include thousands’ separators as defined by the LC_NUMERIC category of the current locale. (See setlocale(3).) The quote character may precede or follow the '*' assignment-suppression character.

•

Un caractère « m » optionnel. Il est utilisé dans les conversions de chaînes (%s, %c, %[) et soulage l’appelant du besoin d’allouer un tampon correspondant pour conserver l’entrée : à la place, scanf() alloue un tampon de taille suffisante et affecte l’adresse de ce tampon à l’argument pointeur correspondant qui doit être un pointeur vers une variable char * (il n’est pas nécessaire que cette variable soit initialisée avant l’appel). L’appelant doit par la suite libérer (free(3)) ce tampon lorsqu’il devient inutile.

•

Un entier décimal optionnel qui indique la taille maximum du champ. La lecture des caractères s’arrête soit lorsque ce maximum est atteint, soit lorsque on trouve un caractère qui ne correspond pas, celui qui arrive le premier. La plupart des conversions abandonnent les caractères blancs de tête (les exceptions sont notées plus loin), et ces caractère abandonnés n’entrent pas en compte dans la taille maximale du champ. Les conversions d’entrée de chaînes stocke un octet nul (« \0 ») final pour marquer la fin de l’entrée ; la largeur maximale du champ n’inclut pas ce caractère de terminaison.

•

Un caractère modificateur de type optionnel. Par exemple, le modificateur de type l est utilisé avec les conversions d’entrée telles que %d pour spécifier que l’argument pointeur correspondant fait référence à un long int plutôt qu’à un pointeur sur un int.

•

Un spécificateur de conversion qui spécifie le type de conversion d’entrée à effectuer.

h

Indique que la conversion sera de type d, i, o, u, x, X ou n et que le pointeur suivant est un pointeur sur un short int ou un unsigned short int (plutôt que sur un int).

hh

Comme pour h, sauf que le pointeur suivant est un pointeur sur un signed char ou un unsigned char.

j

Comme pour h, sauf que le pointeur suivant est un pointeur sur un intmax_t ou un uintmax_t. Ce modificateur a été introduit dans C99.

l

Indique que la conversion sera de type d, i, o, u, x, X ou n et que le pointeur suivant est un pointeur sur un long int ou un unsigned long int (plutôt que sur un int), ou que la conversion sera de type e, f ou g et que le pointeur suivant est un pointeur sur un double (plutôt que sur un float). Indiquer deux caractères l successifs est équivalent à indiquer L. Si c’est utilisé avec %c ou %s, le paramètre correspondant est considéré, respectivement, comme un pointeur vers un caractère large ou une chaîne de caractères larges.

L

Indique que la conversion sera de type e, f ou g et que le pointeur suivant est un pointeur sur un long double ou que la conversion sera de type d, i, o, u, ou x et que le pointeur suivant est un pointeur sur un long long.

q

est équivalent à L. Ce spécificateur n’existe pas en C ANSI.

t

Comme pour h, mais le pointeur suivant est un pointeur vers un ptrdiff_t. Ce modificateur a été introduit dans C99.

z

Comme pour h, mais le pointeur suivant est un pointeur vers un size_t. Ce modificateur a été introduit dans C99.

%

Correspond à un caractère « % ». Ceci signifie qu’un spécificateur %% dans la chaîne de format correspond à un seul caractère « % » dans la chaîne d’entrée. Aucune conversion (mais les caractères blancs de début sont ignorés), et aucune assignation n’a lieu.

d

Correspond à un entier décimal éventuellement signé, le pointeur correspondant doit être un pointeur vers un int.

i

Correspond à un entier éventuellement signé. Le pointeur suivant doit être du type int. L’entier est en base 16 (hexadécimal) s’il commence par 0x ou 0X, en base 8 (octal) s’il commence par un 0, et en base 10 sinon. Seuls les caractères correspondants à la base concernée sont utilisés.

o

Correspond à un entier octal non signé. Le pointeur correspondant doit être un pointeur vers un unsigned int.

u

Correspond à un entier décimal non signé. Le pointeur suivant doit être un pointeur vers un unsigned int.

x

Matches an unsigned hexadecimal integer (that may optionally begin with a prefix of 0x or 0X, which is discarded); the next pointer must be a pointer to unsigned int.

X

Équivalent à x

f

Correspond à un nombre réel éventuellement signé. Le pointeur correspondant doit être un pointeur vers un float.

e

Équivalent à f.

g

Équivalent à f.

E

Équivalent à f.

a

(C99) Équivalent à f.

s

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 ('\0'), which is added automatically. The input string stops at white space or at the maximum field width, whichever occurs first.

c

Correspond à une séquence de caractères dont la longueur est spécifiée par la largeur maximum de champ (par défaut 1). Le pointeur suivant doit être un pointeur vers un char, et il doit y avoir suffisamment de place dans la chaîne pour tous les caractères. Aucun octet nul final n’est ajouté. Les caractères blancs de début ne sont pas supprimés. Si on veut les éliminer, il faut utiliser une espace dans le format.

[

Correspond à une séquence non vide de caractères appartenant à un ensemble donné. Le pointeur correspondant doit être un pointeur vers un char et il doit y avoir suffisamment de place dans le tableau de caractères pour accueillir la chaîne ainsi qu’un octet nul final. Les caractères blancs du début ne sont pas supprimés. La chaîne est constituées de caractères inclus ou exclus d’un ensemble donné. L’ensemble est composé des caractères compris entre les deux crochets [ et ]. L’ensemble exclut ces caractères si le premier après le crochet ouvrant est un accent circonflexe (^). Pour inclure un crochet fermant dans l’ensemble, il suffit de le placer en première position après le crochet ouvrant, ou l’accent circonflexe ; à tout autre emplacement il servira à terminer l’ensemble. Le caractère tiret - a également une signification particulière. Quand il est placé entre deux autres caractères, il ajoute à l’ensemble les caractères intermédiaires. Pour inclure un tiret dans l’ensemble, il faut le placer en dernière position avant le crochet fermant. Par exemple, [^]0-9-] correspond à l’ensemble « Tout sauf le crochet fermant, les chiffres de 0 à 9, et le tiret ». La chaîne se termine dès l’occurrence d’un caractère exclu (ou inclus s’il y à un accent circonflexe ) de l’ensemble, ou dès qu’on atteint la longueur maximale du champ.

p

Matches a pointer value (as printed by %p in printf(3)); the next pointer must be a pointer to a pointer to void.

n

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 int. This is not a conversion and does not increase the count returned by the function. The assignment can be suppressed with the * assignment-suppression character, but the effect on the return value is undefined. Therefore %*n conversions should not be used.

EAGAIN

Le descripteur de fichier stream sous-jacent est non bloquant et l’opération de lecture bloquerait.

EBADF

Le descripteur de fichier stream sous-jacent n’est pas valide ou bien n’est pas ouvert en lecture.

EILSEQ

La séquence d’octet en entrée ne constitue pas un caractère valable.

EINTR

La lecture a été interrompue par un signal ; consultez signal(7).

EINVAL

Pas suffisamment de paramètres ; ou bien format est NULL.

ENOMEM

Plus assez de mémoire.

ERANGE

Le résultat de la conversion entière est plus grand que la taille pouvant être stockée dans le type entier correspondant.

*

Il peut être appliqué aux spécificateurs de conversion %c (par exemple %3mc).

*

Il lève toute ambiguité avec le spécificateur de conversion en virgule flottante %a (et n’est pas affecté par gcc -std=c99 etc.).