Open-RJ 1.6.4

Open-RJ is an library that implements readers for the Record-Jar structured text file format. Mappings are provided to several languages and technologies, including C++, COM, D, Java, .NET, Python, Ruby, and STL.
In addition to platform-independence, the library focuses on small runtime costs - memory and speed - and the classic UNIX attributes of discoverability and visibility.
As described in the excellent book "The Art Of UNIX Programming", a Record-Jar structured format file consists of records and fields.
A field is a single line - optionally extended with trailing - that contains a name, separated from an optional value by :.
A record is a list of fields, whose contents are arbitrary and can vary between records in the same database. Records are separated by a line that begins with "%%". The record separator also acts as a comment, so anything can come on a record separator line after the first two characters.
A database is a correctly parsed Record-Jar file. The Open-RJ API (and language mappings) provide access to all the records in the database and the complete set of fields. Hence, you may work with fields on a per-record basis, or treat the database as a single record and with all fields in the database.
A very simple Record-Jar file, representing a Pets Database, is shown in the table on the right-hand side of this page.
And thats pretty much all there is to it. There are no restrictions on what fields may be in a record, and no controls over whether all records have the same fields or not. Thats the job of higher layers of application functionality. We keep Record-Jar simple so its reliable, portable and fast, and its those things in spades!
%% Pets
Name: Barney
Species: Dog
Breed: Bijon
Frieze
%%
Name: Samson
Species: Dog
Breed: Ridgeback
%%
Name: Fluffy Kitten
Species: Cat
%%
Enhancements:
- The code was updated to be fully compatible with STLSoft 1.9.1 (the special version released on Extended STL, volume 1: CD).