g++ [flags ...] file ... -l /isip/tools/lib/$ISIP_BINARY/lib_io.a

#include <Sof.h>

Sof();
boolean open(const SysString& filename, File::MODE mode = File::READ_ONLY,
	       File::TYPE type = File::DEF_TYPE);
boolean put(const SysString& name, long size);
long write(const void* ptr, long size, long nitems);

long j = 27;
Sof sof1;
SysString file1(L"temp.out");
if (sof1.open(file1, File::WRITE_ONLY, File::BINARY) != true) {
 return Error::handle(file1, L"open", Error::TEST, __FILE__, __LINE__);
}
SysString cname(L"MyLong");
sof1.put(cname, 0, sizeof(long));
sof1.write(&j, sizeof(j), 1);
sof1.close();

• This example shows declaring Sof file objects and then creating temporary file names. The next step involves writing data into these files in text and binary format and reading some of the data that was written.

    Sof sof0;
    Sof sof1;
    SysString file1;
    SysString file2;
    SysString long_cname(L"Long");
    file1.assign(L"/tmp/foo_bin.sof");
    file2.assign(L"/tmp/foo_asc.sof");
         
    // open files for write (text & binary)
    //
    if (!sof0.open(file1, File::WRITE_ONLY)) {
      return Error::handle(long_cname, L"open", Error::TEST, __FILE__, __LINE__);
    }
    if (!sof1.open(file2, File::WRITE_ONLY, File::BINARY)) {
      return Error::handle(long_cname, L"open", Error::TEST, __FILE__, __LINE__);
    }
         
    // add a long entry to the files
    //
    long j = 27;
    sof0.put(long_cname, Sof::ANY_SIZE);
    sof1.put(long_cname, 0, sizeof(long));
         
    // write the text value
    //
    SysString output;
    output.assign((long)j, (unichar*)("value = %ld\n"));
    sof0.puts(output);
         
    // write the binary value
    //
    sof1.write(&j, sizeof(j), 1);
         
    // add another long entry to the files
    //
    j = 277;
    sof0.put(long_cname, Sof::ANY_SIZE);
    sof1.put(long_cname, 1, sizeof(long));
         
    // close the files
    //
    sof0.close();
    sof1.close();
         
    // open files again in read plus
    //
    sof0.open(file1, File::READ_PLUS);
         
    // read all the text values
    //
    long tag;
    for (tag = sof0.first(long_cname); tag != Sof::NO_TAG;
         tag = sof0.next(long_cname, tag)) {
         
      // find the node
      //
      sof0.find(long_cname, tag);
     }
    sof0.close();
  

• The preliminary implementation of Sof does not balance trees or compact the indices to the symbol table, but these changes could be easily added to the code. Additionally, the tree iteration routines could be algorithmically optimized. Even with these planned enhancements, a designer need not worry about lost effort. All Sof file formats henceforth will be backwards compatible. Note that multiple objects of the same class name can be written to a file.
  
  
• Note that a 16 bit checksum is used for each symbol table entry and index entry in binary mode.