sysProfile

C Styled Script
Reference Manual

<< Back  End  Next >>
 
 
INDEX
Introduction
Installation
Using The CSS Executive
Language
Directives
System Library
   sysCommand
   sysDate
   sysDirectory
   sysElapsed
   sysEnvVar
   sysLoadScript
   sysLoadLibrary
   sysLog
   sysLogFile
   sysLogLevel
   sysProfile
   sysPrompt
   sysSleep
   sysShow
   sysStartDate
   sysStartTime
   sysSystemProfile
   sysTime
   sysTrace
   sysUserProfile
String Library
Regular Expression Lib.
File Library
Database Library
C API
C++ API
CSS Links
  
sysProfile(
  const file,     // file name
  const appl,     // application (main key)
  const key,      // key (sub key)
  [const value])  // new value if provided

Query or set a key value in a profile. If no value is passed, the key is queried (be aware there will be an exception thrown if the key does not exist). Providing a non-empty value will add or replace the key; an empty String as value will delete the key.

OS/2: The profile is stored in a file.

Win32: The key will be stored in the registry at HKEY_LOCAL_MACHINE\SOFTWARE\file\appl.

Returns the key value.

Examples:

// add or replace a key
sysProfile('myprog','addr','str','21 red road');
 
// query a value
var city;
try {
   city = sysProfile('myprog','addr', 'cty');
}
catch (exc[]) {
   // key not found
   ...
}
 Copyright © IBK LandquartLast revised by Peter Koch, 24.02.00<< Back  Top  Next >>