Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
N
nuttx-apps
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Wiki
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Build
Pipelines
Jobs
Pipeline schedules
Artifacts
Deploy
Releases
Container Registry
Model registry
Operate
Environments
Monitor
Incidents
Analyze
Value stream analytics
Contributor analytics
CI/CD analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
f4grx
nuttx-apps
Commits
626dc7d6
Commit
626dc7d6
authored
11 years ago
by
Gregory Nutt
Browse files
Options
Downloads
Patches
Plain Diff
Updated README
parent
682325b5
No related branches found
Branches containing commit
No related tags found
Tags containing commit
No related merge requests found
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
system/inifile/README.txt
+145
-145
145 additions, 145 deletions
system/inifile/README.txt
with
145 additions
and
145 deletions
system/inifile/README.txt
+
145
−
145
View file @
626dc7d6
README.txt
==========
Syntax
======
This directory contains a very simple INI file parser. An INI file consists
of a sequence of lines up to the end of file. A line may be one of the
following:
1) A blank line.
2) A comment line. Any line beginning with ';'
3) A section header. Definitions are divided into sections. Each
section begins with a line containing the section name enclosed in
square brackets. For example, "[section1]". The left bracket must
be the first character on the line. Section names are case
insensitive, i.e., "SECTION1" and "Section1" refer to the same
section.
4) Variable assignments. A variable assignment is a variable name
followed by the '=' sign and then the value of the variable. For
example, "A=B": "A" is the variable name; "B" is the variable value.
All variables following the section header belong in the section.
Variable names may be preceded with white space. Whitespace is not
permitted before the '=' sign. Variable names are case insensitive,
i.e., "A" and "a" refer to the same variable name.
Variable values may be numeric (any base) or a string. The case of
string arguments is preserved.
Programming Interfaces
======================
See apps/include/inifile.h for interfaces supported by the INI file parser.
Test Program
============
Below is a simple test program:
int main(int argc, char *argv[])
{
INIHANDLE handle;
FILE *stream;
FAR char *ptr;
long value;
stream = fopen("/tmp/file.ini", "w");
fprintf(stream, "; Test INI file\n");
fprintf(stream, "[section1]\n");
fprintf(stream, "VAR1=1\n");
fprintf(stream, "VAR2=2\n");
fprintf(stream, "VAR3=3\n");
fprintf(stream, "\n");
fprintf(stream, "[section2]\n");
fprintf(stream, "VAR4=4\n");
fprintf(stream, "VAR5=5\n");
fprintf(stream, "VAR6=6\n");
fprintf(stream, "\n");
fclose(stream);
handle = inifile_initialize("/tmp/file.ini");
ptr = inifile_read_string(handle, "section2", "VAR5", "OOPS");
printf("Section: %s Variable: %s String: %s\n", "section2", "VAR5", ptr);
inifile_free_string(ptr);
ptr = inifile_read_string(handle, "section1", "VAR2", "OOPS");
printf("Section: %s Variable: %s String: %s\n", "section1", "VAR2", ptr);
inifile_free_string(ptr);
ptr = inifile_read_string(handle, "section3", "VAR3", "OOPS");
printf("Section: %s Variable: %s String: %s\n", "section3", "VAR3", ptr);
inifile_free_string(ptr);
ptr = inifile_read_string(handle, "section1", "VAR3", "OOPS");
printf("Section: %s Variable: %s String: %s\n", "section1", "VAR3", ptr);
inifile_free_string(ptr);
ptr = inifile_read_string(handle, "section1", "VAR1", "OOPS");
printf("Section: %s Variable: %s String: %s\n", "section1", "VAR1", ptr);
inifile_free_string(ptr);
ptr = inifile_read_string(handle, "section1", "VAR42", "OOPS");
printf("Section: %s Variable: %s String: %s\n", "section1", "VAR42", ptr);
inifile_free_string(ptr);
ptr = inifile_read_string(handle, "section2", "VAR6", "OOPS");
printf("Section: %s Variable: %s String: %s\n", "section2", "VAR6", ptr);
inifile_free_string(ptr);
ptr = inifile_read_string(handle, "section2", "VAR4", "OOPS");
printf("Section: %s Variable: %s String: %s\n", "section2", "VAR4", ptr);
inifile_free_string(ptr);
value = inifile_read_integer(handle, "section1", "VAR3", 0);
printf("Section: %s Variable: %s Value: %ld\n", "section1", "VAR3", value);
value = inifile_read_integer(handle, "section3", "VAR3", 0);
printf("Section: %s Variable: %s
Value
: %ld\n", "section3", "VAR3", value);
value = inifile_read_integer(handle, "section1", "VAR1", 0);
printf("Section: %s Variable: %s Value: %ld\n", "section1", "VAR1", value);
value = inifile_read_integer(handle, "section2", "VAR5", 0);
printf("Section: %s Variable: %s Value: %ld\n", "section2", "VAR5", value);
value = inifile_read_integer(handle, "section2", "VAR6", 0);
printf("Section: %s Variable: %s Value: %ld\n", "section2", "VAR6", value);
value = inifile_read_integer(handle, "section1", "VAR42", 0);
printf("Section: %s Variable: %s
Value
: %ld\n", "section1", "VAR42", value);
value = inifile_read_integer(handle, "section1", "VAR2", 0);
printf("Section: %s Variable: %s Value: %ld\n", "section1", "VAR2", value);
value = inifile_read_integer(handle, "section2", "VAR4", 0);
printf("Section: %s Variable: %s Value: %ld\n", "section2", "VAR4", value);
inifile_uninitialize(handle);
return 0;
}
Test program output:
Section: section2 Variable: VAR5 String: 5
Section: section1 Variable: VAR2 String: 2
Section: section3 Variable: VAR3 String: OOPS
Section: section1 Variable: VAR3 String: 3
Section: section1 Variable: VAR1 String: 1
Section: section1 Variable: VAR42 String: OOPS
Section: section2 Variable: VAR6 String: 6
Section: section2 Variable: VAR4 String: 4
Section: section1 Variable: VAR3 Value: 3
Section: section3 Variable: VAR3 Value: 0
Section: section1 Variable: VAR1 Value: 1
Section: section2 Variable: VAR5 Value: 5
Section: section2 Variable: VAR6 Value: 6
Section: section1 Variable: VAR42 String: 0
Section: section1 Variable: VAR2 Value: 2
Section: section2 Variable: VAR4 Value: 4
README.txt
==========
Syntax
======
This directory contains a very simple INI file parser. An INI file consists
of a sequence of lines up to the end of file. A line may be one of the
following:
1) A blank line.
2) A comment line. Any line beginning with ';'
3) A section header. Definitions are divided into sections. Each
section begins with a line containing the section name enclosed in
square brackets. For example, "[section1]". The left bracket must
be the first character on the line. Section names are case
insensitive, i.e., "SECTION1" and "Section1" refer to the same
section.
4) Variable assignments. A variable assignment is a variable name
followed by the '=' sign and then the value of the variable. For
example, "A=B": "A" is the variable name; "B" is the variable value.
All variables following the section header belong in the section.
Variable names may be preceded with white space. Whitespace is not
permitted before the '=' sign. Variable names are case insensitive,
i.e., "A" and "a" refer to the same variable name.
Variable values may be numeric (any base) or a string. The case of
string arguments is preserved.
Programming Interfaces
======================
See apps/include/inifile.h for interfaces supported by the INI file parser.
Test Program
============
Below is a simple test program:
int main(int argc, char *argv[])
{
INIHANDLE handle;
FILE *stream;
FAR char *ptr;
long value;
stream = fopen("/tmp/file.ini", "w");
fprintf(stream, "; Test INI file\n");
fprintf(stream, "[section1]\n");
fprintf(stream, "
VAR1=1\n");
fprintf(stream, "
VAR2=2\n");
fprintf(stream, "
VAR3=3\n");
fprintf(stream, "\n");
fprintf(stream, "[section2]\n");
fprintf(stream, "
VAR4=4\n");
fprintf(stream, "
VAR5=5\n");
fprintf(stream,
"VAR6=6\n");
fprintf(stream, "\n");
fclose(stream);
handle = inifile_initialize("/tmp/file.ini");
ptr = inifile_read_string(handle, "section2", "VAR5", "OOPS");
printf("Section: %s Variable: %s String: %s\n", "section2", "VAR5", ptr);
inifile_free_string(ptr);
ptr = inifile_read_string(handle, "section1", "VAR2", "OOPS");
printf("Section: %s Variable: %s String: %s\n", "section1", "VAR2", ptr);
inifile_free_string(ptr);
ptr = inifile_read_string(handle, "section3", "VAR3", "OOPS");
printf("Section: %s Variable: %s String: %s\n", "section3", "VAR3", ptr);
inifile_free_string(ptr);
ptr = inifile_read_string(handle, "section1", "VAR3", "OOPS");
printf("Section: %s Variable: %s String: %s\n", "section1", "VAR3", ptr);
inifile_free_string(ptr);
ptr = inifile_read_string(handle, "section1", "VAR1", "OOPS");
printf("Section: %s Variable: %s String: %s\n", "section1", "VAR1", ptr);
inifile_free_string(ptr);
ptr = inifile_read_string(handle, "section1", "VAR42", "OOPS");
printf("Section: %s Variable: %s String: %s\n", "section1", "VAR42", ptr);
inifile_free_string(ptr);
ptr = inifile_read_string(handle, "section2", "VAR6", "OOPS");
printf("Section: %s Variable: %s String: %s\n", "section2", "VAR6", ptr);
inifile_free_string(ptr);
ptr = inifile_read_string(handle, "section2", "VAR4", "OOPS");
printf("Section: %s Variable: %s String: %s\n", "section2", "VAR4", ptr);
inifile_free_string(ptr);
value = inifile_read_integer(handle, "section1", "VAR3", 0);
printf("Section: %s Variable: %s Value: %ld\n", "section1", "VAR3", value);
value = inifile_read_integer(handle, "section3", "VAR3", 0);
printf("Section: %s Variable: %s
String
: %ld\n", "section3", "VAR3", value);
value = inifile_read_integer(handle, "section1", "VAR1", 0);
printf("Section: %s Variable: %s Value: %ld\n", "section1", "VAR1", value);
value = inifile_read_integer(handle, "section2", "VAR5", 0);
printf("Section: %s Variable: %s Value: %ld\n", "section2", "VAR5", value);
value = inifile_read_integer(handle, "section2", "VAR6", 0);
printf("Section: %s Variable: %s Value: %ld\n", "section2", "VAR6", value);
value = inifile_read_integer(handle, "section1", "VAR42", 0);
printf("Section: %s Variable: %s
String
: %ld\n", "section1", "VAR42", value);
value = inifile_read_integer(handle, "section1", "VAR2", 0);
printf("Section: %s Variable: %s Value: %ld\n", "section1", "VAR2", value);
value = inifile_read_integer(handle, "section2", "VAR4", 0);
printf("Section: %s Variable: %s Value: %ld\n", "section2", "VAR4", value);
inifile_uninitialize(handle);
return 0;
}
Test program output:
Section: section2 Variable: VAR5 String: 5
Section: section1 Variable: VAR2 String: 2
Section: section3 Variable: VAR3 String: OOPS
Section: section1 Variable: VAR3 String: 3
Section: section1 Variable: VAR1 String: 1
Section: section1 Variable: VAR42 String: OOPS
Section: section2 Variable: VAR6 String: 6
Section: section2 Variable: VAR4 String: 4
Section: section1 Variable: VAR3 Value: 3
Section: section3 Variable: VAR3 Value: 0
Section: section1 Variable: VAR1 Value: 1
Section: section2 Variable: VAR5 Value: 5
Section: section2 Variable: VAR6 Value: 6
Section: section1 Variable: VAR42 String: 0
Section: section1 Variable: VAR2 Value: 2
Section: section2 Variable: VAR4 Value: 4
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment