_ungetc_nolock, _ungetwc_nolock

Renvoie un caractère vers le flux sans verrouillage.

Syntaxe

int _ungetc_nolock(
   int c,
   FILE *stream
);
wint_t _ungetwc_nolock(
   wint_t c,
   FILE *stream
);

Paramètres

c
Caractère à renvoyer (transmission push).

stream
Pointeur vers la structure FILE .

Valeur retournée

En cas de réussite, chacune de ces fonctions retourne l’argument de caractère c. Si c ne peut pas être renvoyé ou si aucun caractère n’a été lu, le flux d’entrée reste inchangé et _ungetc_nolock retourne EOF ; _ungetwc_nolock retourne WEOF. Si stream a la valeur NULL, EOF ou WEOF est retourné et errno prend la valeur EINVAL.

Pour plus d’informations sur ces codes et d’autres codes d’erreur, consultez errno, _doserrno, _sys_errlist et _sys_nerr.

Notes

Ces fonctions sont les versions sans verrouillage de ungetc et ungetwc. Les versions avec le suffixe _nolock sont identiques, à ceci près qu’elles ne sont pas protégées contre les interférences par d’autres threads. Elles peuvent être plus rapides, car elles n’entraînent pas de surcharge liée au verrouillage des autres threads. Utilisez ces fonctions uniquement dans les contextes thread-safe, tels que les applications à un seul thread ou lorsque la portée appelante gère déjà l'isolation des threads.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Mappages de routines de texte générique

Spécifications

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Voir aussi

E/S de flux
getc, getwc
putc, putwc