Syntax

  #include <time.h> or #define NWL_EXCLUDE_TIME 
  #include <stdio.h> or #define NWL_EXCLUDE_FILE 
  #include <nwlocale.h> 
   
  pnstr N_API NWLsetlocale  ( 
     nint               category,  
     const nstr N_FAR  *locale); 
  
  

Pascal Syntax

  uses netwin32 
   
  Function NWLsetlocale 
    (category     : nint; 
     const locale : pnstr 
  ) : pnstr; 
  
  

Parameters

category

(IN) Specifies the locale categories.

locale

(IN) Points to a locale string.

Return Values

Remarks

  NWLsetlocale(LC_ALL,"");
  

After calling NWLsetlocale, all locale-sensitive functions will use the locale information set by NWLsetlocale.

locale can have the following values:

  Initialize the implementation-defined native 
           environment. 
  NULL     Query for the current locale country ID, 
           without initializing the environment.
  

The category parameter and internal data structures can be specified and initialized for that category only using less initialization time. Functions affected by an uninitialized category are not called.

The category parameter can have the following values:

  NLC_ALL         0 
  NLC_COLLATE     1 
  NLC_CTYPE       2 
  NLC_MONETARY    3 
  NLC_NUMERIC     4 
  NLC_TIME        5 
  NLC_TOTAL        6
  

The country ID is a three-digit string defined by IBM. These IDs are based on the international phone prefix for a given country. For example, USA is `001’. Finland is `358’. The NWCallsInit function will automatically call the functions, NWSetLocale and NWInitUnicodeTables.

See Also

NWInitUnicodeTables (Unicode), NWLlocaleconv