a1200   NEWS   APPS   DOCS   ABOUT
a1200
----
a1200
----
Autodocs
 Libraries:
 locale.library
  --environment_vars--
  --rexxhost--
  --structures--
  CloseCatalog
  CloseLocale
  ConvToLower
  ConvToUpper
  FormatDate
  FormatString
  GetCatalogStr
  GetLocaleStr
  IsXXXX
  OpenCatalogA
  OpenLocale
  ParseDate
  StrConvert
  StrnCmp
Include
GuruMeditation
Docs » Autodocs » locale.library » OpenLocale

NAME

	OpenLocale -- open a locale. (V38)

SYNOPSIS

	locale = OpenLocale(name);
D0 A0
struct Locale *OpenLocale(STRPTR);

FUNCTION

	This function opens a named locale. Locales contain many parameters
that an application needs to consider when being integrated into
different languages, territories and customs. Using the information
stored in a locale instead of hard-coding it into an application,
lets the application dynamically adapt to the user's environment.
Locales originally come from disk files which are created by the
user using the Locale preferences editor. Passing a NULL instead of
a name causes this function to return the current default locale.
This is what most applications will do.
Every locale specifies a language, and special language drivers
must be loaded from disk depending on which language is being used.
These files include for example:
LOCALE:Languages/franšais.language
LOCALE:Languages/dansk.language
LOCALE:Languages/italiano.language

INPUTS

	name - the NULL-terminated name of the locale to open, or NULL to open
the current default locale. This should generally be NULL. The
name you supply must be a pathname leading to a locale
preferences file. This is an IFF PREF file as saved by
Locale prefs, that can contain both LCLE and CTRY chunks.
See <prefs/locale.h> for definitions.

RESULT

	locale - a pointer to an initialized Locale structure, or NULL if the
locale could not be loaded. In the case of a NULL return, the
DOS IoErr() function can be called to obtain more information
on the failure.
When passing a NULL name parameter to this function, you are
guaranteed a valid return.

SEE ALSO

CloseLocale(), <libraries/locale.h>, <prefs/locale.h>

Comments

Name:
E-mail: Use this if you want a message if you get a response, will not be shown.
Comment:
Select correct short for:

Andromeda

DJ
PDX
SPB
AOA

Comments:

$VER: d0.se 1.14 Copyright © 2011-2020 Tobias Geijersson support at d0 dot se