The ifx_gl_wcsncat() function
The ifx_gl_wcsncat() function concatenates a specified number of wide characters in one wide-character string to another.
Syntax
#include <ifxgls.h>
...
int ifx_gl_wcsncat(wcs1, wcs1_char_length, wcs2, wcs2_char_length, char_limit)
gl_wchar_t *wcs1;
int wcs1_char_length;
gl_wchar_t *wcs2;
int wcs2_char_length;
int char_limit;
- 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 to 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.
- char_limit
- The maximum number of wide characters to read from wcs2.
Valid in client application | Valid in DataBlade® UDR |
---|---|
Yes | Yes |
Usage
The ifx_gl_wcsncat() function appends wcs2 to the end of wcs1. If wcs1 and wcs2 overlap, the results of this function are undefined. The function reads no more than char_limit characters from wcs2 and writes them to wcs1.
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
If an error occurred, this function
returns -1 and sets the ifx_gl_lc_errno() error
number to one of the following values.
- IFX_GL_PARAMERR
- Either wcs1_char_length is not equal to IFX_GL_NULL and is not greater than or equal to 0, or wcs2_char_length is not equal to IFX_GL_NULL and is not greater than or equal to 0.
- IFX_GL_TERMMISMAT
- Either wcs1_char_length is equal to IFX_GL_NULL, and wcs2_char_length is greater than or equal to 0; or wcs1_char_length is greater than or equal to 0, and wcs2_char_length is equal to IFX_GL_NULL.