Represents a single list of list editing operations. More...

#include <listProxy.h>

Public Types
typedef _TypePolicy	TypePolicy

typedef SdfListProxy< TypePolicy >	This

typedef TypePolicy::value_type	value_type

typedef std::vector< value_type >	value_vector_type

typedef _ItemProxy	reference

typedef _Iterator< This *, _GetHelper >	iterator

typedef _Iterator< const This *, _ConstGetHelper >	const_iterator

typedef Tf_ProxyReferenceReverseIterator< iterator >	reverse_iterator

typedef Tf_ProxyReferenceReverseIterator< const_iterator >	const_reverse_iterator

Public Member Functions
	SdfListProxy (SdfListOpType op)
	Creates a default list proxy object for list operation vector specified `op`.

	SdfListProxy (const std::shared_ptr< Sdf_ListEditor< TypePolicy > > &editor, SdfListOpType op)
	Create a new proxy wrapping the list operation vector specified by `op` in the underlying `listEditor`.

iterator	begin ()
	Return an iterator to the start of the sequence.

iterator	end ()
	Return an iterator to the end of the sequence.

reverse_iterator	rbegin ()
	Return a reverse iterator to the last item of the sequence.

reverse_iterator	rend ()
	Return a reverse iterator past the start item of the sequence.

const_iterator	begin () const
	Return a const iterator to the start of the sequence.

const_iterator	end () const
	Return a const iterator to the end of the sequence.

const_reverse_iterator	rbegin () const
	Return a const reverse iterator to the last item of the sequence.

const_reverse_iterator	rend () const
	Return a const reverse iterator past the start item of the sequence.

size_t	size () const
	Return the size of the sequence.

bool	empty () const
	Return true if size() == 0.

reference	operator[] (size_t n)
	Return a `reference` to the item at index `n`.

value_type	operator[] (size_t n) const
	Return a copy of the item at index `n`.

reference	front ()
	Return a `reference` to the item at the front of the sequence.

reference	back ()
	Return a `reference` to the item at the back of the sequence.

value_type	front () const
	Return a copy of the item at the front of the sequence.

value_type	back () const
	Return a copy of the item at the back of the sequence.

void	push_back (const value_type &elem)
	Append `elem` to this sequence.

void	pop_back ()
	Remove the last element from this sequence.

iterator	insert (iterator pos, const value_type &x)
	Insert `x` into this sequence at position `pos`.

template<class InputIterator >
void	insert (iterator pos, InputIterator f, InputIterator l)
	Insert copies of the elements in [`f`, `l`) into this sequence starting at position `pos`.

void	erase (iterator pos)
	Erase the element at `pos`.

void	erase (iterator f, iterator l)
	Erase all the elements in the range [`f`, `l`).

void	clear ()
	Clear the contents of the sequence.

void	resize (size_t n, const value_type &t=value_type())
	Resize the contents of the sequence.

	operator value_vector_type () const
	Produce a copy of the contents of this sequence into a vector.

template<class T2 >
This &	operator= (const SdfListProxy< T2 > &other)
	Replace all elements in this sequence with the elements in the `other` sequence.

This &	operator= (const value_vector_type &other)
	Replace all elements in this sequence with the given vector.

template<class Y >
This &	operator= (const std::vector< Y > &v)
	Replace all elements in this sequence with the given vector.

template<class T2 >
bool	operator== (const SdfListProxy< T2 > &y) const
	Equality comparison.

template<class T2 >
bool	operator!= (const SdfListProxy< T2 > &y) const
	Inequality comparison.

template<class T2 >
bool	operator< (const SdfListProxy< T2 > &y) const
	Less-than comparison.

template<class T2 >
bool	operator<= (const SdfListProxy< T2 > &y) const
	Less-than-or-equal comparison.

template<class T2 >
bool	operator> (const SdfListProxy< T2 > &y) const
	Greater-than comparison.

template<class T2 >
bool	operator>= (const SdfListProxy< T2 > &y) const
	Greater-than-or-equal comparison.

bool	operator== (const value_vector_type &y) const
	Equality comparison.

bool	operator!= (const value_vector_type &y) const
	Inequality comparison.

bool	operator< (const value_vector_type &y) const
	Less-than comparison.

