std:: ungetwc

Défini dans l'en-tête <cwchar>
std:: wint_t ungetwc ( std:: wint_t ch, std:: FILE * stream ) ;

Si ch n'est pas égal à WEOF , pousse le caractère large ch dans le tampon d'entrée associé au flux stream de telle manière que les opérations de lecture ultérieures sur stream récupéreront ce caractère large. Le périphérique externe associé au flux n'est pas modifié.

Les opérations de repositionnement de flux std::fseek , std::fsetpos , et std::rewind annulent les effets de std::ungetwc .

Si std::ungetwc est appelée plus d'une fois sans lecture ou repositionnement intermédiaire, elle peut échouer (en d'autres termes, une mémoire tampon de rappel de taille 1 est garantie, mais toute taille supérieure est définie par l'implémentation). Si plusieurs appels réussis de std::ungetwc sont effectués, les opérations de lecture récupèrent les caractères larges remis en mémoire dans l'ordre inverse des appels à std::ungetwc

Si ch est égal à WEOF , l'opération échoue et le flux n'est pas affecté.

Un appel réussi à std::ungetwc efface le drapeau de statut de fin de fichier feof .

Un appel réussi à std::ungetwc sur un flux (qu'il soit texte ou binaire) modifie l'indicateur de position du flux de manière non spécifiée, mais garantit qu'après que tous les caractères larges repoussés sont récupérés par une opération de lecture, l'indicateur de position du flux est égal à sa valeur avant std::ungetwc .

Paramètres

ch	-	caractère large à remettre
stream	-	flux de fichier dans lequel remettre le caractère large

Valeur de retour

En cas de succès ch est retourné.

En cas d'échec WEOF est retourné et le flux donné reste inchangé.

Voir aussi

ungetc	replace un caractère dans un flux de fichier (fonction)
fgetwc getwc	obtient un caractère large d'un flux de fichier (fonction)
Documentation C pour ungetwc