就业培训     下载中心     Wiki     联络 登录   注册

---

The foreach iterators returned by Iterable functions support range-based for loops:

另请参阅

$ref foreach

Member Typedef Documentation

◆  ValueType

成员函数文档编制

◆  Get() [1/3]

Constructs an AutoIterator from a C++ array.

参数

[in]

array

The array to iterate over.

Template Parameters

T	Type of the array elements.
N	Size of array.

返回

AutoIterator over array .

◆  Get() [2/3]

Constructs an AutoIterator from an iterable collection. An iterable collection has Begin() and End() functions returning suitable iterators to iterate over the collection. The returned AutoIterator will iterate over all values from Begin() to End().

参数

[in]

iterable

The collection to iterate over.

Template Parameters

I	Type of the collection.

返回

AutoIterator over iterable .

◆  Get() [3/3]

Returns the passed parameter. This overload of the other Get function is useful to get a foreach iterator from an object which may be either a foreach iterator itself, or an iterable collection for which an AutoIterator can be created, by just writing

若 object is already a foreach iterator, it will just be moved to it , otherwise it will be an AutoIterator for object .

参数

[in]

iterator

The iterator object to iterate over.

Template Parameters

I	Type of the iterator.

返回

iterable .

◆  Reverse()

This function can be used in a range-based for loop to reverse the iteration such that it starts at the last element of the #iterable and moves towards the first element. The function can only be used for iterables which have suitable – operator.

注意

It does the decrement in operator*, so a use outside of range-based for loops is risky because you might use operator* more than once. for ( const X& value : Iterable::Reverse (xarray)) { }

参数

[in]

iterable

The iterable to iterate over in reverse direction.

返回

Temporary object to be used in a range-based for loop.

◆  EraseIterator()

This function returns a for-each iterator over the given collection c which allows you to remove the current iteration value from within a ranged-based for loop.

The iterator provides an Erase function which allows to erase the current iteration value from the underlying collection. After erasure, the current element must not be accessed any longer. But it is allowed to advance the iterator using ++, then it will point to the element behind the erased one.

参数

[in,out]

c

The collection to iterate over.

返回

Foreach iterator over c which allows to safely erase the current element from within a for loop.

另请参阅

SwapEraseIterator

◆  SwapEraseIterator()

This function returns a for-each iterator over the given collection c which allows you to remove the current iteration value from within a ranged-based for loop.

The iterator provides an Erase function which allows to erase the current iteration value from the underlying collection by the collections's SwapErase function. This will generally be more efficient than the normal Erase, but it changes the order of the collection starting at the current position. After erasure, the current element must not be accessed any longer. But it is allowed to advance the iterator using ++, then it will point to the element behind the erased one.

参数

[in,out]

c

The collection to iterate over.

返回

Foreach iterator over c which allows to safely erase the current element from within a for loop.

另请参阅

EraseIterator

◆  IndexIterator()

Returns a foreach iterator which iterates over the given iterator and also maintains an index. The index starts with 0 and is automatically incremented for each iteration step, it can be obtained from the iterator using its GetIndex() function. Example:

参数

[in]

it

The iterator, may be any iterable object.

Template Parameters

I	Type of the iterator.

返回

Foreach iterator iterating over it .

◆  GetSingleton()

Constructs a singleton foreach iterator. The iterator will iterate a single time over the given value.

参数

[in]

value

The single value to iterate over.

Template Parameters

T	Type of the value.

返回

Foreach iterator iterating a single time over the single value.

◆  Concat()

Concatenates two foreach iterators. The returned iterator will iterate at first over the first iterator, then over the second one. This example will iterate over array at first, then over the single value x:

The result type of the returned iterator will be the common type of the value types of the two input iterators if you don't specify the T parameter. If such a common type doesn't exist, you have to specify the T 参数。

参数

[in]	it1	The first iterator, may be any iterable object.
[in]	it2	The second iterator, may be any iterable object.

Template Parameters

T	The value type of the result iterator.
I1	Type of the first iterator.
I2	Type of the second iterator.

返回

Foreach iterator iterating over first , then over second .

◆  Conditional()

Returns a foreach iterator which iterates over either first or second , depending on select 。若 select is true , the iterator will iterate over all values of first ( second won't be used at all), and vice versa if select is false . Example:

The result type of the returned iterator will be the common type of the value types of the two input iterators if you don't specify the T parameter. If such a common type doesn't exist, you have to specify the T 参数。

参数

[in]	select	若 true , iterate over first , otherwise over second .
[in]	it1	The first iterator, may be any iterable object.
[in]	it2	The second iterator, may be any iterable object.

Template Parameters

T	The value type of the result iterator.
I1	Type of the first iterator.
I2	Type of the second iterator.

返回

Conditional foreach iterator iterating over first if select is true , over second otherwise.

◆  Map()

Returns a foreach iterator which maps each of the values of the underlying iterator values by the given function fn . I.e., if the original values are v1, v2, ..., the returned iterator will yield the values fn(v1), fn(v2), ...

For example, to compute the sum of the squared values of an array using GetSum, you write

参数

[in]	values	The values to iterate over, may be any iterable object.
[in]	fn	The function which maps each original value to the target value of the returned iterator.

Template Parameters

I	Type of the values.
MAP	Type of the mapping function.

返回

Foreach iterator iterating over values , mapped by fn .

◆  Filter()

Returns a foreach iterator which iterates only over those values which pass the given filter . A value x passes the filter unless !filter(x) is true .

参数

[in]	values	The values to iterate over, may be any iterable object.
[in]	filter	The filter function. If !filter(x) is true , x will be removed from the iteration.

Template Parameters

I	Type of the values.
FILTER	Type of the filter function.

返回

Foreach iterator iterating over values , but removing those which don't pass filter .

◆  Zip()

Returns a foreach iterator which iterates over two iterators in lockstep. For each iteration step, the zip iterator has a pair as its value with the first value of the pair coming from it1 and the second value from it2 . The iteration ends as soon as one of the two iterators reaches its end.

参数

[in]	it1	The first iterator, may be any iterable object.
[in]	it2	The second iterator, may be any iterable object.

Template Parameters

I1	Type of the first iterator.
I2	Type of the second iterator.

返回

Foreach iterator iterating over pairs of values from it1 and it2 in a lockstep fashion.

◆  Any() [1/2]

◆  Any() [2/2]

◆  All() [1/2]

◆  All() [2/2]

• maxon
• Iterable