bool	operator> (const value_vector_type &y) const
	Greater-than comparison.

bool	operator<= (const value_vector_type &y) const
	Less-than or equal to comparison.

bool	operator>= (const value_vector_type &y) const
	Greater-than or equal to comparison.

	operator bool () const
	Explicit bool conversion operator.

SdfLayerHandle	GetLayer () const
	Returns the layer that this list editor belongs to.

SdfPath	GetPath () const
	Returns the path to this list editor's value.

bool	IsExpired () const
	Returns true if the list editor is expired.

size_t	Count (const value_type &value) const

size_t	Find (const value_type &value) const

void	Insert (int index, const value_type &value)

void	Remove (const value_type &value)

void	Replace (const value_type &oldValue, const value_type &newValue)

void	Erase (size_t index)

void	ApplyList (const SdfListProxy &list)
	Applies the edits in the given list to this one.

void	ApplyEditsToList (value_vector_type *vec)
	Apply the edits in this list to the given `vec`.

template<class CB >
void	ModifyItemEdits (CB callback)
	Modify all edits in this list.

Friends
class	_ItemProxy

class	_GetHelper

class	_ConstGetHelper

template<class >
class	SdfPyWrapListProxy

bool	operator== (const value_vector_type &x, const SdfListProxy &y)
	Equality comparision.

bool	operator!= (const value_vector_type &x, const SdfListProxy &y)
	Inequality comparision.

bool	operator< (const value_vector_type &x, const SdfListProxy &y)
	Less-than comparison.

bool	operator> (const value_vector_type &x, const SdfListProxy &y)
	Greater-than comparison.

bool	operator<= (const value_vector_type &x, const SdfListProxy &y)
	Less-than or equal to comparison.

bool	operator>= (const value_vector_type &x, const SdfListProxy &y)
	Greater-than or equal to comparison.

Detailed Description

template<class _TypePolicy>
class SdfListProxy< _TypePolicy >

Represents a single list of list editing operations.

An SdfListProxy represents a single list of list editing operations, making it look like an STL vector (modeling a random access container and back insertion sequence).

Definition at line 54 of file listProxy.h.

Member Typedef Documentation

◆ const_iterator

typedef _Iterator<const This*, _ConstGetHelper> const_iterator

Definition at line 299 of file listProxy.h.

◆ const_reverse_iterator

typedef Tf_ProxyReferenceReverseIterator<const_iterator> const_reverse_iterator

Definition at line 301 of file listProxy.h.

◆ iterator

typedef _Iterator<This*, _GetHelper> iterator

Definition at line 298 of file listProxy.h.

◆ reference

typedef _ItemProxy reference

Definition at line 297 of file listProxy.h.

◆ reverse_iterator

typedef Tf_ProxyReferenceReverseIterator<iterator> reverse_iterator

Definition at line 300 of file listProxy.h.

◆ This

typedef SdfListProxy<TypePolicy> This

Definition at line 57 of file listProxy.h.

◆ TypePolicy

typedef _TypePolicy TypePolicy

Definition at line 56 of file listProxy.h.

◆ value_type

typedef TypePolicy::value_type value_type

Definition at line 58 of file listProxy.h.

◆ value_vector_type

typedef std::vector<value_type> value_vector_type

Definition at line 59 of file listProxy.h.

Constructor & Destructor Documentation

◆ SdfListProxy() [1/2]

SdfListProxy ( SdfListOpType op )

inline

Creates a default list proxy object for list operation vector specified op.

This object evaluates to false in a boolean context and all operations on this object have no effect.

Definition at line 306 of file listProxy.h.

◆ SdfListProxy() [2/2]

SdfListProxy	(	const std::shared_ptr< Sdf_ListEditor< TypePolicy > > &	editor,
		SdfListOpType	op
	)

inline

Create a new proxy wrapping the list operation vector specified by op in the underlying listEditor.

Definition at line 313 of file listProxy.h.

Member Function Documentation

◆ ApplyEditsToList()

void ApplyEditsToList ( value_vector_type * vec )

inline

Apply the edits in this list to the given vec.

Definition at line 656 of file listProxy.h.

◆ ApplyList()

