.\" Copyright (c) 1989, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" Paul Vixie. .\" 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. .\" .\" @(#) bitstring. 3 8.1 (Berkeley) 7/19/93 .\" %FreeBSD: src/share/man/man3/bitstring. 3, v 1.6. 2.5 2001/12/17 11:30:11 ru Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/bitstring. 3, v 1.6 2002/05/18 07:12:52 horikawa Exp $ .\" .Dd July 19, 1993 .Dt BITSTRING 3 .Os .Sh 명칭 .Nm bit_alloc , .Nm bit_clear , .Nm bit_decl , .Nm bit_ffs , .Nm bit_nclear , .Nm bit_nset , .Nm bit_set , .Nm bitstr_size , .Nm bit_test .Nd 비트열조작 매크로 .Sh 서식 .In bitstring.h .Ft bitstr_t * .Fn bit_alloc "int nbits" .Ft void .Fn bit_decl "bitstr_t *name" "int nbits" .Ft void .Fn bit_clear "bitstr_t *name" "int bit" .Ft void .Fn bit_ffc "bitstr_t *name" "int nbits" "int *value" .Ft void .Fn bit_ffs "bitstr_t *name" "int nbits" "int *value" .Ft void .Fn bit_nclear "bitstr_t *name" "int start" "int stop" .Ft void .Fn bit_nset "bitstr_t *name" "int start" "int stop" .Ft void .Fn bit_set "bitstr_t *name" "int bit" .Ft int .Fn bitstr_size "int nbits" .Ft int .Fn bit_test "bitstr_t *name" "int bit" .Sh 해설 이러한 매크로는 비트열을 조작합니다. .Pp 매크로 .Fn bit_alloc (은)는, .Fa nbits 개의 비트를 격납하는데 충분한 공간을 가리키는 형태 .Dq Fa "bitstr_t *" 의 포인터를 돌려줍니다. 또는, 공간을 이용할 수 없는 경우는 .Dv NULL (을)를 돌려줍니다. .Pp 매크로 .Fn bit_decl (은)는, .Fa nbits 개의 비트를 격납하는데 충분한 공간을 스택에 할당합니다. .Pp 매크로 .Fn bitstr_size (은)는, .Fa nbits 개의 비트를 격납하는데 필요한, 형태 .Fa bitstr_t 의 요소의 수를 돌려줍니다. 이것은 비트열을 카피하는데 편리합니다. .Pp 매크로 .Fn bit_clear (와)과 매크로 .Fn bit_set (은)는, 비트열 .Ar name 안의, 0 을 기점으로서 .Fa bit 번째의 비트를 클리어 또는 설정합니다. .Pp 매크로 .Fn bit_nset (와)과 매크로 .Fn bit_nclear (은)는, 비트열 .Ar name 안의 .Fa start (으)로부터 .Fa stop 까지의 (0 을 기점으로서 번호 붙이고 한) 비트를 세트 또는 클리어 합니다. .Pp 매크로 .Fn bit_test (은)는, 비트열 .Ar name 안에서, 0 을 기점으로서 .Fa bit 번째의 비트가 세트 되고 있는 경우, 평가 결과는 0 이 아닌 값이 되어, 그 이외의 경우는 0 으로 평가됩니다. .Pp 매크로 .Fn bit_ffs (은)는, .Ar name 하지만 참조한다 .Fa nbits 비트의 배열 속에서, 세트 된 비트가 최초로 나타나는 위치를 0 을 기점으로서 번호 붙이고 한 값을, .Fa value 하지만 참조하는 위치에 격납합니다. 어느 비트도 설정되어 있지 않은 경우, .Fa value 하지만 참조하는 위치에,\-1 가 설정됩니다. .Pp 매크로 .Fn bit_ffc (은)는, .Ar name 하지만 참조한다 .Fa nbits 비트의 배열 속에서, 세트되어 있지 않은 비트가 최초로 나타나는 위치를, 0 을 기점으로서 번호 붙이고 한 값을, .Fa value 하지만 참조하는 위치에 격납합니다. 어느 비트도 설정되어 있는 경우, .Fa value 하지만 참조하는 위치에,\-1 가 설정됩니다. .Pp 이러한 매크로의 인수는, 1 회만 평가되어 안전한 부작용이 있다 가능성이 있습니다. .Sh 예 .Bd -literal -offset indent #include #include \&... #define LPR_BUSY_BIT 0 #define LPR_FORMAT_BIT 1 #define LPR_DOWNLOAD_BIT 2 \&... #define LPR_AVAILABLE_BIT 9 #define LPR_MAX_BITS 10 make_lpr_available() { bitstr_t bit_decl(bitlist, LPR_MAX_BITS); ... bit_nclear(bitlist, 0, LPR_MAX_BITS - 1); ... if (! bit_test(bitlist, LPR_BUSY_BIT)) { bit_clear(bitlist, LPR_FORMAT_BIT); bit_clear(bitlist, LPR_DOWNLOAD_BIT); bit_set(bitlist, LPR_AVAILABLE_BIT); } } .Ed .Sh 관련 항목 .Xr malloc 3 .Sh 역사 .Nm bitstring 함수는 .Bx 4.4 그리고 처음 등장했습니다. .\" kuma