Aquineo Software

• Home
• Aquineo
• Products
• Community

• INI parser
  1. Motivation
  2. Characteristics
  3. Licence
  4. Changes
  5. Download

 

Aquineo implementation of INI file format

Programming language: C#
Dependencies: .NET Framework 2.0
Operating system: Windows

Motivation

Most current implementations of INI file format in C# are simple, e.g. don't prevail the sequence of sections or don't support comments. In particular, missing support for comments hinders one to process existing INI files. To overcome limitations Aquineo wrote an own INI file parser in C# resulting in a complete implementation of INI file format.

Characteristics

As far as we know it is a complete implementation of INI file format being characterised by the following (see also the documentation in the source code package below):

• Names of sections and keys are case-sensitive.
• Values may optionally be enclosed in double quotation marks. Values beginning or ending with whitespace characters, or containing commas or semicolons, must be enclosed in double quotation marks. Double quotation marks appearing inside of a value enclosed in double quotation marks must be encoded as an escape sequence, containing a backslash followed by a double quotation mark: \".
• Even when not enclosed in double quotation marks the values of a key/value pair needn't be followed by a whitespace character, a comma separates the values. Whitespace at the beginning and ending of a value not enclosed in double quotation marks are ignored.
• Values are always string values. Neither types nor type conversions are supported.
• Text may be encoded using any encoding of the .NET System.Text.Encoding class (ASCII, Unicode, UTF-7, UTF-8, "Latin1" etc.).

Licence

Aquineo disclaims all warranties with regard to this software, including all implied warranties of merchantability and fitness, in no event shall Aquineo be liable for any special, indirect or consequential damages or any damages whatsoever resulting from loss of use, data or profits, whether in an action of contract, negligence or other tortious action, arising out of or in connection with the use or performance of this software.

Permission to use, copy, modify, and distribute this software for any purpose and without fee is hereby granted, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment (see the following) in the product documentation and this permission notice is required:
   Copyright © 2004 Aquineo (www.aquineo.com)
2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
3. This notice may not be removed or altered from any source distribution.

Changes

• 2004-05-01, v1.0.0: Release
• 2004-05-09, v1.0.2: CIni.TextEncoding made read only.

Download

Latest source code version of INI file parser can be downloaded here:
v1.0.2