void ApplyList ( const SdfListProxy< _TypePolicy > & list )

inline

Applies the edits in the given list to this one.

Definition at line 648 of file listProxy.h.

◆ back() [1/2]

reference back ( )

inline

Return a reference to the item at the back of the sequence.

Definition at line 383 of file listProxy.h.

◆ back() [2/2]

value_type back ( ) const

inline

Return a copy of the item at the back of the sequence.

Definition at line 393 of file listProxy.h.

◆ begin() [1/2]

iterator begin ( )

inline

Return an iterator to the start of the sequence.

Definition at line 321 of file listProxy.h.

◆ begin() [2/2]

const_iterator begin ( ) const

inline

Return a const iterator to the start of the sequence.

Definition at line 339 of file listProxy.h.

◆ clear()

void clear ( )

inline

Clear the contents of the sequence.

Definition at line 431 of file listProxy.h.

◆ Count()

size_t Count ( const value_type & value ) const

inline

Definition at line 598 of file listProxy.h.

◆ empty()

bool empty ( ) const

inline

Return true if size() == 0.

Definition at line 363 of file listProxy.h.

◆ end() [1/2]

iterator end ( )

inline

Return an iterator to the end of the sequence.

Definition at line 325 of file listProxy.h.

◆ end() [2/2]

const_iterator end ( ) const

inline

Return a const iterator to the end of the sequence.

Definition at line 343 of file listProxy.h.

◆ erase() [1/2]

void erase	(	iterator	f,
		iterator	l
	)

inline

Erase all the elements in the range [f, l).

Definition at line 426 of file listProxy.h.

◆ erase() [2/2]

void erase ( iterator pos )

inline

Erase the element at pos.

Definition at line 421 of file listProxy.h.

◆ Erase()

void Erase ( size_t index )

inline

Definition at line 642 of file listProxy.h.

◆ Find()

size_t Find ( const value_type & value ) const

inline

Definition at line 603 of file listProxy.h.

◆ front() [1/2]

reference front ( )

inline

Return a reference to the item at the front of the sequence.

Definition at line 378 of file listProxy.h.

◆ front() [2/2]

value_type front ( ) const

inline

Return a copy of the item at the front of the sequence.

Definition at line 388 of file listProxy.h.

◆ GetLayer()

SdfLayerHandle GetLayer ( ) const

inline

Returns the layer that this list editor belongs to.

Definition at line 581 of file listProxy.h.

◆ GetPath()

SdfPath GetPath ( ) const

inline

Returns the path to this list editor's value.

Definition at line 587 of file listProxy.h.

◆ Insert()

void Insert	(	int	index,
		const value_type &	value
	)

inline

Definition at line 608 of file listProxy.h.

◆ insert() [1/2]

iterator insert	(	iterator	pos,
		const value_type &	x
	)

inline

Insert x into this sequence at position pos.

Definition at line 408 of file listProxy.h.

◆ insert() [2/2]

void insert	(	iterator	pos,
		InputIterator	f,
		InputIterator	l
	)

inline

Insert copies of the elements in [f, l) into this sequence starting at position pos.

Definition at line 416 of file listProxy.h.

◆ IsExpired()

bool IsExpired ( ) const

inline

Returns true if the list editor is expired.

Definition at line 593 of file listProxy.h.

◆ ModifyItemEdits()

void ModifyItemEdits ( CB callback )

inline

Modify all edits in this list.

callback must be a callable that accepts an argument of type value_type and returns a boost::optional<value_type>.

callback is called with every item in the list. If an invalid boost::optional is returned, the item is removed. Otherwise it's replaced with the returned item. If a returned item matches an item that was previously returned, the returned item will be removed.

Definition at line 674 of file listProxy.h.

◆ operator bool()

operator bool ( ) const

inlineexplicit

Explicit bool conversion operator.

The list proxy object converts to true if the list editor is valid, false otherwise.

Definition at line 573 of file listProxy.h.

◆ operator value_vector_type()

operator value_vector_type ( ) const

inline

Produce a copy of the contents of this sequence into a vector.

Definition at line 450 of file listProxy.h.

◆ operator!=() [1/2]

bool operator!= ( const SdfListProxy< T2 > & y ) const

inline

Inequality comparison.

