acdbEntNext

C++

int acdbEntNext(
    const ads_name ent, 
    ads_name result
);

File

acedads.h

Description

Gets the name of the entity following the specified entity in the drawing database.

The acdbEntNext() function can be used with acedSSGet(), which selects only main entities. To access the internal structure of a main entity, find the main entity by calling acedSSGet(), and then "walk through" the subentities with calls to acdbEntNext(). Conversely, to find the main entry for a subentity that you have already found, walk forward with acdbEntNext() until you find the seqend subentity, and use acdbEntGet() to access it. The seqend subentity will have a group (restype == -2) that specifies the name of the main entity (resval.rlname).

If acdbEntNext() succeeds, it returns a status of RTNORM; otherwise, it returns an error code. When it fails it is usually because ent is not the name of a valid entity in the current database, or because ent is the last (nondeleted) entity and no entity follows it. In both cases acdbEntNext() returns RTERROR. When acdbEntNext() fails, it sets the system variable ERRNO to a value that indicates the reason for the failure.

Parameters

Returns

Name of the (nondeleted) entity immediately following ent in the database; either a main entity or a subentity but not a nongraphical object