wcsupr_s.c File Reference

#include "safe_str_lib.h"

Include dependency graph for wcsupr_s.c:

Functions
EXPORT errno_t	wcsupr_s (wchar_t *restrict src, rsize_t slen)
	Scans the string converting lowercase characters to uppercase, leaving all other characters unchanged. More...

Function Documentation

wcsupr_s()

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

Scans the string converting lowercase characters to uppercase, 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 converts only single chars via towupper(). 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 before C11. Since C11 zero is allowed.

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 before C11.
ESLEMAX	when slen > RSIZE_MAX_WSTR

See also

strtouppercase_s(), strlwr_s(), wcslwr_s()