The ifx_gl_mbspbrk() function
The ifx_gl_mbspbrk() function searches for any multibyte character from one multibyte string in another multibyte-character string.
Syntax
#include <ifxgls.h>
...
gl_mchar_t *ifx_gl_mbspbrk(mbs1, mbs1_byte_length, mbs2, mbs2_byte_length)
gl_mchar_t *mbs1;
int mbs1_byte_length;
gl_mchar_t *mbs2;
int mbs2_byte_length;- mbs1
- A pointer to the string of multibyte characters to search for the characters in mbs2.
- mbs1_byte_length
- The integer number of bytes in the mbs1 string. If mbs1_byte_length is the value IFX_GL_NULL, the function assumes that mbs1 is a null-terminated string.
- mbs2
- A pointer to the multibyte-character string whose characters the function searches for in mbs1.
- mbs2_byte_length
- The integer number of bytes in the mbs2 string. If mbs2_byte_length is the value IFX_GL_NULL, the function assumes that mbs2 is a null-terminated string.
| Valid in client application | Valid in DataBlade® UDR |
|---|---|
| Yes | Yes |
Usage
The ifx_gl_mbspbrk() function searches for the first occurrence of any multibyte character from the string mbs2 in the multibyte string mbs1.
Return values
- gl_mchar_t *
- A pointer to the first byte of the first occurrence in mbs1 of any character from mbs2.
- NULL
- Either no character in mbs2 was found in mbs1 (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 ifx_gl_lc_errno() to one
of the following values.
- IFX_GL_PARAMERR
- Either mbs1_byte_length is not equal to IFX_GL_NULL and is not greater than or equal to 0, or mbs2_byte_length is not equal to IFX_GL_NULL and is not greater than or equal to 0.
- IFX_GL_TERMMISMAT
- Either mbs1_byte_length is equal to IFX_GL_NULL, and mbs2_byte_length is greater than or equal to 0; or mbs1_byte_length is greater than or equal to 0, and mbs2_byte_length is equal to IFX_GL_NULL.
- IFX_GL_EILSEQ
- Either mbs1 or mbs2 contains an invalid multibyte character.
- IFX_GL_EINVAL
- Either the function cannot determine whether the last character of mbs1 is a valid multibyte character because it would need to read more than mbs1_byte_length bytes from mbs1, or the function cannot determine whether the last character of mbs2 is a valid multibyte character because it would need to read more than mbs2_byte_length bytes from mbs2.