uselocale(3)

uselocale3

Sets a thread-local locale

Usage

#include <locale.h>

locale_t

uselocale(locale_t locale);

Library

Standard C Library (libc, -lc)

Overview

Specifies the locale for this thread to use. Specifying LC_GLOBAL_LOCALE disables the per-thread locale, while NULL returns the current locale without setting a new one.

Return values

Returns the previous locale, or LC_GLOBAL_LOCALE if this thread has no locale associated with it.

Releases

33 releases since FreeBSD 9.1-RELEASE; the text changed 19 times.

  1. 9.1
  2. 9.2
  3. 9.3
  4. 10.0
  5. 10.1
  6. 10.2
  7. 10.3
  8. 10.4
  9. 11.0
  10. 11.1
  11. 11.2
  12. 11.3
  13. 11.4
  14. 12.0
  15. 12.1
  16. 12.2
  17. 12.3
  18. 12.4
  19. 13.0–13.2
  20. 13.3–16.0

Standards

This function conforms to IEEE Std 1003.1-2008 (“POSIX.1”).

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