Optional
valuethe value held by this schema node. used as a storage for interceptors to interact and read decoded value
it can also used as a means for storing default values for the encoder to utilize.
but besides those two scenarios, it should typically be left unassigned.
this also comes in handy when annotating types both for the encoder or decoder
Optional
namename of the node, used for object property key naming by parent SchemaRecordNode
Optional
docan optional doc string for this schema node, that should be cleared when MINIFY
is true
to achive that, you would want to write your doc strings as follows:
declare const [DEBUG, MINIFY, BUNDLE]: [boolean, boolean, boolean]
const my_schema_node: SPrimitive<number> {
type: "u4l",
doc: MINIFY || "a stupid description of this 32-bit unsinged little piece of endian."
}
there must be only a single child element that specifies the schema of the kind of items held by this array
there are two possible syntaxes, and the one that gets chosen is based on the length of this.args
args.length == 1
, then: args[0]
must specify the length of the array when decodingargs.length == 2
, then: args[0]
must specify the starting index, and args[1]
must specify the ending indexa mandatory kind descriptior of the primitive kind
manually set this
schema's type
to the provided type_name
, and also
register the new type_name
to global type_registery
if register = true
.
this is the only easy way to register type_name
s of sub-sub-classes of abstract SchemaNode.
check out SHeadArray to see how it extends SArray, but registers its own type_name = "headarray"
that's different from its parent class's type_name = "array"
Rest
...children: [item_schema: ItemSchema]Rest
...args: NonNullable<[index_start: number, index_end: number] | [len?: number]>Rest
...args: NonNullable<[index_start: number, index_end: number] | [len?: number]>Static
froman abstract static method that creates an instance of this
schema class, using a regular javascript object
Optional
child: ItemSchemaGenerated using TypeDoc
this behaves just like regular SArray, but has its array length stored in the head (beginning) bytes in the provided head_type byte format.