ifx_gl_wcschr

ifx_gl_wcschr - search for the first occurrence of a character in a string

SYNOPSIS

#include <ifxgls.h>
gl_wchar_t *ifx_gl_wcschr(gl_wchar_t *wcs, int wcs_char_length, gl_wchar_t wc)

DESCRIPTION

This function locates the first occurrence of wc in the wide-character string wcs.

If wcs_char_length is the value IFX_GL_NULL then the function will assume that wcs is a null-terminated string; otherwise the function assumes that wcs_char_length is the number of characters in the wide-character string. See Wide-Character String Termination for more general information about wcs_char_length.

RETURN VALUE

This function returns the pointer to the first occurrence of wc in wcs. If wc is not found in wcs, 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]: wcs_char_length is not equal to IFX_GL_NULL and is not greater than or equal to zero.

ACKNOWLEDGEMENT