strncollen 서브루틴

온라인 편집

용도

지정된 문자열에 대한 데이터 정렬 값의 수를 반환합니다.

라이브러리

표준 C 라이브러리(libc.a)

구문

include <string.h>

int strncollen ( String,  Number)
const char *String;
const int Number;

설명

Strncollen 서브루틴은 String 매개변수가 가리키는 지정된 문자열에 대한 데이터 정렬 값의 수를 반환합니다. 데이터 정렬 값의 개수는 Null 문자가 발견되거나 Number 매개변수로 표시된 바이트 수를 검사한 경우 종료됩니다.

데이터 정렬 값은 LC_COLLATE 카테고리에 대한 setlocale 서브루틴에 의해 설정됩니다. 예를 들어 로캘이 'ch'가 하나의 데이터 정렬 값을 갖는 LC_COLLATE 범주에 대해 Es_ES(스페인에서 사용되는 스페인어)로 설정되어 있는 경우 strncollen ('abchd', 5)은 4를 반환합니다.

독일어에서 <Sharp-S> 문자는 두 개의 콜레이션 값을 가지므로 다음 예제에서 <Sharp-S> 문자를 B로 대입하면 strncollen이 됩니다 ('straBa', 6)7을 반환합니다.

문자에 데이터 정렬 값이 없는 경우 데이터 정렬 길이는 0입니다.

매개변수

항목 설명
번호 검사할 문자열의 바이트 수입니다.
문자열 데이터 정렬 값을 검사할 문자열에 대한 포인터입니다.

리턴 값

성공적으로 완료되면 strncollen 서브루틴은 String 매개변수가 가리키는 지정된 문자열에 대한 데이터 정렬 값을 반환합니다.