ungetwc
| Types and objects | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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) |
|
|
(C95)
|
obtient un caractère large depuis un flux de fichier
(fonction) |
|
Documentation C++
pour
ungetwc
|
|