cciMbsToUcs

Converts multi-byte string data to Universal Character Set (UCS).

Syntax

int cciMbsToUcs(
  int*         returnCode,
  const char*  mbString,
  CciChar*     ucsString,
  int          ucsStringLength,
  int          codePage);

Parameters

returnCode
The return code from the function (output).
mbString
The string to be converted, expressed as 'file code' (input).
ucsString
The location of the resulting UCS-2 Unicode string (input). This has a trailing CciChar of 0, just as the mbString has a trailing byte of 0.
ucsStringLength
The length (in CciChars) of the buffer that you have provided (input). Each byte in mbString expands to not more than one CciChar and this defines an upper limit for the buffer size required.
codePage
The code page of the source string (input). '1208' (meaning code page ibm-1208, which is UTF-8 Unicode) is a good choice if you are using cciMbsToUcs on an ASCII system to convert string constants for processing by WebSphere Business Integration Message Broker.

Return values

The converted length in half-words (UCS-2 characters).

Related concepts
User-defined extensions

Related tasks
Creating an input node in C
Creating a message processing node in C
Creating a parser in C

Related reference
User-defined extensions
cciUcsToMbs