icetCopyState3
Usage
#include <IceT.h>
| void icetCopyState( | IceTContext | dest, |
| const IceTContext | src ); |
Overview
The icetCopyState function replaces the state of dest with the current state of src. This function can be used to quickly duplicate a context.
The IceTCommunicator object associated with dest is not changed (nor can it ever be). Consequently, the following state values are not copied either, since they refer to process ids that are directly tied to the IceTCommunicator object: ICET_RANK, ICET_NUM_PROCESSES, ICET_DATA_REPLICATION_GROUP, ICET_DATA_REPLICATION_GROUP_SIZE, ICET_COMPOSITE_ORDER, and ICET_PROCESS_ORDERS. However, every other state parameter is copied.
Errors
None.
Warnings
None.
Notes
Behavior is undefined if dest or src has never been created or has already been destroyed.
Releases
8 releases since Debian 6.0 (Squeeze); the text changed 3 times.