prfSetValue

C Scripting Language
Reference Manual
Version 4.4.0

<< Back  End  Next >>
 
 
INDEX
Introduction
Installation
Using the CSL executive
Language
Directives
System library
String library
Math library
Regular expression lib.
File library
Database library
Async Communication
Registry/Profile handling
   prfClose
   prfDeleteKey
   prfDeleteValue
   prfGetKeys
   prfGetValue
   prfGetValues
   prfKeyExists
   prfOpen
   prfOpenSystem
   prfOpenUser
   prfPath
   prfSetValue
   prfValueExists
   prfValueType
Windows control
C API
C++ Class Interface
CSL links
  
var prfSetValue(     // set value
   const handle,        // profile handle
   const data,          // data to write
   [const name,         // value name (def=''=standard value)
    const type]);       // type enforcement (def=prfTypeAuto)

Set a value. If no type is defined it will be determined automatically as:

  • If data represents an integer value, the type will be prfTypeInteger.
  • If data contains only printable characters type will be set to prfTypeString.
  • If both previous conditions are not met, the type will be prfTypeBinary.

Windows: If name is omitted or '', the default value is set.

OS/2: The name is mandatory and a non-empty path must be set.

OS/2 profiles don't really distinguish types, so don't expect prfValueType to return an enforced type correct; instead prfValueType will do it's best to determine the type out of the data itself according to the rules above.

  Copyright © IBK Landquart Last revision: 27.05.2002 << Back  Top  Next >>