Properties

A property abstraction is used to control various behaviors of the library and its interactions with databases, supplemental files and other things. A specific set of properties is constructed prior to a scope-beginning call in which those properties are applied. For example, since library properties effect the behavior of the library, they are applied in the saf_init call. Likewise, database properties are applied in the saf_open_database call. Once applied, the properties remain in effect until a corresponding scope-ending call. For example, saf_final for library properties or saf_close_database for database properties. You cannot change properties mid-stream. If this is a desired modality, please contact saf-help@sourceforge.sandia.gov with such a request.

The general way to control properties is to build up the desired property set of properties by first calling a saf_createProps_xxx function where ‘xxx’ is, for example, ‘lib’ or ‘database’. This creates a default set of properties. You can then adjust specific properties in this set by calling individual functions described in the properties chapters of the API. The resultant set of properties is applied when they are passed in a scope-beginning call such as saf_init or saf_open_database. See descriptions of the individual member property functions for a description of the properties supported.