Map deprecated
class Map implements ArrayAccess, Countable, IteratorAggregate (View source)
deprecated
Creates a map from an SS_List by defining a key column and a value column.
Properties
| protected | $list | |||
| protected | $keyField | |||
| protected | $valueField | |||
| protected | array | $firstItems | ||
| protected | array | $lastItems |
Methods
Construct a new map around an SS_list.
Sets a value in the map by a given key that has been set via Map::push()} or {@link Map::unshift()
Removes a value in the map by a given key which has been added to the map via Map::push()} or {@link Map::unshift()
Returns an Map_Iterator instance for iterating over the complete set of items in the map.
Extracts a value from an item in the list, where the item is either an object or array.
Returns the count of items in the list including the additional items set through Map::push()} and {@link Map::unshift.
Details
__construct(SS_List $list, string $keyField = "ID", string $valueField = "Title")
Construct a new map around an SS_list.
setKeyField($keyField)
Set the key field for this map.
setValueField($valueField)
Set the value field for this map.
array
toArray()
Return an array equivalent to this map.
array
keys()
Return all the keys of this map.
array
values()
Return all the values of this map.
$this
unshift($key, $value)
Unshift an item onto the start of the map.
Stores the value in addition to the DataQuery for the map.
$this
push($key, $value)
Pushes an item onto the end of the map.
bool
offsetExists(mixed $key)
No description
mixed
offsetGet(mixed $key)
No description
void
offsetSet(mixed $key, mixed $value)
Sets a value in the map by a given key that has been set via Map::push()} or {@link Map::unshift()
Keys in the map cannot be set since these values are derived from a DataQuery} instance. In this case, use {@link Map::toArray() and manipulate the resulting array.
void
offsetUnset(mixed $key)
Removes a value in the map by a given key which has been added to the map via Map::push()} or {@link Map::unshift()
Keys in the map cannot be unset since these values are derived from a DataQuery} instance. In this case, use {@link Map::toArray() and manipulate the resulting array.
Traversable
getIterator()
Returns an Map_Iterator instance for iterating over the complete set of items in the map.
protected mixed
extractValue(array|object $item, string $key)
Extracts a value from an item in the list, where the item is either an object or array.
int
count()
Returns the count of items in the list including the additional items set through Map::push()} and {@link Map::unshift.