NAME¶

icetSetContext -- changes the current context.

Synopsis¶

#include <IceT.h>

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)