_tolower(3p)

_tolower3p

Transliterate uppercase characters to lowercase

Usage

#include <ctype.h>

int _tolower(int c);

Prolog

This manual page is part of the POSIX Programmer's Manual. The Linux implementation of this interface may differ (consult the corresponding Linux manual page for details of Linux behavior), or the interface may not be implemented on Linux.

Overview

The _tolower() macro shall be equivalent to tolower(c) except that the application shall ensure that the argument c is an uppercase letter.

Return value

Upon successful completion, _tolower() shall return the lowercase letter corresponding to the argument passed.

Errors

No errors are defined.

The following sections are informative.

Examples

None.

Application usage

Applications should use the tolower() function instead of the obsolescent _tolower() function.

Rationale

None.

Future directions

The _tolower() function may be removed in a future version.

From man-pages 6.19-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.