Synopsis

PDX_MSGT iges_GetParents(long option, MDA_PTR db_ptr, long *count, MDA_PTR **parent_list)

Purpose

Get parent IGES entities.

Description

The list of entities which reference db_ptr is returned. By default this fuction behaves same as mda_GetParents(). If the IGES_NO_DE option is specified, the parent references db_ptr through its DE field is excluded. If the IGES_NO_PD option is specified, the parent references db_ptr through its PD section is excluded. If the IGES_NO_PROP option the parent references db_ptr through its property is excluded. If the IGES_NO_BP is specified, the parent references db_ptr through its associativity back pointer. The memory to contain the list is allocated by this function and must be freed by the caller. If the caller is not part of libiges, the list must be freed by calling iges_Free. The number of pointers in parent_list is returned in count. If the entity does not have any parents then count will be returned as 0 and no memory will be allocated in parent_list. Note that some pointers in parent_list may be duplicated if a single parent makes multiple references to db_ptr. See the mda_GetParent man page for more information.

Input

option

IGES_NO_DE

Exclude the parent which references db_ptr through its DE field.

IGES_NO_PD

Exclude the parent which references db_ptr through its PD section.

IGES_NO_PROP

Exclude the parent which references db_ptr through its property.

IGES_NO_BP

Exclude the parent which references db_ptr through its back pointer.

db_ptr

Entity to obtain parents for

Output

count

Number of referencing pointers

parent_list

Array of referencing entity pointers (must be freed by the caller, using iges_Free if the caller is not part of libiges).

Return

IGES error code