The ifx_gl_mbscat() function

Syntax

#include <ifxgls.h>
...
int ifx_gl_mbscat(mbs1, mbs1_byte_length, mbs2, mbs2_byte_length)
       gl_mchar_t *mbs1;
       int mbs1_byte_length;
       gl_mchar_t *mbs2;
       int mbs2_byte_length;

mbs1

A pointer to the multibyte-character string to which the function concatenates mbs2.

mbs1_byte_length

The integer number of bytes in the mbs1 string. If mbs1_byte_length is the value IFX_GL_NULL, the function assumes that mbs1 is a null-terminated string.

mbs2

A pointer to the multibyte-character string to concatenate onto mbs1.

mbs2_byte_length

The integer number of bytes in the mbs2 string. If mbs2_byte_length is the value IFX_GL_NULL, the function assumes that mbs2 is a null-terminated string.

Usage

The ifx_gl_mbscat() function appends a copy of the mbs2 multibyte-character string to the end of the mbs1 multibyte-character string.

If mbs1 and mbs2 overlap, the results of this function are undefined. If mbs1_byte_length is equal to IFX_GL_NULL, the function null-terminates the concatenated string. Any other value of mbs1_byte_length means that the function does not null-terminate the resulting concatenated string.

Return values

>=0

The number of characters in the concatenated string, not including any null terminator.

-1

The function was not successful, and the error number is set to indicate the cause. See the Errors section.

Errors