OpenCatalog -- open a locale catalog
OpenCatalog(name$[, version])
This function tries to open the catalog specified by name$ in the user's language. If a catalog in the user's language does not exist, this function will not fail. You have to specify alternative English strings in the GetCatalogString() function that will be used if there is no catalog in the user's language.

On non-Amiga compatible systems (e.g. Windows, macOS, Linux), Hollywood will search for catalogs inside a sub-directory named "Catalogs" inside the current directory. For example, if the current user's language is #LANGUAGE_GERMAN and you try to open "MyProgram.catalog" using OpenCatalog(), Hollywood will look in the following places for the catalog:


If the current user's language is #LANGUAGE_FRENCH, Hollywood will look in these places for the catalog:


Note that it is recommended to use international names for the language sub-directory, i.e. "german" instead of "deutsch" and "french" instead of "français". The native names are only supported for compatibility reasons with AmigaOS-based systems.

The catalog specified in name$ can be either in the IFF CTLG format as developed by Commodore, or it can be in a platform-neutral format defined by Hollywood. It is recommended to use Hollywood's platform-neutral format because IFF CTLG doesn't support Unicode. See Catalog format for details.

catalog to open
optional: version that the catalog must have at least; if omitted this function will accept any version

; this is our default English catalog
def$ = {}
def$[0] = "Welcome to Hollywood!"
def$[1] = "Written by Andreas Falkenhahn"
def$[2] = "What do you wanna do?"

; if Hollywood.catalog is not available in the
; user's language; the English strings will be
; used
For k = 0 To 2
   c$[k] = GetCatalogString(k, def$[k])


Show TOC