This function inserts a new row or column, of the same type as table object toid, before or after toid as indicated by a nonzero value in addBefore. It returns the ID of the newly-inserted row or column.

For custom tables, when multiple elements are acceptable to be used as the row element, if the tagname parameter is supplied, then the tagname element is inserted.