locale/duplocale.3

   1 .Dd March 11, 2005
   2 .Dt DUPLOCALE 3
   3 .Os
   4 .Sh NAME
   5 .Nm duplocale
   6 .Nd Duplicate existing locale
   7 .Sh SYNOPSIS
   8 .In xlocale.h
   9 .Ft locale_t
  10 .Fn duplocale "locale_t loc"
  11 .Sh DESCRIPTION
  12 Duplicates an existing
  13 .Vt locale_t .
  14 Sub-structures are shared between the two
  15 .Vt locale_t
  16 structures.
  17 Passing
  18 .Dv NULL
  19 will duplicate the current locale.
  20 Passing
  21 .Dv LC_GLOBAL_LOCALE
  22 will duplicate the global locale.
  23 .Sh RETURN VALUES
  24 Returns a duplicated
  25 .Vt locale_t ,
  26 or
  27 .Dv NULL
  28 on error.
  29 Duplicated locales should be freed with
  30 .Xr freelocale 3 .
  31 .Sh SEE ALSO
  32 .Xr freelocale 3 ,
  33 .Xr newlocale 3 ,
  34 .Xr querylocale 3 ,
  35 .Xr uselocale 3 ,
  36 .Xr xlocale 3