NAME

Data::Sofu::Binary::Bin0200 - Driver for Sofu Binary version 0.2.0.0

DESCRIPTION

Driver for Data::Sofu::Binary and Data::Sofu

Synopsis

See Data::Sofu::Binary

SYNTAX

This Module is pure OO, exports nothing

METHODS

See also Data::Sofu::Binary for public methods.

All these methods are INTERNAL, not for use outside of this module...

Except pack().

new()

Creates a new Binary Driver using DRIVER or the latest one available.

        require Data::Sofu::Binary;
        $bsofu = Data::Sofu::Binary->new("000_002_000_000"); Taking this driver;
        #You can call it directly:
        require Data::Sofu::Binary::Bin0200;
        $bsofu = Data::Sofu::Binary::Bin0200->new(); #The same

encoding(ID)

Switches and/or detetect the encoding.

See pack() for more on encodings.

byteorder(BOM)

Internal method.

Switches the byteorder.

See pack() for more on byteorders.

bom(BOM)

Internal method.

Detects the byteorder.

See pack() for more on byteorders.

packShort(INT)

Packs one int-16 to binary using the set byteorder

packLong(INT)

Packs one int-32 to binary using the set byteorder

packendian()

Returns the byte order mark for this file.

packversion()

Returns the version of this driver to put in the file.

packencoding()

Returns the current encoding to put in the output file.

getType()

Tries to find out what SofuObject to deserialise next

Returns:

0 for Undefined / undef

1 for Value / Scalar

2 for List / Array

3 for Map / Hash

4 for Reference / Ref

objectprocess()

Postprocess the SofuObjects, sets References to their targets.

postprocess()

Postprocess perl datastructures , sets References to their targets.

getLong()

Decodes one Int-32 from the input stream according to the byteorder and returns it.

getText()

Decodes one String according to encoding from the inputstream and returns it

getComment(TREE)

decodes one comment and sets it to TREE

TREE can be a string describing the tree or a Data::Sofu::Object.

unpackUndef(TREE)

Returns undef and packs it comment

unpackScalar(TREE)

Decodes one scalar and its comment.

unpackRef(TREE)

Decodes one ref and its comment.

unpackHash(TREE)

Decodes a hash, its comment and its content

unpackHash(TREE)

Decodes an array, its comment and its content

`unpackType(TYPE,TREE)`

Decodes a datastructure of TYPE.

unpack(BOM)

Starts unpacking using BOM, gets encoding and the contents

unpackUndefined(TREE)

Unpacks a Data::Sofu::Undefined and its comment.

unpackValue(TREE)

Unpacks a Data::Sofu::Value, its content and its comment.

unpackReference(TREE)

Unpacks a Data::Sofu::Reference, its content and its comment.

unpackMap(TREE)

Unpacks a Data::Sofu::Map, its content and its comment.

unpackMap2(TREE)

Unpacks a Data::Sofu::Map, its content and its comment.

(Speed optimized, but uses dirty tricks)

unpackList(TREE)

Unpacks a Data::Sofu::List, its content and its comment.

unpackList2(TREE)

Unpacks a Data::Sofu::List, its content and its comment.

(Speed optimized, but uses dirty tricks)

`unpackObjectType(TYPE,TREE)`

Unpacks a datastructure defined by TYPE

unpack(BOM)

Starts unpacking into a Data::Sofu::Object structure using BOM, gets encoding and the contents

packType(TYPE)

Encodes Type information and returns it.

packText(STRING)

Encodes a STRING using Encoding and returns it.

`packData(DATA,TREE)`

Encodes one perl datastructure and its contents and returns it.

`packArray(DATA,TREE)`

Encodes one perl array and its contents and returns it.

`packArray(DATA,TREE)`

Encodes one perl hash and its contents and returns it.

`pack(TREE,[COMMENTS,[ENCODING,[BYTEORDER,[SOFUMARK]]]])`

Packs a structure (TREE) into a string using the Sofu binary file format.

Returns a string representing TREE.

TREE

Perl datastructure to pack. Can be a hash, array or scalar (or array of hashes of hashes of arrays or whatever). Anything NOT a hash will be converted to TREE={Value=>TREE};

It can also be a Data::Sofu::Object or derived (Data::Sofu::Map, Data::Sofu::List, Data::Sofu::Value, Data::Sofu::...). Anything not a Data::Sofu::Map will be converted to one (A Map with one attribute called "Value" that holds TREE).

COMMENTS

Comment hash (as returned by Data::Sofu::getSofucomments() or Data::Sofu->new()->comments() after any file was read).

Can be undef or {}.

ENCODING

Specifies the encoding of the strings in the binary sofu file, which can be:

"0" or "UTF-8"

This is default.

Normal UTF-8 encoding (supports almost all chars)

"1" or "UTF-7"

This is default for byteorder = 7Bit (See below)

7Bit encoding (if your transport stream isn't 8-Bit safe

"2" or "UTF-16"

UTF 16 with byte order mark in EVERY string.

Byteoder depends on your machine

"3" or "UTF-16BE"

No BOM, always BigEndian

"4" or "UTF-16LE"

No BOM, always LittleEndian

"5" or "UTF-32"

UTF-32 with byte order mark in EVERY string.

Byteoder depends on your machine

"6" or "UTF-32BE"

No BOM, always BigEndian

"7" or "UTF-32LE"

No BOM, always LittleEndian

"8","9"

Reserved for future use

"10" or "ascii"

Normal ASCII encoding