HomeSYNOPSIS
mtd16:append(tag, data)
DESCRIPTION
Append a new data field at the end of the message. If tag is not a number, it is looked up in the table mtd16.lutTag to get its numerical value.
The value of data must be appropriate for the type of tag. Alternatively, if data is nil, the command is ignored, appending nothing. This avoids needing to if-check each optional data item.
For IP Addresses, specify the value in dotted quad notation.
ERRORS
Raises an error if tag could not be converted to a number by looking it up in
mtd16.lutTag. Also raises an error if the contents of data cannot be encoded into the
data type indicated by tag.
EXAMPLE
>
>
>
msg = mtd16.new(0xF00F)
msg:append(0x3001, "FNORD!")
print(msg:trace())
0xF00F=(0x3001="FNORD!")
SEE ALSO
#mtd16, mtd16.answerCode, mtd16.fromData, mtd16.fromText, mtd16.isNestedTag, mtd16.lutType, mtd16.new, mtd16.tagCode, mtd16.tagName, mtd16.tagNumber, mtd16.tagType, mtd16:appendMessageCode, mtd16:contains, mtd16:get, mtd16:getNumber, mtd16:getString, mtd16:isEmpty, mtd16:isValid, mtd16:messageCode, mtd16:nextMessageCode, mtd16:pairs, mtd16:rewind, mtd16:tags, mtd16:toData, mtd16:toText, mtd16:trace, tostring(mtd16)