.\" 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. .\" .\" @(#) fopen. 3 8.1 (Berkeley) 6/4/93 .\" %FreeBSD: src/lib/libc/stdio/fopen. 3, v 1.7. 2.6 2001/12/14 18:33:57 ru Exp % .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/fopen. 3, v 1.4 2002/05/18 07:12:54 horikawa Exp $ .\" .Dd June 4, 1993 .Dt FOPEN 3 .Os .Sh 명칭 .Nm fopen , .Nm fdopen , .Nm freopen .Nd 스트림을 오픈하는 함수 .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In stdio.h .Ft FILE * .Fn fopen "const char *path" "const char *mode" .Ft FILE * .Fn fdopen "int fildes" "const char *mode" .Ft FILE * .Fn freopen "const char *path" "const char *mode" "FILE *stream" .Sh 해설 .Fn fopen 함수는, .Fa path 하지만 가리키는 캐릭터 라인의 이름을 가지는 파일을 오픈해, 거기에 스트림을 관련짓습니다. .Pp 인수 .Fa mode (은)는, 이하의 순차 순서의 1 개(살)로 시작되는 캐릭터 라인을 가리킵니다 (이 순차 순서에는, 다른 캐릭터가 계속되어도 상관하지 않습니다). .Bl -tag -width indent .It Dq Li r 텍스트 파일을 독포함용으로 오픈합니다. 스트림은, 파일의 최초로 자리매김됩니다. .It Dq Li r+ 독포함용과 기록용으로 오픈합니다. 스트림은, 파일의 최초로 자리매김됩니다. .It Dq Li w 기록용으로, 파일을 길이 0 에 잘라 채우는지, 텍스트 파일을 작성합니다. 스트림은, 파일의 최초로 자리매김됩니다. .It Dq Li w+ 독포함용과 기록용으로 오픈합니다. 파일이 존재하지 않는 경우는 그 파일이 작성되어 존재하는 경우는 잘라 채울 수 있습니다. 스트림은, 파일의 최초로 자리매김됩니다. .It Dq Li a 기록용으로 오픈합니다. 파일이 존재하지 않는 경우는 그 파일이 작성됩니다. 스트림은, 파일의 마지막에 자리매김됩니다. 거기에 계속되는 파일에의 기입은, .Xr fseek 3 (와)과 같은 조작의 개재에 관련되어 없고, 항상 파일의 현시점에서의 최후로 행해집니다. .It Dq Li a+ 독포함용과 기록용으로 오픈합니다. 파일이 존재하지 않는 경우는 그 파일이 작성됩니다. 스트림은, 파일의 마지막에 자리매김됩니다. 거기에 계속되는 파일에의 기입은, .Xr fseek 3 (와)과 같은 조작의 개재에 관련되어 없고, 항상 파일의 현시점에서의 최후로 행해집니다. .El .Pp .Fa mode 캐릭터 라인에는, 3 번째의 캐릭터로서 또는 위에서 설명한 2 캐릭터로부터 되는 캐릭터 라인의 사이로 지정하는 캐릭터로서 캐릭터 ``b''를 포함할 수가 있습니다. 이것은 .St -isoC (와)과의 호환성을 유지하기 위한 것으로, 효과는 없습니다. ``b''는 무시됩니다. .Pp 작성된 파일의 모드는, .Pf \\*q Dv S_IRUSR \&| .Dv S_IWUSR \&| .Dv S_IRGRP \&| .Dv S_IWGRP \&| .Dv S_IROTH \&| .Dv S_IWOTH Ns \\*q .Pq Li 0666 하지만 프로세스의 umask 치 ( .Xr umask 2 참조)로 수정된 것이 됩니다. .Pp 읽고 쓰기 스트림에서는, 독포함과 기록을 어떠한 순서에서도 혼합할 수가 있어 전 버젼의 .Em stdio (와)과 같이, 그러한 사이에 시크 조작은 필요 없습니다. 그렇지만, 이것은 다른 시스템에의 이식성이 없습니다. 그렇다고 하는 것은, .Tn ANSI C (은)는, 입력 오퍼레이션이 파일의 종료에 이르지 않은 경우, 파일 자리 매김 함수가 출력과 입력동안에 개재하는 것을 요구하고 있기 때문입니다. .Pp .Fn fdopen 함수는, 기존의 파일 기술자 .Fa fildes 에 스트림을 관련짓습니다. 스트림의 .Fa mode 에는, 파일 기술자의 모드와의 호환성이 필요합니다. .Xr fclose 3 에 의해 스트림이 닫혀졌을 때에는, .Fa fildes 도 닫혀집니다. .Pp .Fn freopen 함수는, .Fa path 하지만 가리키는 캐릭터 라인의 이름이 붙은 파일을 열어, .Fa stream 하지만 가리키는 스트림을 관련짓습니다. 원래의 스트림이 존재하는 경우, 그것은 닫혀집니다. .Fa mode 인수는, .Fn fopen 함수와 같습니다. .Fn freopen 의 주된 사용 목적은, 표준 텍스트 스트림 .Pf ( Em stderr, .Em stdin .Em stdout ) 에 관련지을 수 있었던 파일을 변환일입니다. .Sh 반환값 호출이 성공하면(자), .Fn fopen, .Fn fdopen, .Fn freopen 하 .Tn FILE 포인터를 돌려줍니다. 문제가 있는 경우는 .Dv NULL (을)를 돌려주어, 그 에러를 나타내는 값을 글로벌 변수 .Va errno (으)로 설정합니다. .Sh 에러 .Bl -tag -width Er .It Bq Er EINVAL .Fn fopen , .Fn fdopen , .Fn freopen 의 .Fa mode 하지만 올바르지는 않습니다. .El .Pp .Fn fopen , .Fn fdopen , .Fn freopen 함수는, 에러가 발생하면(자), routine .Xr malloc 3 그리고 규정된 에러를 .Va errno (으)로 설정하는 일도 있습니다. .Pp .Fn fopen 함수는, 에러가 발생하면(자), routine .Xr open 2 그리고 규정된 에러를 .Va errno (으)로 설정하는 일도 있습니다. .Pp .Fn fdopen 함수는, 에러가 발생하면(자), routine .Xr fcntl 2 그리고 규정된 에러를 .Va errno (으)로 설정하는 일도 있습니다. .Pp .Fn freopen 함수는, 에러가 발생하면(자), routine .Xr open 2 , .Xr fclose 3 , .Xr fflush 3 그리고 규정된 에러를 .Va errno (으)로 설정하는 일도 있습니다. .Sh 관련 항목 .Xr open 2 , .Xr fclose 3 , .Xr fileno 3 , .Xr fseek 3 , .Xr funopen 3 .Sh 표준 .Fn fopen 함수와 .Fn freopen 함수는, .St -isoC 에 적합하고 있습니다. .Fn fdopen 함수는, .St -p1003.1-88 에 적합하고 있습니다.