This function inserts the table title (caption) str into the table containing toidId. The function returns the oid of the new table title if one was inserted, or it returns the oid of a previously existing table title. If the table's table model does not allow table titles or the insert otherwise fails, the function returns null_oid.

The HTML table model supports table titles with the caption element. Custom table models may be configured to support table titles. The CALS and Arbortext table models do not support table titles.