Represents the result of a predicate function: a pair of the boolean result and a Constancy token indicating whether the function result is constant over "descendant" objects, or that it might vary over "descendant" objects. More...

#include <predicateLibrary.h>

Public Types
enum	Constancy : char { ConstantOverDescendants , MayVaryOverDescendants }

Public Member Functions
constexpr	SdfPredicateFunctionResult ()
	Default construction produces a 'false' result that 'MayVaryOverDescendants'.

	SdfPredicateFunctionResult (bool value)
	Construct with `value` and `MayVaryOverDescendants` constancy.

	SdfPredicateFunctionResult (bool value, Constancy constancy)
	Construct with `value` and `constancy`.

bool	GetValue () const
	Return the result value.

Constancy	GetConstancy () const
	Return the result constancy.

bool	IsConstant () const
	Return true if this result's constancy is ConstantOverDescendants.

	operator UnspecifiedBoolType () const
	doxygen

SdfPredicateFunctionResult	operator! () const
	Return a result with the opposite value but the same constancy.

void	SetAndPropagateConstancy (SdfPredicateFunctionResult other)
	Set this result's value to `other's` value, and propagate constancy; if both this and `other` are ConstantOverDescendants, this object's constancy remains ConstantOverDescendants.

Static Public Member Functions
static SdfPredicateFunctionResult	MakeConstant (bool value)
	Create with `value` and 'ConstantOverDescendants'.

static SdfPredicateFunctionResult	MakeVarying (bool value)
	Create with `value` and 'MayVaryOverDescendants'.

static SdfPredicateFunctionResult	And (SdfPredicateFunctionResult lhs, SdfPredicateFunctionResult rhs)
	Return the logical and of `lhs` and `rhs` with constancy propagation.

static SdfPredicateFunctionResult	Or (SdfPredicateFunctionResult lhs, SdfPredicateFunctionResult rhs)
	Return the logical or of `lhs` and `rhs` with constancy propagation.

Friends
bool	operator== (SdfPredicateFunctionResult lhs, SdfPredicateFunctionResult rhs)

bool	operator!= (SdfPredicateFunctionResult lhs, SdfPredicateFunctionResult rhs)

bool	operator== (SdfPredicateFunctionResult pfr, bool rhs)

bool	operator== (bool lhs, SdfPredicateFunctionResult pfr)

bool	operator!= (SdfPredicateFunctionResult pfr, bool rhs)

bool	operator!= (bool lhs, SdfPredicateFunctionResult pfr)

Detailed Description

Represents the result of a predicate function: a pair of the boolean result and a Constancy token indicating whether the function result is constant over "descendant" objects, or that it might vary over "descendant" objects.

Definition at line 97 of file predicateLibrary.h.

Member Enumeration Documentation

◆ Constancy

enum Constancy : char

Definition at line 100 of file predicateLibrary.h.

Constructor & Destructor Documentation

◆ SdfPredicateFunctionResult() [1/3]

constexpr SdfPredicateFunctionResult ( )

inlineconstexpr

Default construction produces a 'false' result that 'MayVaryOverDescendants'.

Definition at line 104 of file predicateLibrary.h.

◆ SdfPredicateFunctionResult() [2/3]

SdfPredicateFunctionResult ( bool value )

inlineexplicit

Construct with value and MayVaryOverDescendants constancy.

Definition at line 108 of file predicateLibrary.h.

◆ SdfPredicateFunctionResult() [3/3]

SdfPredicateFunctionResult	(	bool	value,
		Constancy	constancy
	)

inline

Construct with value and constancy.

Definition at line 112 of file predicateLibrary.h.

Member Function Documentation

◆ And()

static SdfPredicateFunctionResult And	(	SdfPredicateFunctionResult	lhs,
		SdfPredicateFunctionResult	rhs
	)

inlinestatic

Return the logical and of lhs and rhs with constancy propagation.

If either value is false and ConstantOverDescendants, the result is false and ConstantOverDescendants. If both values are true and ConstantOverDescendants the result is true and ConstantOverDescendants. Otherwise the result is the logical and of the truth values and MayVaryOverDescendants.

Definition at line 132 of file predicateLibrary.h.

◆ GetConstancy()

Constancy GetConstancy ( ) const

inline

Return the result constancy.

Definition at line 161 of file predicateLibrary.h.

◆ GetValue()

bool GetValue ( ) const

inline

Return the result value.

Definition at line 156 of file predicateLibrary.h.

◆ IsConstant()

bool IsConstant ( ) const

inline

Return true if this result's constancy is ConstantOverDescendants.

Definition at line 166 of file predicateLibrary.h.

◆ MakeConstant()

static SdfPredicateFunctionResult MakeConstant ( bool value )

inlinestatic

Create with value and 'ConstantOverDescendants'.

Definition at line 116 of file predicateLibrary.h.

◆ MakeVarying()

static SdfPredicateFunctionResult MakeVarying ( bool value )

inlinestatic

Create with value and 'MayVaryOverDescendants'.

Definition at line 121 of file predicateLibrary.h.

◆ operator UnspecifiedBoolType()

operator UnspecifiedBoolType ( ) const

inline

doxygen

Return GetValue().

Definition at line 175 of file predicateLibrary.h.

◆ operator!()

SdfPredicateFunctionResult operator! ( ) const

inline

Return a result with the opposite value but the same constancy.

Definition at line 180 of file predicateLibrary.h.

◆ Or()

static SdfPredicateFunctionResult Or	(	SdfPredicateFunctionResult	lhs,
		SdfPredicateFunctionResult	rhs
	)

inlinestatic

Return the logical or of lhs and rhs with constancy propagation.

If either value is true and ConstantOverDescendants, the result is true and ConstantOverDescendants. If both values are false and ConstantOverDescendants the result is false and ConstantOverDescendants. Otherwise the result is the logical or of the truth values and MayVaryOverDescendants.

Definition at line 147 of file predicateLibrary.h.

◆ SetAndPropagateConstancy()

void SetAndPropagateConstancy ( SdfPredicateFunctionResult other )

inline

Set this result's value to other's value, and propagate constancy; if both this and other are ConstantOverDescendants, this object's constancy remains ConstantOverDescendants.

Otherwise set this object's constancy to MayVaryOverDescendants.

Definition at line 188 of file predicateLibrary.h.

Friends And Related Function Documentation

◆ operator!= [1/3]

bool operator!=	(	bool	lhs,
		SdfPredicateFunctionResult	pfr
	)

friend

Definition at line 216 of file predicateLibrary.h.

◆ operator!= [2/3]

bool operator!=	(	SdfPredicateFunctionResult	lhs,
		SdfPredicateFunctionResult	rhs
	)

friend

Definition at line 202 of file predicateLibrary.h.

◆ operator!= [3/3]

bool operator!=	(	SdfPredicateFunctionResult	pfr,
		bool	rhs
	)

friend

Definition at line 213 of file predicateLibrary.h.

◆ operator== [1/3]

bool operator==	(	bool	lhs,
		SdfPredicateFunctionResult	pfr
	)

friend

Definition at line 210 of file predicateLibrary.h.

◆ operator== [2/3]

bool operator==	(	SdfPredicateFunctionResult	lhs,
		SdfPredicateFunctionResult	rhs
	)

friend

Definition at line 197 of file predicateLibrary.h.

◆ operator== [3/3]

bool operator==	(	SdfPredicateFunctionResult	pfr,
		bool	rhs
	)

friend

Definition at line 207 of file predicateLibrary.h.

The documentation for this class was generated from the following file:

pxr/usd/sdf/predicateLibrary.h

Public Types

Public Member Functions

Static Public Member Functions

Friends

Detailed Description

Member Enumeration Documentation

◆ Constancy

Constructor & Destructor Documentation

◆ SdfPredicateFunctionResult() [1/3]

◆ SdfPredicateFunctionResult() [2/3]

◆ SdfPredicateFunctionResult() [3/3]

Member Function Documentation

◆ And()

◆ GetConstancy()

◆ GetValue()

◆ IsConstant()

◆ MakeConstant()

◆ MakeVarying()

◆ operator UnspecifiedBoolType()

◆ operator!()

◆ Or()

◆ SetAndPropagateConstancy()

Friends And Related Function Documentation

◆ operator!= [1/3]

◆ operator!= [2/3]

◆ operator!= [3/3]

◆ operator== [1/3]

◆ operator== [2/3]

◆ operator== [3/3]