Specifications

CHAPTER 24 DataWindow Expression and InfoMaker Functions
Users Guide 727
ProfileString
Description Obtains the string value of a setting in the specified profile file.
Syntax ProfileString ( filename, section, key, default )
Return value
String, with a maximum length of 4096 characters. Returns the string from key
within section within filename. If filename is not found, section is not found in
filename, or key is not found in section,
ProfileString returns default. If an error
occurs, it returns the empty string (“”).
Usage Use ProfileInt and ProfileString to get configuration settings from a profile file
you have designed for your application.
ProfileInt and ProfileString can read files
with ANSI or UTF16-LE encoding.
Examples This example uses the following section in the PROFILE.INI file:
[Employee]
Name="Smith"
[Dept]
Name="Marketing"
This expression returns the string for the keyword Name in section Employee
in file C:\PROFILE.INI. It returns None if the section or keyword does not
exist. In this case it returns Smith:
ProfileString("C:\PROFILE.INI", "Employee", "Name",
"None")
See also
ProfileInt
Argument Description
filename A string whose value is the name of the profile file. If you do not
specify a full path,
ProfileString uses the operating system’s
standard file search order to find the file.
section A string whose value is the name of a group of related values in the
profile file. In the file, section names are in square brackets. Do not
include the brackets in section. Section is not case sensitive.
key A string specifying the setting name in section whose value you
want. The setting name is followed by an equal sign in the file. Do
not include the equal sign in key. Key is not case sensitive.
default A string value that
ProfileString returns if filename is not found, if
section or key does not exist in filename, or if the value of key
cannot be converted to an integer.