---
name: "toupper"
section: "3"
platform: "macos"
package: "Libc"
version: "1752.120.2"
release: "macOS 26.5"
platforms: ["linux", "freebsd", "macos"]
url: "https://new.carta.tech/toupper"
---

# toupper(3)

lower case to upper case letter conversion

## NAME

**toupper**, **toupper\_l** – lower case to upper case letter conversion

## LIBRARY

Standard C Library (libc, -lc)

## SYNOPSIS

**#include \<ctype.h\>**

*int*\

**toupper**(*int c*);

**#include \<ctype.h\>**

**#include \<xlocale.h\>**

*int*\

**toupper\_l**(*int c*, *locale\_t loc*);

## DESCRIPTION

The **toupper**() function converts a lower-case letter to the corresponding upper-case letter. The argument must be representable as an *unsigned char* or the value of EOF.

Although the **toupper**() function uses the current locale, the **toupper\_l**() function may be passed a locale directly. See [xlocale(3)](/xlocale/3.md) for more information.

## RETURN VALUES

If the argument is a lower-case letter, the **toupper**() function returns the corresponding upper-case letter if there is one; otherwise, the argument is returned unchanged.

## COMPATIBILITY

The 4.4BSD extension of accepting arguments outside of the range of the *unsigned char* type in locales with large character sets is considered obsolete and may not be supported in future releases. The **towupper**() function should be used instead.

## SEE ALSO

[ctype(3)](/ctype/3.md), [isupper(3)](/isupper/3.md), [towupper(3)](/towupper/3.md), [xlocale(3)](/xlocale/3.md)

## STANDARDS

The **toupper**() function conforms to ISO/IEC 9899:1990 (“ISO C90”).