std:: vwscanf, std:: vfwscanf, std:: vswscanf

Correspond à un caractère ou à une séquence de caractères.

• Si un spécificateur de largeur est utilisé, correspond exactement à largeur caractères larges (l’argument doit être un pointeur vers un tableau avec suffisamment de place).
• Contrairement à %s et  %[, n’ajoute pas le caractère nul à la fin du tableau.

Correspond à une séquence de caractères non blancs (une chaîne).

• Si un spécificateur de largeur est utilisé, correspond jusqu’à largeur ou jusqu’au premier caractère blanc, selon ce qui apparaît en premier.
• Stocke toujours un caractère nul en plus des caractères correspondants (donc le tableau d’argument doit avoir la place pour au moins largeur+1 caractères).

Correspond à une séquence non vide de caractères de l’ensemble de caractères.

• Si le premier caractère de l’ensemble est ^, alors tous les caractères n’étant pas dans l’ensemble sont mis en correspondance.
• Si l’ensemble commence par ] ou ^] alors le caractère ] est également inclus dans l’ensemble.
• La question de savoir si le caractère - en position non initiale dans l’ensemble de balayage peut indiquer une plage, comme dans [0-9], est définie par l’implémentation.
• Si un spécificateur de largeur est utilisé, ne correspond qu’à largeur au maximum.
• Stocke toujours un caractère nul en plus des caractères correspondants (donc le tableau d’argument doit avoir la place pour au moins largeur+1 caractères).

Correspond à un entier décimal.

• Le format du nombre est le même que celui attendu par std::wcstol avec la valeur 10 pour l’argument base.

Correspond à un entier binaire non signé.

• Le format du nombre est le même que celui attendu par std::wcstoul avec la valeur 2 pour l’argument base.

Correspond à un entier.

• Le format du nombre est le même que celui attendu par std::wcstol avec la valeur 0 pour l’argument base (la base est déterminée par les premiers caractères analysés).

Correspond à un entier décimal non signé.

• Le format du nombre est le même que celui attendu par std::wcstoul avec la valeur 10 pour l’argument base.

Correspond à un entier octal non signé.

• Le format du nombre est le même que celui attendu par std::wcstoul avec la valeur 8 pour l’argument base.

Correspond à un entier hexadécimal non signé.

• Le format du nombre est le même que celui attendu par std::wcstoul avec la valeur 16 pour l’argument base.

Retourne le nombre de caractères lus jusqu’à présent.

• Aucune entrée n’est consommée. N’incrémente pas le compteur d’affectations.
• Si le spécificateur a un opérateur de suppression d’affectation défini, le comportement est indéfini.

Correspond à un nombre à virgule flottante.

• Le format du nombre est le même que celui attendu par std::wcstof.

Correspond à une séquence de caractères définie par l’implémentation désignant un pointeur.

• printfLes fonctions de la famille %p devraient produire la même séquence en utilisant le spécificateur de format

Pour chaque spécificateur de conversion autre que n, la plus longue séquence de caractères d’entrée qui ne dépasse aucune largeur de champ spécifiée et qui est soit exactement ce que le spécificateur de conversion attend, soit un préfixe d’une séquence qu’il attendrait, est ce qui est consommé du flux. Le premier caractère, s’il y en a un, après cette séquence consommée reste non lu. Si la séquence consommée a une longueur nulle ou si la séquence consommée ne peut pas être convertie comme spécifié ci-dessus, l’échec de correspondance se produit sauf si la fin de fichier, une erreur d’encodage ou une erreur de lecture empêche l’entrée depuis le flux, auquel cas il s’agit d’un échec d’entrée.

Sauf pour le spécificateur %, l’élément d’entrée (ou, pour %n, le nombre de caractères d’entrée) est d’abord converti en un type approprié au spécificateur de conversion. Sauf si l’affectation a été supprimée avec *, le résultat de la conversion est écrit dans l’objet pointé par l’argument suivant qui n’a pas encore été écrit. Si cet objet n’a pas un type approprié, ou si le résultat de la conversion ne peut pas être représenté dans l’objet, le comportement est indéfini.

Tous les spécificateurs de conversion sauf [, c et n consomment et ignorent tous les caractères blancs de début (déterminés comme en appelant std::iswspace) avant de tenter d’analyser l’entrée. Ces caractères consommés ne comptent pas dans la largeur de champ maximale spécifiée.

Si le spécificateur de longueur l n’est pas utilisé, les spécificateurs de conversion c, s et [ effectuent une conversion de caractères larges en multi-octets comme en appelant std::wcrtomb avec un objet std::mbstate_t initialisé à zéro avant la conversion du premier caractère.

Les spécificateurs de conversion s et [ stockent toujours le terminateur nul en plus des caractères correspondants. La taille du tableau de destination doit être au moins supérieure d’un à la largeur de champ spécifiée. L’utilisation de %s ou %[, sans spécifier la taille du tableau de destination, est aussi dangereuse que std::gets.

Les spécifications de conversion correctes pour les types entiers à largeur fixe (std::int8_t, etc.) sont définies dans l’en-tête <cinttypes> (bien que SCNdMAX, SCNuMAX, etc. soient synonymes de %jd, %ju, etc.).

Il y a un point de séquence après l’action de chaque spécificateur de conversion ; cela permet de stocker plusieurs champs dans la même variable « réceptacle ».

Lors de l’analyse d’une valeur à virgule flottante incomplète qui se termine par l’exposant sans chiffres, comme l’analyse de "100er" avec le spécificateur de conversion %f, la séquence "100e" (le plus long préfixe d’un nombre à virgule flottante possiblement valide) est consommée, entraînant une erreur de correspondance (la séquence consommée ne peut pas être convertie en nombre à virgule flottante), avec "r" restant. Certaines implémentations existantes ne suivent pas cette règle et reviennent pour ne consommer que "100", laissant "er", par exemple bogue glibc 1765.

Si une spécification de conversion est invalide, le comportement est indéfini.