The ifx_gl_wcscat() function

Syntax

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

wcs1

A pointer to the wide-character string to which the function concatenates wcs2.

wcs1_char_length

The integer number of characters in the wcs1 string. If wcs1_char_length is the value IFX_GL_NULL, the function assumes that wcs1 is a null-terminated string.

wcs2

A pointer to the wide-character string to concatenate onto wcs1.

wcs2_char_length

The integer number of characters in the wcs2 string. If wcs2_char_length is the value IFX_GL_NULL, the function assumes that wcs2 is a null-terminated string.

Usage

The ifx_gl_wcscat() function appends a copy of wcs2 to the end of wcs1. If wcs1 and wcs2 overlap, the results of this function are undefined.

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