wcslwr_s.c File Reference

#include "safe_str_lib.h"

Include dependency graph for wcslwr_s.c:

Functions
EXTERN wint_t	towlower (wint_t wc)
EXPORT errno_t	wcslwr_s (wchar_t *restrict src, rsize_t slen)
	Scans the string converting uppercase characters to simple lowercase, leaving all other characters unchanged. More...

Function Documentation

towlower()

EXTERN wint_t towlower

(

wint_t

wc

)

wcslwr_s()

EXPORT errno_t wcslwr_s	(	wchar_t *restrict	src,
		rsize_t	slen
	)

Scans the string converting uppercase characters to simple lowercase, leaving all other characters unchanged.

The scanning stops at the first null or after slen characters. The conversion is determined by the LC_CTYPE category setting of the locale. Other characters are not affected. It only performs simple case folding via towlower(), it does not do full multi-char folding and does not obey the special casing rules for context. Thus the length of buffer stays the same. It returns a pointer to the altered string. Because the modification is done in place, the pointer returned is the same as the pointer passed as the input argument.

Remarks

IMPLEMENTED IN

• Microsoft Windows Secure API
• Novell NDK
• Nokia openc s60.com

Parameters

[out]	src	wide string
[in]	slen	maximum length of string

Precondition

src shall not be a null pointer.

slen shall not equal zero.

slen shall not be greater than RSIZE_MAX_WSTR.

Return values

EOK	on successful operation
ESNULLP	when src is NULL pointer
ESZEROL	when slen = 0
ESLEMAX	when slen > RSIZE_MAX_WSTR

See also

wcsfc_s(), strtolowercase_s(), strlwr_s(), wcsupr_s()