Triple<T1, T2, T3>

Navigation: Up, Table of Contents, Bibliography, Index, Title Page

CGAL::Triple<T1, T2, T3>

Definition

The Triple class is an extension of std::pair. Triple<T1, T2, T3> is a heterogeneous triple: it holds one object of type T1, one of type T2, and one of type T3. A Triple<T1, T2, T3> is much like a container, in that it "owns" its elements. It is not actually a model of container, though, because it does not support the standard methods (such as iterators) for accessing the elements of a container.

#include <CGAL/utility.h>

Requirements

T1, T2 and T3 must be assignable. Additional operations have additional requirements.

Types

typedef T1	first_type;
typedef T2	second_type;
typedef T3	third_type;

Variables

T1	first;	first element
T2	second;	second element
T3	third;	third element

Creation

Triple<T1, T2, T3> t;
introduces a triple using the default constructor of the three elements.

Triple<T1, T2, T3> t ( T1 x, T2 y, T3 z);
constructs a triple such that first is constructed from x, second is constructed from y, and third is constructed from z.

template <class U, class V, class W>

Triple<T1, T2, T3> t ( U u, V v, W w);
constructs a triple such that first is constructed from u, second is constructed from v, and third is constructed from w.
Requirement: Proper conversion operators exist from U to T1, V to T2, and W to T3.

template <class T1, class T2, class T3>

bool x < y The comparison operator. It uses lexicographic comparison: the return value is true if the first element of x is less than the first element of y, and false if the first element of y is less than the first element of x. If neither of these is the case, then it returns true if the second element of x is less than the second element of y, and false if the second element of y is less than the second element of x. If neither of these is the case, then it returns the result of comparing the third elements of x and y. This operator may only be used if T1, T2 and T3 define the comparison operator.

template <class T1, class T2, class T3>

bool x == y The equality operator. The return value is true if and only the first elements of x and y are equal, the second elements of x and y are equal, and the third elements of x and y are equal. This operator may only be used if T1, T2 and T3 define the equality operator.

template <class T1, class T2, class T3>

Triple<T1, T2, T3> make_triple ( T1 x, T2 y, T3 z)
Equivalent to Triple<T1, T2, T3>(x, y, z).

Next: Quadruple<T1, T2, T3, T4>

Navigation: Table of Contents, Bibliography, Index, Title Page

The CGAL Project . Tue, December 21, 2004 .

Triple<T1, T2, T3> t;
	introduces a triple using the default constructor of the three elements.

Triple<T1, T2, T3> t ( T1 x, T2 y, T3 z);
	constructs a triple such that first is constructed from x, second is constructed from y, and third is constructed from z.

template <class U, class V, class W>
Triple<T1, T2, T3> t ( U u, V v, W w);
	constructs a triple such that first is constructed from u, second is constructed from v, and third is constructed from w. Requirement: Proper conversion operators exist from U to T1, V to T2, and W to T3.

template <class T1, class T2, class T3>
bool	x < y	The comparison operator. It uses lexicographic comparison: the return value is true if the first element of x is less than the first element of y, and false if the first element of y is less than the first element of x. If neither of these is the case, then it returns true if the second element of x is less than the second element of y, and false if the second element of y is less than the second element of x. If neither of these is the case, then it returns the result of comparing the third elements of x and y. This operator may only be used if T1, T2 and T3 define the comparison operator.

template <class T1, class T2, class T3>
bool	x == y	The equality operator. The return value is true if and only the first elements of x and y are equal, the second elements of x and y are equal, and the third elements of x and y are equal. This operator may only be used if T1, T2 and T3 define the equality operator.

template <class T1, class T2, class T3>
Triple<T1, T2, T3>	make_triple ( T1 x, T2 y, T3 z)
		Equivalent to Triple<T1, T2, T3>(x, y, z).