ifx_gl_wcsrchr

ifx_gl_wcsrchr - search for the last occurrence of a character in a string

SYNOPSIS

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

DESCRIPTION

This function locates the last 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 last occurrence of wc in the wide character string 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