Man page  — SBUF

sbuf_new() 함수는 최초의 인수로 가리켜진다 sbuf (을)를 초기화합니다. 그 포인터가 NULL 의 경우에는, sbuf_new() 하 struct sbuf 구조체를 malloc(9) (을)를 사용해 할당합니다. buf 인수는 실제로 캐릭터 라인이 격납되는 버퍼에의 포인터로, NULL 의 경우에는, sbuf_new() 하 malloc(9) (을)를 사용해 버퍼를 할당합니다. length (은)는 격납 버퍼의 초기의 크기입니다. 4 번째의 인수 flags (은)는 이하의 플래그로부터 구성될 수 있습니다:

SBUF_FIXEDLEN	격납 버퍼는 초기 사이즈로 고정입니다. 이것을 넘어 sbuf 를 확장하려고 하면(자), 오버플로우 상태가 됩니다.
SBUF_AUTOEXTEND
	이것은, 추가 데이터의 격납을 위해서(때문에) 필요하면, 자원이 허락하는 한에 두어, 격납 버퍼는 확장 가능한 것을 나타냅니다.

buf 하지만 NULL (이)가 아닌 경우에는, 적어도 length 캐릭터 이상의 배열을 가리키지 않으면 안 되는 것에 주의해 주세요. 제공되는 버퍼의 내용은 미정도리입니다. sbuf 데이타를 뽑기 시작하기 위해서(때문에)는, 완료했다 sbuf 에 대해서 sbuf_data() (을)를 호출할 필요가 있습니다.

sbuf_clear() 함수는 sbuf 의 내용을 무효로 해, 위치를 0 에 리셋트 합니다.

sbuf_setpos() 함수는 sbuf 의 종료 위치를, 0 으로 격납 버퍼의 크기보다 1 작은 값의 사이의 값이다 pos (으)로 설정합니다. 결과적으로, 새로운 위치에 있어 sbuf 의 첨단을 잘라 버리게 됩니다.

sbuf_bcat() 함수는 바이트열 str 의 최초의 len 바이트를 sbuf 에 추가합니다.

sbuf_bcopyin() 함수는 명시된 유저 공간 주소로부터 sbuf 에 len 바이트를 카피합니다.

sbuf_bcpy() 함수는 sbuf 의 내용을 바이트열 str 의 최초의 len 바이트로 옮겨놓습니다.

sbuf_cat() 함수는 NUL 캐릭터로 종단 된 캐릭터 라인 str (을)를 sbuf 의 현재 위치에 추가합니다.

sbuf_copyin() 함수는 NUL 캐릭터로 종단 된 캐릭터 라인이 명시된 유저 공간 주소로부터 sbuf 에 카피합니다. len 인수가 0 이 아닌 경우에는 len 캐릭터를 넘지 않는 캐릭터 (종단의 NUL 는 세지 않습니다)가 카피되어 그렇지 않은 경우에는 캐릭터 라인 전체, 또는 sbuf 에 담는 것이 가능한 한의 캐릭터를 카피합니다.

sbuf_cpy() 함수는 sbuf 의 내용을 NUL 캐릭터로 종단 된 캐릭터 라인 str 그리고 옮겨놓습니다. 이것은 새롭다 sbuf 그리고, 또는 sbuf_clear() 인가 sbuf_setpos() 그리고 그 위치를 0 에 리셋트 되고 있다 sbuf 그리고, sbuf_cat() (을)를 호출하는 것으로 등가입니다.

sbuf_printf() 함수는 fmt 에 의해 가리켜지고 있는 포맷 캐릭터 라인에 따라 그 인수를 포맷 해, 그 결과의 캐릭터 라인을 sbuf 의 현재 위치에 추가합니다.

sbuf_vprintf() 함수는 sbuf_printf() (와)과 같게 행동합니다만, 인수가 가변장 인수 리스트 ap (으)로부터 취득되는 것이 다릅니다.

sbuf_putc() 함수는 캐릭터 c (을)를 sbuf 의 현재 위치에 추가합니다.

sbuf_trim() 함수는 말미의 공백을 sbuf (으)로부터 제거합니다.

sbuf_overflowed() 함수는 sbuf 하지만 오버플로우 하고 있는 경우에 0 이외의 값을 돌려줍니다.

sbuf_finish() 함수는 sbuf (을)를 눌로 종단 해, 더 이상 sbuf_setpos(), sbuf_cat(), sbuf_cpy(), sbuf_printf() 또는 sbuf_putc() (을)를 사용해 수정되는 것이 없는 일을 의미하는 완료 마크를 붙입니다.

sbuf_data() 및 sbuf_len() 함수는 각각 현재의 캐릭터 라인과 그 길이를 돌려줍니다. sbuf_data() (은)는 완료했다 sbuf 에 대해서만 기능합니다.

마지막으로, sbuf_delete() 함수는 sbuf (을)를 클리어 해, sbuf_new() 에 의해 격납 버퍼를 할당할 수 있고 있으면, 그것을 해방합니다.