1 TOUPPER(3C) Standard C Library Functions TOUPPER(3C)
2
3
4
5 NAME
6 toupper, toupper_l - transliterate lower-case characters to upper-case
7
8 SYNOPSIS
9 #include <ctype.h>
10
11 int toupper(int c);
12
13 int toupper_l(int c, locale_t loc);
14
15
16 DESCRIPTION
17 The toupper() function has as a domain a type int, the value of which
18 is representable as an unsigned char or the value of EOF. If the
19 argument has any other value, the argument is returned unchanged. If
20 the argument of toupper() represents a lower-case letter, and there
21 exists a corresponding upper-case letter (as defined by character type
22 information in the locale category LC_CTYPE), the result is the
23 corresponding upper-case letter. All other arguments in the domain are
24 returned unchanged.
25
26 The function toupper_l() behaves identically to toupper(), except
27 instead of operating in the current locale, it operates in the locale
28 specified by loc.
29
30 RETURN VALUES
31 On successful completion, toupper() returns the upper-case letter
32 corresponding to the argument passed.
33
34 ERRORS
35 No errors are defined.
36
37 ATTRIBUTES
38 See attributes(5) for descriptions of the following attributes:
39
40 +--------------------+-----------------+
41 | ATTRIBUTE TYPE | ATTRIBUTE VALUE |
42 +--------------------+-----------------+
43 |CSI | Enabled |
44 +--------------------+-----------------+
45 |Interface Stability | Standard |
46 +--------------------+-----------------+
47 |MT-Level | MT-Safe |
48 +--------------------+-----------------+
49
50 SEE ALSO
51 _toupper(3C), newlocale(3C), setlocale(3C), uselocale(3C),
52 attributes(5), standards(5)
53
54
55
56 June 21, 2014 TOUPPER(3C)
|
1 TOUPPER(3C) Standard C Library Functions TOUPPER(3C)
2
3
4
5 NAME
6 toupper, toupper_l - transliterate lower-case characters to upper-case
7
8 SYNOPSIS
9 #include <ctype.h>
10
11 int toupper(int c);
12
13 int toupper_l(int c, locale_t loc);
14
15
16 DESCRIPTION
17 The toupper() function has as a domain of type int, the value of which
18 is representable as an unsigned char or the value of EOF. If the
19 argument has any other value, the argument is returned unchanged. If
20 the argument of toupper() represents a lower-case letter, and there
21 exists a corresponding upper-case letter (as defined by character type
22 information in the locale category LC_CTYPE), the result is the
23 corresponding upper-case letter. All other arguments in the domain are
24 returned unchanged.
25
26 The function toupper_l() behaves identically to toupper(), except
27 instead of operating in the current locale, it operates in the locale
28 specified by loc.
29
30 A macro form, _toupper() exists. It is defined for standards
31 conformance, particularly with legacy standards. It was deprecated in
32 POSIX 2008 (Issue 7), and its use is discouraged. The macro, on this
33 system, is just an alias for toupper().
34
35 RETURN VALUES
36 On successful completion, toupper() returns the upper-case letter
37 corresponding to the argument passed.
38
39 ERRORS
40 No errors are defined.
41
42 ATTRIBUTES
43 See attributes(5) for descriptions of the following attributes:
44
45 +--------------------+-----------------+
46 | ATTRIBUTE TYPE | ATTRIBUTE VALUE |
47 +--------------------+-----------------+
48 |CSI | Enabled |
49 +--------------------+-----------------+
50 |Interface Stability | Standard |
51 +--------------------+-----------------+
52 |MT-Level | MT-Safe |
53 +--------------------+-----------------+
54
55 SEE ALSO
56 newlocale(3C), setlocale(3C), uselocale(3C), attributes(5),
57 standards(5)
58
59
60
61 October 4, 2015 TOUPPER(3C)
|