tblmod

(tblmod table_list)

The tblmod function modifies a table-entry by a new table_list.

The argument table_list passes an association list containing the information of the table type and table item to be modified to the function.

The association list has the same structure as an association list returned by the functions tblnext and tblsearch.

Valid names of table types are: BLOCK, DIMSTYLE, GROUP, LAYER, LTYPE, STYLE, UCS, VIEW, and VPORT.

Before modifying an existing table entry, the tblmod function tests the validity of the contents of the supplied group codes for the corresponding table type and table item name.

Return Value

The tblmod function returns nil and modifies no table entry, if one or more group codes required for a complete table record modification are missing.

• The type of the table to be enhanced with a new record (Layer, LineStyle, Custom Coordinate System, etc.) must be specified with the group code 0 in the result buffer.
• The name of the table entry to be created must be supplied with the group code 2 of the result buffer list.

If the modification of a table entry succeeds, the drawing is redrawn automatically if necessary.

Examples

Change color of layer 0 (Code 62)

(tblmod (list (cons 0 "LAYER")(cons 2 "0")(cons 62 1)))

or:

(setq x (tblnext "LAYER" T))

(setq x (subst (cons 62 1)(assoc 62 x) x))

(tblmod x)