Namespaces
Variants

ungetwc

From cppreference.net
< c ‎ | io
Défini dans l'en-tête <wchar.h>
wint_t ungetwc ( wint_t ch, FILE * stream ) ;
(depuis C95)

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 dispositif externe associé au flux n'est pas modifié.

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

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

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

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

Un appel réussi à 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 ungetwc .

Table des matières

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é.

Références

  • Norme C11 (ISO/CEI 9899:2011) :
  • 7.29.3.10 La fonction ungetwc (p: 425-426)
  • Norme C99 (ISO/CEI 9899:1999) :
  • 7.24.3.10 La fonction ungetwc (p: 370-371)

Voir aussi

remet un caractère dans un flux de fichier
(fonction)
obtient un caractère large depuis un flux de fichier
(fonction)
Documentation C++ pour ungetwc