ifx_gl_wcsntslen - returns number of characters ignoring trailing spaces
SYNOPSIS
#include <ifxgls.h>
int ifx_gl_wcsntslen(gl_wchar_t *wcs, int wcs_char_length)
DESCRIPTION
This function returns the number of characters in wcs, not including
the trailing space characters. The characters that are not included in
the count are the ASCII space character and any wide-characters
that are equivalent to the ASCII space character. Note that the space
characters embedded in the string prior to the series of spaces at the
end of the string are included in the count.
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 wcs.
See Wide-Character String Termination
for more general information about wcs_char_length.
RETURN VALUE
Returns the number of characters in wcs, not including
the trailing space characters.
ERRORS
If an error has occurred, this function returns -1 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.
SEE ALSO
ifx_gl_mbsntsbytes()
ifx_gl_mbsntslen()
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