PEXCopyOCCValues- Copy the Values from One OCC to Another

Synopsis

 
   void PEXCopyOCCValues(
        PEXOCC src,
        unsigned long *mask,
        PEXOCC dest
     )
 

Arguments

src

A PEXOCC returned by a successful PEXCreateOCC call.

mask

A pointer to an array of one unsigned long indicating which values in the PEXOCCValues data structure the function should copy from src to dest.

dest

A PEXOCC returned from a successful call to PEXCreateOCC.

Returns

None.

Description

Invoke PEXCopyOCCValues to copy the values from one PEX OC Context to another PEX OC Context.

If the mask contains all zero bits, then this function does not copy any values and the dest OC Context remains unchanged. Otherwise, for each defined bit that is one, this function copies the corresponding value from the src (source) context to the corresponding value in the dest (target) context.

Build the mask with the PEXSetOCCValueMask function.

Errors

This function ignores any undefined bits in the mask field.

See Also

• PEXChangeOCC
• PEXCreateOCC
• PEXGetOCCValues
• PEXSetOCCValueMask

For an overview, see Bitmask/Value Interface.