xref: /illumos-gate/usr/src/man/man3c/towupper.3c (revision bbf21555)
te

This file and its contents are supplied under the terms of the
Common Development and Distribution License ("CDDL"), version 1.0.
You may only use this file in accordance with the terms of version
1.0 of the CDDL.

A full copy of the text of the CDDL should have accompanied this
source. A copy of the CDDL is also available via the Internet at
http://www.illumos.org/license/CDDL.


Copyright (c) 2014 Joyent, Inc. All rights reserved.
Copyright 2014 Garrett D'Amore <garrett@damore.org>

TOWUPPER 3C "Jun 21, 2014"
NAME
towupper, towupper_l - transliterate lower-case wide characters to upper-case
SYNOPSIS

#include <wctype.h>

wint_t towupper(wint_t wc);

wint_t towupper_l(wint_t wc, locale_t loc);
DESCRIPTION
The function towupper() is the wide character equivalent of the function toupper (3C). It converts the lower-case wide character wc to the equivalent upper-case wide character, if one exists. If one does not exist, it returns wc unchanged.

The function towupper_l() is equivalent to the function towupper() , but instead of operating in the current locale, operates in the locale specified by loc .

RETURN VALUES
On successful completion, towupper() and towupper_l() return the upper-case character that corresponds to the argument passed. Otherwise, they return the argument unchanged.
ERRORS
No errors are defined.
ATTRIBUTES
ATTRIBUTE TYPE ATTRIBUTE VALUE
Interface Stability Standard
MT-Level MT-Safe
SEE ALSO
newlocale (3C), setlocale (3C), toupper (3C), uselocale (3C), locale (7)