isrune_l(3)

isrune_l3

Valid character test

Part of isrune(3).

Usage

#include <ctype.h>

int

isrune(int c);

int

isrune_l(int c, locale_t loc);

Library

Standard C Library (libc, -lc)

Overview

The isrune() and isrune_l() functions test for any character that is valid in the current character set. In the ASCII character set, this is equivalent to isascii().

The isrune_l() function takes an explicit locale argument, whereas the isrune() function uses the current global or per-thread locale.

Return values

The isrune() and isrune_l() functions return zero if the character tests false and return non-zero if the character tests true.

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 iswrune() or iswrune_l() function should be used instead.

Releases

13 releases since FreeBSD 13.2-RELEASE; the text changed 1 time.

  1. 13.2
  2. 13.3–16.0

History

The isrune() function appeared in 4.4BSD.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.