Ini_NumberOfItems
- Updated2023-02-21
- 1 minute(s) read
int Ini_NumberOfItems (IniText handle, const char sectionName[]);
Purpose
Obtains the number of items in the section identified by SectionName.
 |
Note If an item was split across several lines, it has several tag names entries in the .ini file, as in the following. <Tag Name> Line 0001 <Tag Name> Line 0002 <Tag Name> Line 0003 For the purposes of this function, the group of tag names counts as only one item. |
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 name of the section under which the item count is returned. |
Return Value
| Name | Type | Description |
| numberOfItems | int | The number of items in the section identified by sectionName. If the section 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_NumberOfItems function.