tbl_selection_matchnext
toid = tbl_selection_matchnext(selectionId)
This function supports iteration over the contents of selection object
selectionId by returning the Table Object ID (toid) of the next table object matching the search criteria specified on the most recent call to
tbl_selection_matchbegin. If this function is used immediately after a call to
tbl_selection_matchbegin, it will find the first match (that is, the match found by
tbl_selection_matchbegin). A subsequent call to this function will find the next match.
If there is no such object, it returns the value of h::tblNullToid.
This function searches for Table Object IDs per the following rules:
• Row, column, and cell toids from a single rectangle are returned in row-major order.
• Rule toids are returned in row major order.
• Set toids are returned in no particular order.