Name

pchange_struct_id − Changes a structure identifier. 

Operating States: PHOP, ∗, ∗, ∗
PHIGS standard function

Syntax

void pchange_struct_id (
  Pint    original_stid,    /∗ (I) Original structure identifier ∗/
  Pint    resulting_stid    /∗ (I) Resulting structure identifier ∗/
)

Description

pchange_struct_id changes the specified original structure identifier to the specified resulting structure identifier.  It does not change references to the original structure identifier.  This function produces the following effects:
 

•The structure associated with the original structure identifier no longer exists, unless there are references to the structure.  If references to the original structure exist, the original structure continues to exist, but as an empty structure. 

•The resulting structure always exists after execution of the function.  However, if the resulting structure previously existed, its contents are replaced by the contents of the original structure. 

•If the original structure did not exist, the resulting structure is empty. 

•If the original structure identifier and the resulting structure identifier are identical, one of the following results occurs:

•If this common structure already exists, no action is taken. 

•If this common structure does not exist, an empty structure is created. 

•If the original structure identifier was posted, it remains posted, but as an empty structure. 

•If the original structure identifier was posted before this function call, the resulting structure identifier remains posted after the call.  (This is the only condition under which the pchange_struct_id function posts the resulting structure.) 

•If the original structure is open, it is closed before the function is executed.  The structure is then reopened at the completion of the function, but exists as an empty structure.  The element pointer in the reopened original structure is set to 0. 

•If the resulting structure is open, it is closed before the function is executed.  The structure is reopened at the completion of the function.  The element pointer in the reopened resulting structure is set to the value it had at the start of the function. 

See Also

pchange_struct_id_refs
pchange_struct_refs
pexec_struct
pinq_posted_structs
pinq_struct_ids
pinq_struct_st
pinq_struct_status
popen_struct
ppost_struct