Example 17.10. The binary sequence in hexadecimal to be read

12 34 56 78 11 22 33 44 55 // HEX format

Example 17.11. Reading the Binary Sequence from the Binary Stream

// *** in the code below, the error handling is omitted.
SFXFile file;                  // file
SFXBinaryStreamReader reader;  // binary stream for reading from the file

// open the file in the read only mode
file.OpenReadOnly(SFXPath("/dir/data.txt"));

// get the binary stream for reading from the file
// * the stream buffer is variable since the size argument is not specified
file.GetStreamReader(&reader);

// read data from the file into the stream buffer
// * the stream buffer will be expanded automatically depending on the size of data to be read into
//    the read operation will finish by calling the Fetch function once
reader.Fetch();

// interpret the binary sequence as Little-Endian
reader >> little;

UInt32 v;

// read data from the stream buffer into the various variables
reader >> v; // interpret 4 byte from head as UInt32
             // since it is Little-Endian, 0x78563412 is assigned to v

// the following binary sequence are interpreted as Big-Endian
reader >> big;

reader.ReadUInt32(&v); // interpret next 4 byte as UInt32
                       // since it is Big-Endian, v = 0x11223344
                       // same as reader >> v

UInt08 c;

reader >> c; // interpret 1 bytes from head as UInt08: c = 0x55

reader.ReadUInt08(&c); // c is not changed because it has come to end despite that it is tried to get 1 byte from head
                       // this function returns error

// release the binary stream for reading from the file
reader.Release();

// close the file
file.Close();

Example 17.12. Writing the Binary Sequence into the Binary Stream

// *** in the code below, the error handling is omitted.
SFXFile file;                  // file
SFXBinaryStreamWriter writer;  // binary stream for writing into the file

// open the file in the read-write mode
file.OpenReadWrite(SFXPath("/dir/data.txt"));

// get the binary stream for writing into the file
// * the stream buffer is variable since the size argument is not specified
file.GetStreamWriter(&writer);

// interpret binary sequence as Little-Endian.
writer << little;

// write the various data into the stream buffer
// * the stream buffer will be expanded automatically depending on the size of data to be written
writer.WriteUInt08(0x22);  // write as UInt08
writer.WriteUInt16(0x22);  // write as UInt16
writer.WriteUInt32(0x22);  // write as UInt32

// writer << 0x22; causes error since it is ambigous
// writer << static_cast<UInt08>(0x22); is acceptable

// the following binary sequence is interpreted as Big-Endian
writer << big;

// write data into the stream buffer
// * the stream buffer will be expanded automatically depending on the size of data to be written
writer.WriteUInt32(0x22); // write as UInt32

// write data from the stream buffer into the file
// * the write operation will finish by calling the Flush function once
writer.Flush();

// release the binary stream for writing into the file
writer.Release();

// close the file
file.Close();

Example 17.13. The written the binary sequence in hexadecimal

22 22 00 22 00 00 00 00 00 00 22 // HEX format

Example 17.14. The Character string in hexadecimal to be read

61 62 63 64 00 65 66 67 68 00 69 6A 6B 6C

Example 17.15. Reading from the Binary Stream into the String Class

// *** in the code below, the error handling is omitted.
SFXFile file;                  // file
SFXBinaryStreamReader reader;  // binary stream for reading from the file
SFXAnsiString string;          // variable to read into

// open the file in the read only mode
file.OpenReadOnly(SFXPath("/dir/data.txt"));

// get the binary stream for reading from the file
// * the stream buffer is variable since the size argument is not specified
file.GetStreamReader(&reader);

// read data from the file into the stream buffer
// * the stream buffer will be expanded automatically depending on the size of data to be read into
//    the read operation will finish by calling the Fetch function once
reader.Fetch();

reader >> string; // get data string until '\0' is met           string = "abcd"
reader >> string; // get string up to next '\0'                  string = "efgh"