Definition at line 483 of file listProxy.h.

◆ operator!=() [2/2]

bool operator!= ( const value_vector_type & y ) const

inline

Inequality comparison.

Definition at line 522 of file listProxy.h.

◆ operator<() [1/2]

bool operator< ( const SdfListProxy< T2 > & y ) const

inline

Less-than comparison.

Definition at line 489 of file listProxy.h.

◆ operator<() [2/2]

bool operator< ( const value_vector_type & y ) const

inline

Less-than comparison.

Definition at line 532 of file listProxy.h.

◆ operator<=() [1/2]

bool operator<= ( const SdfListProxy< T2 > & y ) const

inline

Less-than-or-equal comparison.

Definition at line 495 of file listProxy.h.

◆ operator<=() [2/2]

bool operator<= ( const value_vector_type & y ) const

inline

Less-than or equal to comparison.

Definition at line 552 of file listProxy.h.

◆ operator=() [1/3]

This & operator= ( const SdfListProxy< T2 > & other )

inline

Replace all elements in this sequence with the elements in the other sequence.

Definition at line 457 of file listProxy.h.

◆ operator=() [2/3]

This & operator= ( const std::vector< Y > & v )

inline

Replace all elements in this sequence with the given vector.

Definition at line 470 of file listProxy.h.

◆ operator=() [3/3]

This & operator= ( const value_vector_type & other )

inline

Replace all elements in this sequence with the given vector.

Definition at line 463 of file listProxy.h.

◆ operator==() [1/2]

bool operator== ( const SdfListProxy< T2 > & y ) const

inline

Equality comparison.

Definition at line 477 of file listProxy.h.

◆ operator==() [2/2]

bool operator== ( const value_vector_type & y ) const

inline

Equality comparison.

Definition at line 512 of file listProxy.h.

◆ operator>() [1/2]

bool operator> ( const SdfListProxy< T2 > & y ) const

inline

Greater-than comparison.

Definition at line 501 of file listProxy.h.

◆ operator>() [2/2]

bool operator> ( const value_vector_type & y ) const

inline

Greater-than comparison.

Definition at line 542 of file listProxy.h.

◆ operator>=() [1/2]

bool operator>= ( const SdfListProxy< T2 > & y ) const

inline

Greater-than-or-equal comparison.

Definition at line 507 of file listProxy.h.

◆ operator>=() [2/2]

bool operator>= ( const value_vector_type & y ) const

inline

Greater-than or equal to comparison.

Definition at line 562 of file listProxy.h.

◆ operator[]() [1/2]

reference operator[] ( size_t n )

inline

Return a reference to the item at index n.

Definition at line 368 of file listProxy.h.

◆ operator[]() [2/2]

value_type operator[] ( size_t n ) const

inline

Return a copy of the item at index n.

Definition at line 373 of file listProxy.h.

◆ pop_back()

void pop_back ( )

inline

Remove the last element from this sequence.

Definition at line 403 of file listProxy.h.

◆ push_back()

void push_back ( const value_type & elem )

inline

Append elem to this sequence.

Definition at line 398 of file listProxy.h.

◆ rbegin() [1/2]

reverse_iterator rbegin ( )

inline

Return a reverse iterator to the last item of the sequence.

Definition at line 330 of file listProxy.h.

◆ rbegin() [2/2]

const_reverse_iterator rbegin ( ) const

inline

Return a const reverse iterator to the last item of the sequence.

Definition at line 348 of file listProxy.h.

◆ Remove()

void Remove ( const value_type & value )

inline

Definition at line 616 of file listProxy.h.

◆ rend() [1/2]

reverse_iterator rend ( )

inline

Return a reverse iterator past the start item of the sequence.

Definition at line 334 of file listProxy.h.

◆ rend() [2/2]

const_reverse_iterator rend ( ) const

inline

Return a const reverse iterator past the start item of the sequence.

Definition at line 353 of file listProxy.h.

◆ Replace()

void Replace	(	const value_type &	oldValue,
		const value_type &	newValue
	)

inline

Definition at line 629 of file listProxy.h.

◆ resize()

void resize	(	size_t	n,
		const value_type &	t = `value_type()`
	)

inline

Resize the contents of the sequence.

