Ini_ItemExists
- Updated2023-02-21
- 1 minute(s) read
int Ini_ItemExists (IniText handle, const char sectionName[], const char tagName[]);
Purpose
Determines if the item specified by tagName exists in the section identified by sectionName, or if there are items having tag names of the form
<Tag Name> Line 0001
<Tag Name> Line 0002
<Tag Name> Line 0003
in the section identified by sectionName. The latter case indicates that the item specified by tagName was split across several lines.
 |
Note This function should be used instead of the obsoleted function Ini_ItemOrMultiLineItemExists. |
Parameters
| Input | ||
| Name | Type | Description |
| handle | IniText | A handle returned from Ini_New. It represents the list of in-memory tag/value pairs. |
| sectionName | const char [] | The section name under which to find the tag/value pair. |
| tagName | const char [] | The tag name in the tag/value pair. |
Return Value
| Name | Type | Description |
| itemExists | int | Indicates if the item specified by tagName exists in the section identified by sectionName. If the item exists, 1 is returned. If the item does not exist, 0 is returned. |
Additional Information
Library: Reading/Writing .ini-Style Files
Include file: toolbox\inifile.h
LabWindows/CVI compatibility: LabWindows/CVI 4.0 and later
Example
Refer to toolbox\ini.cws for an example of using the Ini_ItemExists function.