// at this point, no '\0' remains until the tail
reader >> string; // error occurs since there is no '\0' at end, string is not changed(i.e., string ＝ "efgh")
                    // in case of the Read function, SFERR_INVALID_STATE will be returned

// release the binary stream for reading from the file
reader.Release();

// close the file
file.Close();

Example 17.16. Writinging from the String Class into the Binary Stream

// *** in the code below, the error handling is omitted.
SFXFile file;                  // file
SFXBinaryStreamWriter writer;  // binary stream for writing into the file
SFXAnsiString string("abcd");  // string to write

// open the file in the read-write mode
file.OpenReadWrite(SFXPath("/dir/data.txt"));

// get the binary stream for writing into the file
// * the stream buffer is variable since the size argument is not specified
file.GetStreamWriter(&writer);

// write data from the string variable into the stream buffer
// * the stream buffer will be expanded automatically depending on the size of data to be written
writer << string; // write "abcd" ended with '\0'
writer << string; // write "abcd" ended with '\0'

// write data from the stream buffer into the file
// * the write operation will finish by calling the Flush function once
writer.Flush();

// release the binary stream for writing into the file
writer.Release();

// close the file
file.Close();

Example 17.17. The Character string in hexadecimal to be written

61 62 63 64 00 61 62 63 64 00

Example 17.18. The binary sequence in hexadecimal to be read

11 22 33 44 55 11 22 33 44 55 22

Example 17.19. Reading from the Binary Stream into the Buffer Class

// *** in the code below, the error handling is omitted.
SFXFile file;                  // file
SFXBinaryStreamReader reader;  // binary stream for reading from the file
SFXBuffer buffer;  // buffer to be read
buffer.SetSize(4);  // it is necessary to set buffer size in advance.

// open the file in the read only mode
file.OpenReadOnly(SFXPath("/dir/data.txt"));

// get the binary stream for reading from the file
// * the stream buffer is variable since the size argument is not specified
file.GetStreamReader(&reader);

// read data from the file into the stream buffer
// * the stream buffer will be expanded automatically depending on the size of data to be read into
//    the read operation will finish by calling the Fetch function once
reader.Fetch();

// read data from the stream buffer into the buffer variable
reader >> buffer;   // get first 4 byte: 11 22 33 44 (hexadecimal number), store in buffer
reader >> buffer;   // get next 4 byte: 55 11 22 33 (hexadecimal number), store in buffer

// here, data of 3 bytes remain in the stream buffer
// since the size of buffer 4 byte, data to be read is bigger than data which remain in the stream buffer.
reader >> buffer;  // after this statement, even if the stream try to be read, 
                   // the content of buffer will remain to be "55 11 22 33" (HEX format).
                   // In case of calling the Read function, the SFERR_FAILED error will be returned.

// release the binary stream for reading from the file
reader.Release();

// close the file
file.Close();

Example 17.20. Writing from the Buffer Class into the Binary Stream

// *** in the code below, the error handling is omitted.
SFXFile file;                  // file
SFXBinaryStreamWriter writer;  // binary stream for writing into the file
SFXBuffer buffer;              // buffer
AChar data[] = {0x11, 0x22, 0x33, 0x44, 0x55};  // data to set to the buffer

buffer.Set(data, 5);  // set the buffer to 5 bytes of data

// open the file in the read-write mode
file.OpenReadWrite(SFXPath("/dir/data.txt"));

// get the string stream for writing into the file
// * the stream buffer is variable since the size argument is not specified
file.GetStreamWriter(&writer);

writer << buffer; // write 5 bytes of data
writer << buffer; // write 5 bytes of data

// write data from the stream buffer into the file
// * the write operation will finish by calling the Flush function once
writer.Flush();

// release the binary stream for writing into the file
writer.Release();

// close the file
file.Close();

Example 17.21. The binary sequence in hexadecimal to be written

11 22 33 44 55 11 22 33 44 55  // HEX format