wcsupr_s.c File Reference

#include "safe_str_lib.h"

Include dependency graph for wcsupr_s.c:

Functions
EXTERN wint_t	_towupper (wint_t wc)
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

_towupper()

EXTERN wint_t _towupper

(

wint_t

wc

)

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.

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

strtouppercase_s(), strlwr_s(), wcslwr_s()