Reads a value associated with a key in a specified section from the configuration data identified by refnum. If the key does not exist, the VI returns the default value. This VI supports multibyte characters in strings. Wire data to the default value input to determine the polymorphic instance to use or manually select the instance.


icon

Inputs/Outputs

  • cstr.png section —

    section is the name of the section from which to read the specified key.

  • cdlrn.png refnum —

    refnum is the reference number of the configuration data.

  • cstr.png key —

    key is the name of the key to read.

  • cbool.png default value —

    default value is the value to return if the VI does not find the key in the specified section or if an error occurs.

  • cerrcodeclst.png error in (no error) —

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

  • idlrn.png refnum out —

    refnum out is the reference number of the configuration data.

  • ibool.png found? —

    found? is TRUE if the VI found the key in the specified section.

  • ibool.png value —

    value is the value of the key.

  • ierrcodeclst.png error out —

    error out contains error information. This output provides standard error out functionality.

    • Examples

    Refer to the following example files included with LabVIEW.

    • labview\examples\File IO\Configuration (INI)\Configuration (INI) File.lvproj