.\" 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 .\" 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. .\" .\" @(#) stdarg. 3 8.1 (Berkeley) 6/5/93 .\" %FreeBSD: src/share/man/man3/stdarg. 3, v 1.4. 2.5 2001/12/17 11:30:11 ru Exp % .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/stdarg. 3, v 1.5 2002/05/18 07:12:56 horikawa Exp $ .\" .Dd June 5, 1993 .Dt STDARG 3 .Os .Sh 명칭 .Nm stdarg .Nd 변수 인수 리스트 .Sh 서식 .In stdarg.h .Ft void .Fn va_start "va_list ap" last .Ft type .Fn va_arg "va_list ap" type .Ft void .Fn va_end "va_list ap" .Sh 해설 함수는 다양한 형태의 다양한 수의 인수로 호출할 수 있습니다. 인클루드 파일 .Aq Pa stdarg.h (은)는, 형태 .Pq Em va_list (을)를 선언해, 불려 가는 함수에는 숫자와 형태가 미지의 인수 리스트를 스텝 하기 위해서 3 개의 매크로를 정의합니다. .Pp 불려 가는 함수는, .Em va_list 형태의 오브젝트를 선언할 필요가 있습니다. 이것은, 매크로 .Fn va_start , .Fn va_arg , .Fn va_end 에 의해 사용됩니다. .Pp .Fn va_start 매크로는, .Fn va_arg (와)과 .Fn va_end 하지만 후에 사용한다 .Fa ap (을)를 초기화해, 최초로 호출할 필요가 있습니다. .Pp 파라미터 .Fa last (은)는 변수 인수 리스트의 전의 마지막 파라미터의 이름입니다. 즉, 호출 함수가 형태를 인식하고 있는 마지막 파라미터입니다. .Pp 이 파라미터의 주소는 .Fn va_start 매크로로 사용되므로, 레지스터 변수 또는 함수 또는 배열형으로서 선언해 되지 않습니다. .Pp .Fn va_start 매크로는 값을 돌려주지 않습니다. .Pp .Fn va_arg 매크로는, 호출의 다음의 인수의 형태와 값이 있는 식에 전개됩니다. 파라미터 .Fa ap (은)는, .Fn va_start 에 의해 초기화된다 .Em va_list Fa ap 입니다. .Fn va_arg (이)가 호출할 것에 .Fa ap (은)는 수정되어 다음의 호출이 다음의 인수를 돌려줍니다. 파라미터 .Fa type (은)는, 지정형의 오브젝트를 가리키는 포인터의 형태가 * 를 .Fa type 에 추가하는 것만으로 얻을 수 있도록(듯이) 지정된 형명입니다. .Pp 다음의 인수가 없는 경우, 또는 .Fa type 하지만 (디폴트의 인수 생성에 따라 생성된 것 같은) 실제의 다음의 인수의 형태와 호환성이 없는 경우, 랜덤인 에러가 발생합니다. .Pp .Fn va_start 매크로의 뒤의 최초의 .Fn va_arg 매크로의 사용에 의해, .Fa last 의 후의 인수가 돌려주어집니다. 연속적인 호출에 의해, 나머지의 인수의 값이 돌려주어집니다. .Pp .Fn va_end 매크로는, 변수 인수 리스트가 .Fn va_start 에 의해 초기화되는 함수의 정상적인 귀가를 취급합니다. .Pp .Fn va_end 매크로는 값을 돌려주지 않습니다. .Sh 사용예 함수 .Em foo (은)는, 형식 캐릭터의 string를 채택해 형태를 기초로 해 각 형식 캐릭터에 대응하는 인수를 인쇄합니다. .Bd -literal -offset indent void foo(char *fmt, ...) { va_list ap; int d; char c, *s; va_start(ap, fmt); while (*fmt) switch(*fmt++) { case 's': /* string */ s = va_arg(ap, char *); printf("string %s\en", s); break; case 'd': /* 정수 */ d = va_arg(ap, int); printf("int %d\en", d); break; case 'c': /* 캐릭터 */ /* 주의: 캐릭터는 정수를 생성한다. */ c = va_arg(ap, int); printf("char %c\en", c); break; } va_end(ap); } .Ed .Sh 표준 .Fn va_start , .Fn va_arg , .Fn va_end 의 각 매크로는 .St -isoC 에 적합하고 있습니다. .Sh 호환성 이러한 매크로는, 옮겨놓을 수 있는 역사적인 매크로와 호환성이 .Em 선 . 후방 호환 버젼은 인클루드 파일 .Aq Pa varargs.h 의 안에 있습니다. .Sh 버그 .Em varargs 매크로와 달리, .Nm 매크로에서는, 프로그래머는, 고정한 인수가 없다 함수를 작성할 수가 없습니다. 이 문제는, 주로 .Em varargs 코드를 .Nm 코드로 변환할 때 작업을 일으키게 합니다만, .Xr vfprintf 3 (와)과 같이, .Em va_list 인수를 취하는 함수에 모든 인수를 건네주려고 하는 각종의 함수에 대해서도 곤란을 생기게 합니다.