ifx_gl_wcscspn - get length of complementary wide-character sub-string
SYNOPSIS
#include <ifxgls.h>
int ifx_gl_wcscspn(gl_wchar_t *wcs1, int wcs1_char_length, gl_wchar_t *wcs2, int wcs2_char_length)
DESCRIPTION
This function returns the number of characters in the maximum initial sub-string of wcs1 which consist entirely of wide-characters not in
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 number of characters in the maximum initial sub-string of wcs1 which consist entirely of wide-characters not in
the string wcs2.
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
SEE ALSO
ifx_gl_wcsspn()
ifx_gl_mbsspn()
ifx_gl_mbscspn()
ACKNOWLEDGEMENT
Portions of this description were derived from the X/Open CAE
Specification: "System Interfaces and Headers, Issue 4"; X/Open
Document Number: C202; ISBN: 1-872630-47-2; Published by X/Open Company
Ltd., U.K.