pike.ida.liu.se
Search for
Home > Docs > Pike reference

[Top]

get_iterator()


Method get_iterator

Iterator get_iterator(object|array|mapping|multiset|string data)

Description

Creates and returns a canonical iterator for data .

Returns
data can have any of the following types:
object

If data is an object with lfun::_get_iterator defined then it's called in it to create the iterator.

If data is an object that lacks lfun::_get_iterator then it's assumed to already be an iterator object, and is simply returned.

array

If data is an array, an Array.Iterator object will be returned.

mapping

If data is a mapping, a Mapping.Iterator object will be returned

multiset

If data is a multiset, a Multiset.Iterator object will be returned

string

If data is a string, a String.Iterator object will be returned


Note

This function is used by foreach to get an iterator for an object.

See also

Iterator , lfun::_get_iterator

Module reference for Pike v7.8 release 116, 2008-12-31