LabWindows/CVI

Ini_SetTokens

int Ini_SetTokens (IniText handle, char sectionNameStartCharacter, char sectionNameEndCharacter, const char valueSeparator[], const char commentMarker[]);

Purpose

Specifies the tokens used as delimiters in the text representation of the sections headings and tag/value pairs.

If you do not call this function, the default tokens are the following:

Section Name Start Character "["
Section Name End Character "]"
Value Separator "="
Comment Marker ";"

Parameters

Input
Name Type Description
handle IniText A handle returned from Ini_New. It represents the list of in-memory tag/value pairs.
sectionNameStartCharacter char The character used to delimit the start of a section name.

Pass 0 to leave the current delimiter unchanged.
sectionNameEndCharacter char The character used to delimit the end of a section name.

Pass 0 to leave the current delimiter unchanged.
valueSeparator const char [] The string used to separate item tag names from values.

Pass 0 to leave the current delimiter unchanged.
commentMarker const char [] Pass the string used to mark the beginning of a comment line.

Pass 0 to leave the current delimiter unchanged.

Return Value

Name Type Description
status int This function always returns 0.

Additional Information

Library: Reading/Writing .ini-Style Files

Include file: toolbox\inifile.h

LabWindows/CVI compatibility: LabWindows/CVI 4.0 and later