BAP Online Manuals : Library Reference : Library by Name : getprofile
Previous: getenv
Next: gotowindow

6.2.69. getprofile

retrieves a profile string

SYNOPSIS

include 'iolib.h'
getprofile(File, App, Key, Default, Value)

SYNTAX

getprofile(File, App, Key, Default, Value) (i,i,i,i,o) (i,i,i,i,i))

ARGUMENTS

string(File) (i) Host environment profile file.
string(App) (i) Application section in File.
string(Key) (i) Keyword for Value
string(Default) (i), integer(Default) Value to return if Key not found.
void(Value) Value stored in Key.

DESCRIPTION

This predicate returns environment information from the host system. The exact implementation and meaning of the arguments is host dependent.

Currently getprofilestring is available only for the MS-Windows host server WIO :

The profile information is strored in '.INI' files, e.g. WIN.INI, structured into sections headed with Application clauses. Inside these sections, the values are stored as pairs of Keyword and Value. getprofile will return the Value stored for Key, or Default, if Key is not found in the appropriate section App. Depending on the type of Default, getprofile will interpret the returned Value as string or integer. getprofile will fail if Default is neither string nor integer.

ERRORS

No errors.

LAYERS

prolog-process, client-server, object

RELATED PREDICATES

setprofile , servertype


BAP Online Manuals : Library Reference : Library by Name : getprofile
Previous: getenv
Next: gotowindow