cciUcsToMbs

UCS(Universal Character Set) 데이터를 다중 바이트 문자열 데이터로 변환합니다. 일반적으로 이 함수는 진단 메시지를 형식화하는 데에만 사용됩니다. 모든 언어의 모든 문자를 표현할 수 있는 UCS-2로 처리했을 때 정상 처리가 최적으로 수행됩니다.

샘플 코드(BipSampPluginUtil.c)에서는 UCS-2 문자를 이식 가능한 방식으로 처리하기 위한 추가 유틸리티를 보여줍니다.

구문

int cciUcsToMbs(
    int*                   returnCode,
    const CciChar* ucsString,
    char*          mbString,
    int            mbStringLength,
    int            codePage);

매개변수

returnCode
함수의 리턴 코드(출력).

가능한 리턴 코드는 다음과 같습니다.
  • CCI_SUCCESS
  • CCI_BUFFER_TOO_SMALL
  • CCI_INV_CHARACTER
  • CCI_FAILURE
  • CCI_INV_CODEPAGE
ucsString
UCS-2 유니코드로 표현된 변환 대상 문자열(입력).
mbString
결과로 표시되는 문자열 위치(입력). 유니코드에 후미 문자 CciChar 0이 있는 것처럼 문자열에 후미 문자 바이트 0이 있습니다.
mbStringLength
제공한 버퍼 길이(바이트 단위)(입력). 소스 문자열의 각 CciChar은 1바이트(SBCS 코드 페이지의 경우) 또는 코드 페이지의 MB_CUR_MAX 값(일반적으로 5바이트 미만)까지 확장될 수 있습니다.
codePage
결과로 표시되는 문자열 코드 페이지(입력). 코드 페이지의 값은 사용자 정의 노드를 컴파일하는 데 사용할 컴파일러에 적합해야 합니다.

ASCII 시스템에서는 cciUcsToMbs를 사용하여 WebSphere Message Broker가 처리할 문자열 상수를 변환할 경우 1208 값(UTF-8 유니코드인 코드 페이지 ibm-1208)을 선택하는 것이 좋습니다. Linux, UNIX 및 Windows 플랫폼의 경우에는 1208이 적절합니다.

Linux 및 UNIX에서 nl_langinfo(CODEPAGE)setlocale을 통해 선택한 코드 페이지를 제공합니다.

OS/390 및 z/OS에서는 WebSphere MQ의 디폴트 코드 페이지인 500을 사용할 수 없습니다. 대신 코드 페이지 값 1047을 사용해야 합니다.

리턴 값

변환된 길이(바이트 단위).

주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
as08556_