ifx_gl_wcspbrk

ifx_gl_wcspbrk -- find wide-character in wide-character string

SYNOPSIS

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

DESCRIPTION

This function searches for the first occurrence in the wide-character string wcs1 of any wide-character from the string wcs2.

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 pointer to the first occurrence in wcs1 of any character from wcs2. If no character in wcs2 is not found in wcs1, then this function returns NULL and sets ifx_gl_lc_errno() to zero.

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