unlocked_stdio

Autres langues

Langue: ja

Version: 2007-07-26 (fedora - 25/11/07)

Section: 3 (Bibliothèques de fonctions)

名前

getc_unlocked, getchar_unlocked, putc_unlocked, putchar_unlocked, - ロックを行わずに標準入出力を行う関数群

書式

 #include <stdio.h>
 
 int getc_unlocked(FILE *stream);
 int getchar_unlocked(void);
 int putc_unlocked(int c, FILE *stream);
 int putchar_unlocked(int c);
 
 #define _BSD_SOURCE /* or _SVID_SOURCE */
 #include <stdio.h>
 
 void clearerr_unlocked(FILE *stream);
 int feof_unlocked(FILE *stream);
 int ferror_unlocked(FILE *stream);
 int fileno_unlocked(FILE *stream);
 int fflush_unlocked(FILE *stream);
 int fgetc_unlocked(FILE *stream);
 int fputc_unlocked(int c, FILE *stream);
 size_t fread_unlocked(void *ptr, size_t size, size_t n,
         FILE *stream);
 size_t fwrite_unlocked(const void *ptr, size_t size, size_t n,
         FILE *stream);
 
 #define _GNU_SOURCE
 #include <stdio.h>
 
 char *fgets_unlocked(char *s, int n, FILE *stream);
 int fputs_unlocked(const char *s, FILE *stream);
 
 #define _GNU_SOURCE
 #include <wchar.h>
 
 wint_t getwc_unlocked(FILE *stream);
 wint_t getwchar_unlocked(void);
 wint_t fgetwc_unlocked(FILE *stream);
 wint_t fputwc_unlocked(wchar_t wc, FILE *stream);
 wint_t putwc_unlocked(wchar_t wc, FILE *stream);
 wint_t putwchar_unlocked(wchar_t wc);
 wchar_t *fgetws_unlocked(wchar_t *ws, int n, FILE *stream);
 int fputws_unlocked(const wchar_t *ws, FILE *stream);
 

説明

これらの関数は、末尾に `_unlocked' がついていない関数と同じ動作をするが、 ファイルのロックを使用しない点が異なる。(これらの関数自身はファイルのロック をセットせず、他の関数によってロックがセットされているかどうかのチェックも 行わない) それゆえ、スレッド(thread)で安全に使用することができない。 flockfile(3) を参照のこと。

準拠

getc_unlocked(), getchar_unlocked(), putc_unlocked(), putchar_unlocked() の 4 つの関数は POSIX.1-2001 に規定されている。

非標準の *_unlocked() の仲間は 2、3 の Unix システムで定義されており、 最近の glibc では使用可能であるが、 これらの関数は使わない方がよいだろう。

関連項目

flockfile(3), stdio(3), feature_test_macros(7)