The ifx_gl_wcswcs() function
The ifx_gl_wcswcs() function searches for a specified substring within a wide-character string.
Syntax
#include <ifxgls.h>
...
gl_wchar_t *ifx_gl_wcswcs(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 search for the substring 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 substring to search for in 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.
Valid in client application | Valid in DataBlade® UDR |
---|---|
Yes | Yes |
Usage
The ifx_gl_wcswcs() function searches for the first occurrence of the wide-character string wcs2 in the wide-character string wcs1.
Return values
- gl_wchar_t *
- A pointer to the first byte of the first occurrence of wcs2 in wcs1.
- NULL
- Either wcs2 was not found in wcs1 (the ifx_gl_lc_errno() error number is set to 0); or 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 NULL 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.