ifx_gl_wcscat

ifx_gl_wcscat - concatenate two wide-character strings

SYNOPSIS

#include <ifxgls.h>
int ifx_gl_wcscat(gl_wchar_t *wcs1, int wcs1_char_length, gl_wchar_t *wcs2, int wcs2_char_length)

DESCRIPTION

This function appends a copy of wcs2 to the end of wcs1. If wcs1 and wcs2 overlap, the results of this function are undefined.

If wcs1_char_length is the value IFX_GL_NULL then the function will assume that wcs1 is a null-terminated string; otherwise the function assumes that wcs1_char_length is the number of characters in wcs1. If wcs2_char_length is the value IFX_GL_NULL then the function will assume that wcs2 is a null-terminated string; otherwise the function assumes that wcs2_char_length is the number of characters in wcs2. See Wide-Character String Termination for more general information about these lengths.

RETURN VALUE

This function returns the number of characters in the resulting concatenated string, not including the null terminator, if any.

ERRORS

If an error has occurred, this function returns NULL and sets ifx_gl_lc_errno() to one of the following,

[IFX_GL_PARAMERR]: Either wcs1_char_length is not equal to IFX_GL_NULL and is not greater than or equal to zero, or wcs2_char_length is not equal to IFX_GL_NULL and is not greater than or equal to zero.
[IFX_GL_TERMMISMAT]: Either wcs1_char_length is equal to IFX_GL_NULL and wcs2_char_length is greater than or equal to zero or wcs1_char_length is greater than or equal to zero and wcs2_char_length is equal to IFX_GL_NULL

ACKNOWLEDGEMENT