Removes all instances from an instance container identified by its containerId. The removed instances will not be removed from the model.
Related functions: edmiCreateInstanceContainer, edmiDeleteInstanceContainer, edmiDeleteInstanceContainerBN, edmiEmptyContainerBN, edmiGetInstanceContainerId, edmiGetInstanceContainers, edmiSetContainerCheckedout, edmiSetContainerCheckedoutBN, edmiUnsetContainerCheckedout, edmiUnsetContainerCheckedoutBN, edmiInstanceToContainer, edmiInstanceToContainerBN, edmiInstancesToContainer, edmiInstancesToContainerBN.
Header:
#include "sdai.h"
Prototype:
EdmiError edmiEmptyContainer(SdaiContainer containerId);
Arguments:
containerId |
A numeric containerID that uniquely identifies the container within the EDMdatabase. |
Returns:
A completion code of datatype EdmiError is the returned function value. The completion code has the following values:
Completion code = 0: Operation successfully performed.
Completion code != 0: Error in operation. Completion code is an EDMinterface error code. Use edmiGetErrorText to get the error text corresponding to the error code.
Example:
EdmiError rstat;
SdaiContainer contId;
. . .
if (rstat = edmiEmptyContainer(contId)) {
printf("\nError %d in edmiEmptyContainer: %s", rstat,
edmiGetErrorText(rstat));
goto err;
}
. . .