Usr_GetProfStrg

SUMMARY

Usr_GetProfStrg - reads a string out of an ini File

SYNTAX

Usr_GetProfStrg(inifile,section,lable);

ARGUMENTS

inifile
Name of the ini-File that contains the "Section"
section
Name of the Section that contains the "Lables"
lable
Lable that defines the string that should be read.
(The length of the string is limited by the total of 255 characters a job-chain may have)

RETURN VALUE

max. 255 Characters

DESCRIPTION

Allows to read a string from an ini-File.


How the job is used:

refering to the following ini-File :

test.ini
[s_1_2]
Ann=Line_1 \n Line_2
Bert=Test_11
Cindy=s_1_2_3_4
Django=Test_13
Effi=Test_14
Abigail=Test_15


Bound to a Text Field it would display the appropriate strings.

Note:
If the Vision2000.ini file contains the the Section "[Jobs]" with the entry: "EnableNewline=1" the String "\n" is interpreted as a line feed.

The sequence:

Usr_GetProfStrg(test.ini,s_1_1,Cindy)
Usr_PushArgs()
Wnd_Dialog(TEST1,1)

bound to a button would make the string "s_1_2_3_4" available as $wnd1 in the Dialog Window "TEST1".

EXAMPLES

Usr_GetProfStrg(test.ini,s_1_1,Cindy);

Syntax Notation
[aaa]
aaa is optional (zero or one occurences)
(aaa|bbb)
aaa exclusive or bbb
(aaa)*
aaa may occur indefinitely often or may be omitted
(aaa)+
aaa may occur indefinitely often but at least once
(aaa)m..n
aaa may occur from m to n times