.\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Chris Torek and the American National Standards Committee X3, .\" on Information Processing Systems. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" @(#) fgets. 3 8.1 (Berkeley) 6/4/93 .\" .\" %FreeBSD: src/lib/libc/stdio/fgets. 3, v 1.6. 2.6 2001/12/14 18:33:57 ru Exp % .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/fgets. 3, v 1.5 2002/05/18 07:12:54 horikawa Exp $ .\" .Dd June 4, 1993 .Dt FGETS 3 .Os .Sh 명칭 .Nm fgets , .Nm gets .Nd 스트림로부터 행을 취득 .Sh 서식 .In stdio.h .Ft char * .Fn fgets "char *str" "int size" "FILE *stream" .Ft char * .Fn gets "char *str" .Sh 해설 .Fn fgets 함수는, 최대로 .Fa size 그리고 지정된 캐릭터수부터 1 만 적은 수의 캐릭터를 .Fa stream (으)로부터 읽어들여, 캐릭터 라인 .Fa str 에 보존합니다. 독포함은, 개행 캐릭터가 발견되거나 파일의 종료 혹은 에러가 발견되거나 했을 경우에 정지합니다. 개행 캐릭터는, 존재하고 있으면 보관 유지됩니다. 임의의 캐릭터를 읽어들여 에러가 발생하지 않았던 경우, 캐릭터 라인의 마지막에는 .Ql \e0 캐릭터가 추가됩니다. .Pp .Fn gets 함수는 .Fn fgets 함수로 .Fa size (을)를 무한하게 해, .Em stdin (을)를 .Fa stream (으)로 한 것과 등가입니다만, 캐릭터 라인중에서 개행 캐릭터가 보존되지 않는 (개행 캐릭터가 존재했을 경우) 점이 다릅니다. 입력행이 존재하는 경우, 그것이 충분히 짧게 캐릭터 라인에 완전히 해결된다 일을 프로텍션하는 것은 호출측의 책임입니다. .Sh 반환값 정상 종료하면(자), .Fn fgets (와)과 .Fn gets (은)는 캐릭터 라인의 포인터를 되돌립니다. 캐릭터를 읽어들이기 전에 파일의 종료에 이르면(자), .Dv NULL 하지만 되돌려집니다. 이 경우, 버퍼의 내용은 변화하지 않습니다. 에러가 발생하면(자) .Dv NULL 하지만 되돌려져 버퍼의 내용은 부정이 됩니다. .Fn fgets 함수와 .Fn gets 함수는 파일의 종료와 에러를 구별하지 않습니다. 파일의 종료인가 에러인지를 판단하려면 , 호출측이 .Xr feof 3 (와)과 .Xr ferror 3 (을)를 사용하지 않으면 안됩니다. .Sh 에러 .Bl -tag -width Er .It Bq Er EBADF 지정되었다 .Fa stream 하지만, 독 붐비어 가능한 스트림이 아닙니다. .El .Pp .Fn fgets 함수가 에러가 되면(자), routine .Xr fflush 3 , .Xr fstat 2 , .Xr read 2 , .Xr malloc 3 용으로 지정된 에러중 한쪽이 .Va errno (으)로 설정되는 경우가 있습니다. .Pp .Fn gets 함수가 에러가 되면(자), routine .Xr getchar 3 용으로 지정된 에러가 .Va errno (으)로 설정되는 경우가 있습니다. .Sh 관련 항목 .Xr feof 3 , .Xr ferror 3 , .Xr fgetln 3 .Sh 표준 .Fn fgets 함수와 .Fn gets 함수는, .St -isoC 에 적합하고 있습니다. .Sh 버그 통상, 다음의 입력행이 있는 임의의 길이보다 짧은 일을 프로텍션하는 것은 불가능하고, 또 입력 버퍼를 오버플로우 하면(자) 거의 반드시 보안 위반이 되기 (위해)때문에, 프로그램에서는 .Fn gets (을)를 .Em 절대로 사용하지 말아 주세요. .Fn gets (은)는, .St -isoC 에 적합하기 위해(때문에)인 만큼 존재하고 있습니다.