`fgetws` 함수

fgetws 함수 (fgetws)

좁은 문자열을 한 줄 읽는 fgets의 넓은 문자 버전이 fgetws예요. 넓은 문자(wide character)를 쓰는 프로그램에서 문자열 단위로 입력을 받아야 할 때 사용합니다. wchar_t 배열을 인자로 받는다는 점만 다르고, 동작 방식은 fgets와 거의 같아요.

출처: cppreference

본문

함수 원형

<wchar.h>에 정의돼 있어요. (C95부터)

wchar_t* fgetws( wchar_t* str, int count, FILE* stream );                   // (since C95) (until C99)
wchar_t* fgetws( wchar_t* restrict str, int count, FILE* restrict stream ); // (since C99)

설명 (Explanation)

주어진 파일 스트림에서 최대 count - 1개의 넓은 문자를 읽어 str에 저장해요. 만들어지는 넓은 문자열은 항상 널 종료돼요. 파일 끝에 도달하거나 넓은 개행 문자를 만나면 파싱을 멈추는데, 이 경우 str에는 그 넓은 개행 문자까지 포함돼요.

매개변수 (Parameters)

• str — 문자를 읽어 넣을 넓은 문자열
• count — str의 길이
• stream — 데이터를 읽어올 파일 스트림

반환값 (Return value)

성공하면 str을, 오류가 나면 널 포인터를 돌려줘요.

예제 (Example)

이 문서는 아직 예제가 없는 상태예요 (예제 추가 필요).

같이 보기 (See also)

• wscanf/fwscanf/swscanf — 서식이 있는 넓은 문자 입력
• fgetwc/getwc — 파일 스트림에서 넓은 문자 가져오기
• fputws — 파일 스트림에 넓은 문자열 쓰기