Site Menu Project Specification Implementation Recommendations Reference Needs Updating Work in Progress Wastebasket Wiki Manual |
Serialised Scalar FormatWiP.SerialisedScalarFormat HistoryHide minor edits - Show changes to markup 2010-04-13 14:58
by -
Changed lines 18-19 from:
to:
Changed line 24 from:
to:
Changed lines 26-27 from:
to:
Changed lines 71-72 from:
digitB32 digitB32 ; // allocated length, value between 7 and 1023 to:
digitB32 digitB32 ; // allocated length, value between 8 and 1023 Changed lines 77-78 from:
digitB32 digitB32 ; // digit count of significand, value between 1 and 1000 to:
digitB32 digitB32 ; // digit count of significand, value between 1 and 999 Changed line 80 from:
digitB32 ; // digit count of exponent, value between 0 and 18 to:
digitB32 ; // digit count of exponent, value between 0 and 15 2010-04-13 14:51
by -
Added line 23:
Changed line 64 from:
length encoding sigDigitCount expDigitCount to:
version length encoding sigDigitCount expDigitCount Added lines 66-68:
version: digitB32 ; protocol version, at present the value is always 1 2010-04-10 12:39
by -
Changed lines 25-26 from:
to:
2010-04-10 11:41
by - 2010-04-10 11:29
by -
Changed line 110 from:
in serialized. The output is shortened if the size of the passed in character array to:
in <serialized>. The output is shortened if the size of the passed in character array Changed line 115 from:
and passes the result back in value. *) to:
and passes the result back in <value>. *) 2010-04-10 11:28
by -
Changed line 105 from:
The following conversion primitives should be implemented by all library defined scalar types to:
The following conversion primitives should be implemented by all library defined scalar types to facilitate conversion between all numeric types even if no direct conversion path exists: 2010-04-10 11:27
by -
Changed line 113 from:
PROCEDURE [FROM] fromSerializedScalar ( VAR value : <Scalar Type?>; serialized : ARRAY OF CHAR ); to:
PROCEDURE [FROM] fromSerialized ( VAR value : <Scalar Type?>; serialized : ARRAY OF CHAR ); 2010-04-10 11:27
by -
Changed lines 105-106 from:
The following conversion primitives to:
The following conversion primitives should be implemented by all library defined scalar types Changed line 108 from:
PROCEDURE toSerializedScalar ( value : <Scalar Type?>; VAR serialized : ARRAY OF CHAR ); to:
PROCEDURE [TO] toSerialized ( value : <Scalar Type?>; VAR serialized : ARRAY OF CHAR ); Changed line 113 from:
PROCEDURE fromSerializedScalar ( VAR value : <Scalar Type?>; serialized : ARRAY OF CHAR ); to:
PROCEDURE [FROM] fromSerializedScalar ( VAR value : <Scalar Type?>; serialized : ARRAY OF CHAR ); 2010-04-10 11:23
by -
Changed lines 110-111 from:
in serialized. The output is shortened if the size of the passed in character array is insufficient to represent all available digits. *) to:
in serialized. The output is shortened if the size of the passed in character array is insufficient to represent all available digits. *) 2010-04-10 11:22
by -
Changed lines 110-111 from:
in serialized. The output is shortened if the size of the string passed in for serialized is insufficient to represent all available digits. *) to:
in serialized. The output is shortened if the size of the passed in character array is insufficient to represent all available digits. *) 2010-04-10 11:22
by -
Changed lines 109-111 from:
(* Converts <value> to its serialised scalar representation and passes the result back in serialized. *) to:
(* Converts <value> to its serialised scalar representation and passes the result back in serialized. The output is shortened if the size of the string passed in for serialized is insufficient to represent all available digits. *) 2010-04-10 11:19
by -
Changed lines 109-110 from:
(* Converts <value> to its serialised scalar representation and passes the result back in serialized. *) to:
(* Converts <value> to its serialised scalar representation and passes the result back in serialized. *) 2010-04-10 11:15
by -
Changed line 3 from:
The following describes an ASCII based serialisation format for numeric scalar values. to:
The following describes an ASCII based serialisation format for numeric scalar values and conversion primitives to convert between numeric and serialised representation. 2010-04-10 11:12
by -
Changed line 110 from:
and passes the result back in serializedScalar. *) to:
and passes the result back in serialized. *) 2010-04-10 11:12
by -
Changed line 108 from:
PROCEDURE toSerializedScalar ( value : <Scalar Type?>; VAR serializedScalar : ARRAY OF CHAR ); to:
PROCEDURE toSerializedScalar ( value : <Scalar Type?>; VAR serialized : ARRAY OF CHAR ); Changed line 112 from:
PROCEDURE fromSerializedScalar ( VAR value : <Scalar Type?>; serializedScalar : ARRAY OF CHAR ); to:
PROCEDURE fromSerializedScalar ( VAR value : <Scalar Type?>; serialized : ARRAY OF CHAR ); 2010-04-10 11:10
by -
Changed lines 108-112 from:
PROCEDURE toSerialisedScalar ( value : <Scalar Type?>; VAR serialised : ARRAY OF CHAR ); (* Converts value to its serialised scalar presentation and passes the result back in serialised. *) PROCEDURE fromSerialisedScalar ( VAR value : <Scalar Type?>; serialised : ARRAY OF CHAR ); (* Converts the passed in serialised scalar to a value of type <Scalar Type?> and passes the result back in value. *) to:
PROCEDURE toSerializedScalar ( value : <Scalar Type?>; VAR serializedScalar : ARRAY OF CHAR ); (* Converts <value> to its serialised scalar representation and passes the result back in serializedScalar. *) PROCEDURE fromSerializedScalar ( VAR value : <Scalar Type?>; serializedScalar : ARRAY OF CHAR ); (* Converts the passed in serialised scalar to a value of type <Scalar Type?> and passes the result back in value. *) 2010-04-10 11:07
by -
Changed lines 101-113 from:
@] to:
@] Conversion PrimitivesThe following conversion primitives PROCEDURE toSerialisedScalar ( value : <ScalarType>; VAR serialised : ARRAY OF CHAR ); (* Converts value to its serialised scalar presentation and passes the result back in serialised. *) PROCEDURE fromSerialisedScalar ( VAR value : <ScalarType>; serialised : ARRAY OF CHAR ); (* Converts the passed in serialised scalar to a value of type <ScalarType> and passes the result back in value. *) 2010-04-10 10:20
by -
Changed lines 48-49 from:
Base10 serialisation is a radix 10 based ASCII encoding of numeric values. Digits are represented by the ASCII characters in the code point range from decimal 48 ("0"), indicating 0, to decimal 57 ("9"), indicating 9. to:
Base10 serialisation is a radix 10 based ASCII encoding of numeric values. Digits are represented by the ASCII characters in the code point range from decimal 48 ("0") indicating 0, to decimal 57 ("9") indicating 9. Changed lines 52-53 from:
Base16 serialisation is a radix 16 based ASCII encoding of numeric values. Digits are represented by the ASCII characters in the code point range from decimal 48 ("0"), indicating 0, to decimal 63 ("?"), indicating 15. to:
Base16 serialisation is a radix 16 based ASCII encoding of numeric values. Digits are represented by the ASCII characters in the code point range from decimal 48 ("0") indicating 0, to decimal 63 ("?") indicating 15. Changed line 56 from:
Base32 serialisation is a radix 32 based ASCII encoding of numeric values. Digits are represented by the ASCII characters in the code point range from decimal 48 ("0"), indicating 0, to decimal 79 ("O"), indicating 31. to:
Base32 serialisation is a radix 32 based ASCII encoding of numeric values. Digits are represented by the ASCII characters in the code point range from decimal 48 ("0") indicating 0, to decimal 79 ("O") indicating 31. 2010-04-10 10:18
by -
Changed lines 37-42 from:
For all encodings, digits appear in highest to lowest significance. to:
The digits in an encoded digit stream appear in highest to lowest significance order and represent the roots of a polynom of the form: Added lines 41-44:
2010-04-10 10:12
by -
Deleted line 44:
value = digitn * radix n + digitn-1 * radix n-1 ... + digit2 * radix 2 + digit1 * radix 1 + digit0 * radix 0 2010-04-10 10:11
by -
Changed line 43 from:
value = digit0 * radix n-0 + digit1 * radix n-1 + ... + digitn-1 * radix 1 + digitn * radix 0 to:
value = digit0 * radix n + digit1 * radix n-1 + digit2 * radix n-2 + ... + digitn-1 * radix 1 + digitn * radix 0 2010-04-10 10:10
by -
Changed line 43 from:
value = digit0 * radix '^n-0^ + digit1 * radix '^n-1^ + ... + digitn-1 * radix '^1^ + digitn * radix '^0^ to:
value = digit0 * radix n-0 + digit1 * radix n-1 + ... + digitn-1 * radix 1 + digitn * radix 0 2010-04-10 10:10
by -
Added lines 42-43:
value = digit0 * radix '^n-0^ + digit1 * radix '^n-1^ + ... + digitn-1 * radix '^1^ + digitn * radix '^0^ 2010-04-10 10:05
by -
Changed line 43 from:
encodedValue = digitn * radix n + digitn-1 * radix n-1 ... + digit1 * radix 1 + digit0 * radix 0 to:
value = digitn * radix n + digitn-1 * radix n-1 ... + digit2 * radix 2 + digit1 * radix 1 + digit0 * radix 0 2010-04-10 10:04
by -
Changed line 43 from:
encodedValue = digitn * radix n + digitn-1 * radix n-1 ... + digit0 * radix 0 to:
encodedValue = digitn * radix n + digitn-1 * radix n-1 ... + digit1 * radix 1 + digit0 * radix 0 2010-04-10 10:03
by -
Added lines 40-43:
For all encodings, digits appear in highest to lowest significance. encodedValue = digitn * radix n + digitn-1 * radix n-1 ... + digit0 * radix 0 2010-04-10 09:59
by -
Changed line 37 from:
to:
2010-04-10 09:58
by -
Added lines 34-52:
Encoding of Numeric Values
Base10 SerialisationBase10 serialisation is a radix 10 based ASCII encoding of numeric values. Digits are represented by the ASCII characters in the code point range from decimal 48 ("0"), indicating 0, to decimal 57 ("9"), indicating 9. Base16 SerialisationBase16 serialisation is a radix 16 based ASCII encoding of numeric values. Digits are represented by the ASCII characters in the code point range from decimal 48 ("0"), indicating 0, to decimal 63 ("?"), indicating 15. Base32 SerialisationBase32 serialisation is a radix 32 based ASCII encoding of numeric values. Digits are represented by the ASCII characters in the code point range from decimal 48 ("0"), indicating 0, to decimal 79 ("O"), indicating 31. 2010-04-10 09:46
by -
Added line 32:
2010-04-10 09:46
by -
Changed lines 32-33 from:
[1] If the value of the exponent's digit count field is zero, then no exponent is encoded to:
[1] If the value of the exponent's digit count field is zero, then no exponent is encoded. 2010-04-10 09:45
by -
Changed lines 20-22 from:
Meta-DataA serialised scalar contains the following meta-data: to:
Data FieldsA serialised scalar contains the following data fields: Changed lines 29-30 from:
to:
Added lines 32-33:
[1] If the value of the exponent's digit count field is zero, then no exponent is encoded 2010-04-10 09:43
by -
Added lines 19-31:
Meta-DataA serialised scalar contains the following meta-data:
2010-04-10 09:32
by -
Changed line 18 from:
to:
2010-04-10 09:31
by -
Changed lines 18-20 from:
to:
Changed lines 34-35 from:
digitB32 digitB32 ; // digit count of significand, value between 1 and 1018 to:
digitB32 digitB32 ; // digit count of significand, value between 1 and 1000 Changed line 37 from:
digitB32 ; // digit count of exponent, value between 0 and 31 to:
digitB32 ; // digit count of exponent, value between 0 and 18 2010-04-10 09:26
by -
Added lines 18-19:
2010-04-10 09:16
by -
Changed lines 13-16 from:
to:
2010-04-10 09:09
by -
Changed lines 1-2 from:
Objectiveto:
SynopsisAdded lines 4-13:
ObjectivesThe serialised format needs to meet the following objectives:
2010-04-10 08:56
by -
Added lines 1-47:
ObjectiveThe following describes an ASCII based serialisation format for numeric scalar values. EBNFserialisedScalarFormat : length encoding sigDigitCount expDigitCount sigSign sigDigits ( expSign expDigits )? terminator ; length : digitB32 digitB32 ; // allocated length, value between 7 and 1023 encoding : "D" | "H" ; // radix system, D for base 10, H for base 16 sigDigitCount : digitB32 digitB32 ; // digit count of significand, value between 1 and 1018 expDigitCount : digitB32 ; // digit count of exponent, value between 0 and 31 sigSign : "+" | "-" ; // sign of significand sigDigits : digitB10+ | digitB16+ ; // digits of significand expSign : "+" | "-" ; // sign of exponent expDigits : digitB10+ | digitB16+ ; // digits of exponent digitB10 : "0" .. "9" ; // representing values between 0 and 9 digitB16 : "0" .. "?" ; // representing values between 0 and 15 digitB32 : "0" .. "O" ; // representing values between 0 and 31 terminator : ASCII(0) ; |