Data Formats

A textual representation of a string is either an atom - a sequence of latin letters (in the ASCII encoding) and digits, or a quoted string - a sequence of any printable symbols (using the UTF-8 encoding) except the quotation mark and the backslash symbol, enclosed into the quotation marks (").

Examples:

MyName   My2ndName   "My Name with spaces and the . symbol"

If you want to include the quotation mark symbol into a quoted string, include the backslash symbol and the quotation mark, if you want to include the backslash symbol into a quoted string, include two backslash symbols.

Examples:

"a \"string\" within string"   "Single \\ backslash"

You can use the \r symbol combination to include the carriage-return symbol into a string, you can use the \n symbol combination to include the line-feed symbol into a string, and your can use the \e symbol combination to include the system-independent End-Of-Line symbol(s) into a string.

Examples:

"Line1\eLine2"   "TEXT3\rTEXT67\nTEXT78"

Use the \r or \n combinations to include the carriage-return and line-feed characters only when they are NOT used as line separators.

You can use the \t symbol combination to include the tabulation symbol into a string.

Example:

"Line1:\tField1\tField2\eLine2:\tField1\tField2"

You can use the \nnn symbol combination to include any symbol into a string, if nnn is a 3-digit decimal number equal to the ASCII code of the desired symbol.

Example:

"Using the \012 (Vertical Tabulation) symbol"

DataBlocks are basic, unstructured blocks of binary data. They are composed as text strings with the Base64 encoding of binary data enclosed into brackets.

Example:

[HcqHfHI=]
this is a binary block containing the following 5 binary data bytes: 0x1D 0xCA 0x87 0x7C 0x72

Numbers are basic, unstructured data objects. Each Number object contains one 64-bit signed integer value. A Number is presented as a text string starting with the # symbol, followed by an optional minus (-) symbol, followed by 1 or more decimal digits.

Example:

#-234657

Time Stamps are basic, unstructured data objects. Each Time Stamp object contains one global time value. The time value is presented in GMT time, as a text string starting with the #T symbols, and containing the day, months, year, and, optionally, the hour, minute, and the second values.

Example:

#T22-10-2007_15:24:45

IP Addresses are basic, unstructured data objects. Each IP Address object contains an IPv4 or IPv6 address, and, optionally a port number. The IP Address is presented as a text string starting with the #I symbols, and containing the canonical IPv4 or IPv6 address, optionally followed by the port number.

Examples:

#I[10.0.44.55]:25  #I[2001:470:1f01:2565::a:80f]:25

Array textual representation is a list of its element representations, separated with the comma (,) symbols, and enclosed into the parentheses.

Example:

(Element1 , "Element2" , "Element 3")

An array element can be any object - a string, an array, a dictionary, etc.

Example:

(Element1 , ("Sub Element1", SubElement2) , "Element 3")

Any number of spaces, tabulation symbols, and/or line breaks (end-of-line symbols) can be placed between a parenthesis and an element, and between an element and a comma symbol.

Example:

(
  Element1  ,
  (    "Sub Element1",
   SubElement2  )
  ,
"Element 3"  )

An array may have zero elements (an empty array).

Example:

()

A dictionary textual representation is a sequence of its key value pairs, enclosed into the curvy brackets.
Each pair is represented as its key string representation, followed by the equal (=) symbol, followed by the textual representation of the associated value object, followed by the semicolon (;) symbol.

Example:

{Key1=Element1; Key2 ="Element2" ; "Third Key"="Element 3"; }

The value object in any key-value pair can be a string, an array, a dictionary, or any other object.

Example:

{Key1=(Elem1,Elem2); Key2={Sub1="XXX 1"; Sub2=X245;}; }

Any number of spaces, tabulation symbols, and/or line breaks (end-of-line symbols) can be placed between a bracket and a pair, around the equal symbol, and around the semicolon symbol.

Example:

{
 Key1  =   (Elem1,Elem2)   ;
 Key2 = {  Sub1 = "XXX 1";
    Sub2=X245;  };
}

A dictionary may have zero elements (an empty dictionary).

Example:

{}