std-tbl


Synopsis

(std-tbl <tbl> <match> <must> <ignore>)

Description

"general table name accessor"

STD-TBL scans the table entries in the current AutoCAD drawing for the given table and returns a list of the associated names dependent of the three filters match must and ignore.

It returns all table names which flags in <must> must be set, and which flags in <ignore> may not be set, using wcmatch with <match> on the name.

to be continued

The following constants are defined to make the function call readable.

Flags for STD-TBL, common table groups:

STD:TBL-ALL 0

STD:TBL-EXTERN 16 ; external dependent (XREF)

STD:TBL-BOUND 32 ; bound external xref

STD:TBL-EXIST 64 ; referenced, not valid if >= r13

Note

The more specific function STD-TBL-LAYER defines one additional argument for the ON/OFF status and some more constants which might be useful here also:

STD:LAY-THAWED 0

STD:LAY-FROZEN 1

STD:LAY-LOCKED 4

STD:LAY-EXIST 64

STD:LAY-EXTERN 48

STD:LAY-ON 1

STD:LAY-OFF -1

STD:LAY-ON-OR-OFF 0

Exceptional Situation

If tbl doesn't match satisfy STD-TBL-P an AutoLISP error will occur.

Example

(std-tbl "LAYER" "*" STD:TBL-ALL STD:TBL-ALL)
=> all layer names

(std-tbl "BLOCK" "A*" STD:TBL-EXIST STD:TBL-ALL)
=> all existing block names starting with "A"

Arguments

tbl: string which must be a valid symbol table, see std-tbl-p

match: a string, suitable for wcmatch.

must: a integer, a positive bit filter for the table flag 70.

ignore: a integer, a negative bit filter for the table flag 70.

Return Value

String-list. A list of table names.

Side Effects

None.

Module

(std-require 'STDTBL)

Defined in STDTBL