acdbEntGetX

C++

struct resbuf * acdbEntGetX(
    const ads_name ent, 
    const struct resbuf * args
);

File

acedads.h

Description

Retrieves the entity specified by ent from the drawing database including extended entity data that is registered to the application, and returns its definition data as a linked list of result buffers.

If args is a null pointer, acdbEntGetX() is equivalent to acdbEntGet() and returns only the regular definition data in exactly the same fashion. If the args list is not null, acdbEntGetX() returns the extended entity data for each valid application name in the list. (This saves the application from having to look at or manage the space of extended entity data belonging to other applications.) To be valid, an application name must have been placed in the current drawing's APPID symbol table by a prior call to acdbRegApp().

Names in the args list can be wild-card patterns. The rules for patterns in the apps list are the same as those used by acutWcMatch(). In this case, acdbEntGetX() returns the extended entity data of each application whose name matches the pattern.

If a pattern contains only "*", acdbEntGetX() returns all the extended data belonging to the specified entity, whether or not it belongs to the current application.

If it cannot find ent in the current database, acdbEntGetX() returns null. When acdbEntGetX() fails, it sets the system variable ERRNO to a value that indicates the reason for the failure.

Parameters