tbl_insert
id = tbl_insert (tmid, oid, pos, rows, cols, [tagname])
This function inserts a new table, specified by table model tmid, with rows rows and cols columns, into the document at the point indicated by oid and pos. If tmid is zero (0), then the primary table model for the document type will be used.
tagname is only used by document types that use wrappers. Some document types allow several different tags to serve as the wrapper tag surrounding a table. tagname is used to specify a wrapper tag; if tagname is omitted, the outer wrapper tag is chosen at random.
For custom tables, the cols value is ignored.
|
|
If you have applied an alias map to the document, tagname can be an alias, as well as a real name. |
|
|
If the document type definition for your document instance includes the NAMECASE GENERAL NO setting, then the tagname parameter will be case-sensitive.
|
It returns the ID of the newly-inserted table set if successful, h::tblNullToid otherwise.
The
tbl_insert function will not do a pending delete regardless of the setting of
set pendingdelete.
