ifx_gl_wcsncat

ifx_gl_wcsncat - concatenate part of one wide-character string to another

SYNOPSIS

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

DESCRIPTION

This function appends wcs2 to the end of wcs1. No more than char_limit characters will be read from wcs2 and written to 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