IVEndofLine
line end 문자를 주어진 end-of-line 타입으로 변환합니다.
long IVEndofLine ( const char* pChars, long nChars, char* pNewChars, long maxNewChars, EOLType targetEOL = Platform_EOLType );
파라미터
- pChars
- [in] 입력 문자열입니다.
- nChars
-
[in] pChars 파라미터가 가리키는 문자열의 바이트 단위 크기를 지정하거나, 문자열이 null로 끝나면 CStringLen이 될 수 있습니다.
만약 이 문자열이 null로 끝나면, 결과로 나오는 character 타입 문자열은 null terminator를 갖습니다. 그리고 리턴된 길이는 null terminator를 포함하고 있습니다.
만약 이 파라미터가 양의 정수이면, 이 함수는 정확하게 지정한 수의 바이트들을 처리합니다. 만약 주어진 길이가 null terminator를 포함하지 않는다면, 결과로 나오는 wide character 문자열은 null로 끝나지 않게 되며, 리턴된 길이는 null terminator를 포함하지 않습니다.
- pNewChars
- [out] 출력 문자열에 대한 버퍼입니다.
- maxNewChars
-
[in] pNewChars 파라미터가 가리키는 버퍼의 바이트 단위 크기를 지정합니다. 만약 이 값이 0이면, 이 함수는 필요한 버퍼 크기를 바이트 단위로 리턴하고 pNewChars 버퍼를 사용하지 않습니다.
- targetEOL=Platform_EOLType
- 대상 line end 포맷입니다.
리턴 값
만약 함수가 성공하고 maxNewChars가 0이 아니면, 리턴 값은 pNewChars가 가리킨 버퍼에 작성된 바이트들의 수입니다.
만약 함수가 성공하고 maxNewChars가 0이면, 리턴 값은 변환된 문자열을 수신할 수 있는 버퍼에 대한 요청된 바이트 단위 크기입니다.
만약 함수가 실패하면 리턴 값은 0입니다. 이 함수는 파라미터들이 올바르지 않거나 제공된 버퍼가 변환을 수행하기에 너무 작으면 실패하게 됩니다.
설명
pChars와 pNewChars 포인터들은 동일하거나 중첩되어서는 안 됩니다. 그렇게 했을 때의 결과는 정의되어 있지 않습니다!
요구사항
- 버전: GSRoot 1.3 또는 이후
- 헤더: CH.hpp
- 라이브러리 가져오기: GSRootImp.lib
- 모듈: GSRoot