Determine the next object after this object.
This function returns the name of the first non-deleted object in the database when no arguments are supplied. If an object name is supplied, sds_entnext returns the next object following the given entity1. When there is no next object in the database, sds_entnext returns RTERROR.
The argument entity1 is a known object name. This can be NULL, in which case sds_entnext gives the name of the first object in the drawing. The argument entity2 represents the name of the next object in the drawing, or the first object if entity1 is NULL.
This function returns RTNORM, if it succeeds, or RTERROR if entity1 is invalid or the last (non-deleted) entity in the drawing.
Example
sds_name entity1,entity2;
char string1[512];
sds_entsel("\nPick an object: ",entity1,point1);
sds_getstring(0,"\nPress Enter to highlight the next object: ",string1);
sds_entnext(entity1,entity2); Finds the name of the next object.
sds_redraw(entity2,3); Highlights the next object.
Tell me about...
Programming Overview of SDS™ (Solutions Development System™)