.\" 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. .\" 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. .\" .\" @(#) funopen. 3 8.1 (Berkeley) 6/9/93 .\" %FreeBSD: src/lib/libc/stdio/funopen. 3, v 1.7. 2.4 2001/12/14 18:33:57 ru Exp % .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/funopen. 3, v 1.4 2002/05/18 07:12:54 horikawa Exp $ .\" .Dd June 9, 1993 .Dt FUNOPEN 3 .Os .Sh 명칭 .Nm funopen , .Nm fropen , .Nm fwopen .Nd 스트림의 오픈 .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In stdio.h .Ft FILE * .Fn funopen "const void *cookie" "int (*readfn)(void *, char *, int)" "int (*writefn)(void *, const char *, int)" "fpos_t (*seekfn)(void *, fpos_t, int)" "int (*closefn)(void *)" .Ft FILE * .Fn fropen "void *cookie" "int (*readfn)(void *, char *, int)" .Ft FILE * .Fn fwopen "void *cookie" "int (*writefn)(void *, const char *, int)" .Sh 해설 .Fn funopen 함수는, 스트림을 최대 4 개(살)의 .Dq Tn I/O No 함수 에 관련짓습니다. .Fa readfn 인가 .Fa writefn 의 어느 쪽인지는 반드시 지정하지 않으면 안됩니다. 그 이외의 개소에는 적당한 형태의 .Dv NULL 포인터를 줄 수가 있습니다. 이러한 .Tn I/O 함수는, 새로운 스트림에 대한다 독 붐비어, 기록, 시크, 클로우즈를 위해서(때문에) 사용됩니다. .Pp 통상, 함수를 생략 했다고 하는 것은, 작성된 스트림에 관련지을 수 있었던 조작을 실행하면(자) 실패하는, 그렇다고 하는 것을 의미하고 있습니다. 클로우즈 함수가 생략 되고 있는 경우는, 스트림을 닫으면(자) 버퍼링 되고 있는 출력이 플래시 되어 성공해 종료합니다. .Pp .Fa readfn , .Fa writefn , .Fa seekfn , .Fa closefn 의 호출 규칙은, 각각 .Xr read 2 , .Xr write 2 , .Xr seek 2 , .Xr lseek 2 , .Xr close 2 의 것과 같습니다만, 통상 파일 기술자 인수가 놓여지는 장소에, .Fn funopen (으)로 지정되었다 .Fa cookie 인수가 건네받는다고 하는 차이가 있습니다. .Pp 독포함 및 기록 .Tn I/O 함수는, .Xr setvbuf 3 (을)를 호출하는 것에 의해, 완전하게 버퍼링 된 혹은 행 단위로 버퍼링 된 스트림의 기초가 되는 버퍼를 변경하는 것이 허가되고 있습니다. 버퍼를 완전하게 채우거나 완전하게 비우거나 하는 것까지는 요구되지 않습니다. 그러나, 버퍼링되어 있지 않은 상태로부터 버퍼링 된 상태로 변경하거나 행 버퍼의 플래그 상태를 변경하거나 하는 것은 허가되고 있지 않습니다. 최근 지정된 이외의 버퍼에 대해서 독포함이나 기록의 호출이 발생하기로 준비해 둘 필요가 있습니다. .Pp 모든 유저 .Tn I/O 함수는,\-1 을 돌려주는 것으로 에러를 보고할 수가 있습니다. 게다가 에러가 발생했을 경우, 모든 함수는 외부 변수 .Va errno (을)를 적절히 설정할 필요가 있습니다. .Pp .Fn closefn 에서의 에러는, 스트림을 연 상태에는 보관 유지하지 않습니다. .Pp 편의를 꾀하기 위해, 인클루드 파일 .Aq Pa stdio.h 그럼, .Fn funopen (을)를 독 붐비어 또는 기록 함수만을 지정해 호출할 때와 같은, .Fn fropen 매크로와 .Fn fwopen 매크로가 정의되고 있습니다. .Sh 반환값 성공해 종료하면(자), .Fn funopen 하 .Dv FILE 포인터를 돌려줍니다. 그 이외의 경우에서는 .Dv NULL 하지만 돌려주어져 에러를 나타내는 값이 글로벌 변수 .Va errno (으)로 설정됩니다. .Sh 에러 .Bl -tag -width Er .It Bq Er EINVAL .Fn funopen 함수가, 독포함 함수 또는 기록 함수의 어느쪽이나 지정되지 않고 불려 갔습니다. .Fn funopen 함수는 실패했을 때에 .Xr malloc 3 routine를 위해서(때문에) 지정된 에러를 .Va errno (으)로 설정하는 일도 있습니다. .El .Sh 관련 항목 .Xr fcntl 2 , .Xr open 2 , .Xr fclose 3 , .Xr fopen 3 , .Xr fseek 3 , .Xr setbuf 3 .Sh 역사 .Fn funopen 함수는 .Bx 4.4 그리고 처음 등장했습니다. .Sh 버그 .Fn funopen 함수는 .Bx 이외의 시스템에는 이식 가능하지 않을지도 모릅니다.