icetSetContext(3)

NAME

icetSetContext -- changes the current context.

Synopsis

#include <IceT.h>

void icetSetContext( | IceTContext | context );

Description

The icetSetContext function sets the IceT state machine to work with the context defined by context and the state associated with it. Further calls to IceT functions will operate based on the state encapsulated in context. Changing the state of the context is a fast operation.

Errors

ICET_INVALID_VALUE
     context is not valid.

Warnings

None.

Bugs

None known.

Notes

The behavior of icetSetContext is somewhat indeterminate if context is not valid. Usually, an ICET_INVALID_VALUE error will be raised, but it is possible that the context will be set to some other context.

Copyright

Copyright (C)2003 Sandia Corporation

Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation, the U.S. Government retains certain rights in this software.

This source code is released under the New BSD License.

See Also

icetGetContext(3), icetCreateContext(3), icetCopyState(3)