Inserts or erases copies of t at the end such that the size becomes n.

Definition at line 439 of file listProxy.h.

◆ size()

size_t size ( ) const

inline

Return the size of the sequence.

Definition at line 358 of file listProxy.h.

Friends And Related Function Documentation

◆ _ConstGetHelper

friend class _ConstGetHelper

friend

Definition at line 134 of file listProxy.h.

◆ _GetHelper

friend class _GetHelper

friend

Definition at line 133 of file listProxy.h.

◆ _ItemProxy

friend class _ItemProxy

friend

Definition at line 115 of file listProxy.h.

◆ operator!=

bool operator!=	(	const value_vector_type &	x,
		const SdfListProxy< _TypePolicy > &	y
	)

friend

Inequality comparision.

Definition at line 527 of file listProxy.h.

◆ operator<

bool operator<	(	const value_vector_type &	x,
		const SdfListProxy< _TypePolicy > &	y
	)

friend

Less-than comparison.

Definition at line 537 of file listProxy.h.

◆ operator<=

bool operator<=	(	const value_vector_type &	x,
		const SdfListProxy< _TypePolicy > &	y
	)

friend

Less-than or equal to comparison.

Definition at line 557 of file listProxy.h.

◆ operator==

bool operator==	(	const value_vector_type &	x,
		const SdfListProxy< _TypePolicy > &	y
	)

friend

Equality comparision.

Definition at line 517 of file listProxy.h.

◆ operator>

bool operator>	(	const value_vector_type &	x,
		const SdfListProxy< _TypePolicy > &	y
	)

friend

Greater-than comparison.

Definition at line 547 of file listProxy.h.

◆ operator>=

bool operator>=	(	const value_vector_type &	x,
		const SdfListProxy< _TypePolicy > &	y
	)

friend

Greater-than or equal to comparison.

Definition at line 567 of file listProxy.h.

◆ SdfPyWrapListProxy

friend class SdfPyWrapListProxy

friend

Definition at line 767 of file listProxy.h.

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

pxr/usd/sdf/listProxy.h

Public Types

Public Member Functions

Friends

Detailed Description

Member Typedef Documentation

◆ const_iterator

◆ const_reverse_iterator

◆ iterator

◆ reference

◆ reverse_iterator

◆ This

◆ TypePolicy

◆ value_type

◆ value_vector_type

Constructor & Destructor Documentation

◆ SdfListProxy() [1/2]

◆ SdfListProxy() [2/2]

Member Function Documentation

◆ ApplyEditsToList()

◆ ApplyList()

◆ back() [1/2]

◆ back() [2/2]

◆ begin() [1/2]

◆ begin() [2/2]

◆ clear()

◆ Count()

◆ empty()

◆ end() [1/2]

◆ end() [2/2]

◆ erase() [1/2]

◆ erase() [2/2]

◆ Erase()

◆ Find()

◆ front() [1/2]

◆ front() [2/2]

◆ GetLayer()

◆ GetPath()

◆ Insert()

◆ insert() [1/2]

◆ insert() [2/2]

◆ IsExpired()

◆ ModifyItemEdits()

◆ operator bool()

◆ operator value_vector_type()

◆ operator!=() [1/2]

◆ operator!=() [2/2]

◆ operator<() [1/2]

◆ operator<() [2/2]

◆ operator<=() [1/2]

◆ operator<=() [2/2]

◆ operator=() [1/3]

◆ operator=() [2/3]

◆ operator=() [3/3]

◆ operator==() [1/2]

◆ operator==() [2/2]

◆ operator>() [1/2]

◆ operator>() [2/2]

◆ operator>=() [1/2]

◆ operator>=() [2/2]

◆ operator[]() [1/2]

◆ operator[]() [2/2]

◆ pop_back()

◆ push_back()

◆ rbegin() [1/2]

◆ rbegin() [2/2]

◆ Remove()

◆ rend() [1/2]

◆ rend() [2/2]

◆ Replace()

◆ resize()

◆ size()

Friends And Related Function Documentation

◆ _ConstGetHelper

◆ _GetHelper

◆ _ItemProxy

◆ operator!=

◆ operator<

◆ operator<=

◆ operator==

◆ operator>