From 9a6ff5bc53dedbaa601a1a76cbaf8a76afd60c9f Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 15 Apr 2024 21:41:06 +0200 Subject: Adding upstream version 6.7. Signed-off-by: Daniel Baumann --- man3/toupper.3 | 29 ++++++++++++++--------------- 1 file changed, 14 insertions(+), 15 deletions(-) (limited to 'man3/toupper.3') diff --git a/man3/toupper.3 b/man3/toupper.3 index 0eaa693..84500c2 100644 --- a/man3/toupper.3 +++ b/man3/toupper.3 @@ -6,7 +6,7 @@ .\" .\" Modified Sat Jul 24 17:45:39 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified 2000-02-13 by Nicolás Lichtmaier -.TH toupper 3 2023-07-20 "Linux man-pages 6.05.01" +.TH toupper 3 2024-02-25 "Linux man-pages 6.7" .SH NAME toupper, tolower, toupper_l, tolower_l \- convert uppercase or lowercase .SH LIBRARY @@ -15,19 +15,19 @@ Standard C library .SH SYNOPSIS .nf .B #include -.PP +.P .BI "int toupper(int " "c" ); .BI "int tolower(int " "c" ); -.PP +.P .BI "int toupper_l(int " c ", locale_t " locale ); .BI "int tolower_l(int " c ", locale_t " locale ); .fi -.PP +.P .RS -4 Feature Test Macro Requirements for glibc (see .BR feature_test_macros (7)): .RE -.PP +.P .BR toupper_l (), .BR tolower_l (): .nf @@ -38,7 +38,7 @@ Feature Test Macro Requirements for glibc (see .fi .SH DESCRIPTION These functions convert lowercase letters to uppercase, and vice versa. -.PP +.P If .I c is a lowercase letter, @@ -52,7 +52,7 @@ The function performs the same task, but uses the locale referred to by the locale handle .IR locale . -.PP +.P If .I c is an uppercase letter, @@ -66,7 +66,7 @@ The function performs the same task, but uses the locale referred to by the locale handle .IR locale . -.PP +.P If .I c is neither an @@ -75,7 +75,7 @@ value nor .BR EOF , the behavior of these functions is undefined. -.PP +.P The behavior of .BR toupper_l () and @@ -108,7 +108,6 @@ T{ .BR tolower_l () T} Thread safety MT-Safe .TE -.sp 1 .SH STANDARDS .TP .BR toupper () @@ -145,7 +144,7 @@ is of type it must be cast to .IR "unsigned char" , as in the following example: -.PP +.P .in +4n .EX char c; @@ -153,7 +152,7 @@ char c; res = toupper((unsigned char) c); .EE .in -.PP +.P This is necessary because .I char may be the equivalent @@ -163,13 +162,13 @@ converting to .IR int , yielding a value that is outside the range of .IR "unsigned char" . -.PP +.P The details of what constitutes an uppercase or lowercase letter depend on the locale. For example, the default -.B """C""" +.B \[dq]C\[dq] locale does not know about umlauts, so no conversion is done for them. -.PP +.P In some non-English locales, there are lowercase letters with no corresponding uppercase equivalent; .\" FIXME One day the statement about "sharp s" needs to be reworked, -- cgit v1.2.3