1. class
  2. Ramsey
  3. \
  4. Collection
  5. \
  6. Map
  7. \
  8. AbstractMap

AbstractMap

abstract class AbstractMap extends AbstractArray implements MapInterface (View source)

This class provides a basic implementation of MapInterface, to minimize the effort required to implement this interface.

Properties

protected array $data The items of this array. from AbstractArray

Methods

__construct(array $data = [])

Constructs a new array object.

from AbstractArray
Traversable
getIterator()

Returns an iterator for this array.

from AbstractArray
bool
offsetExists(mixed $offset)

Returns true if the given offset exists in this array.

from AbstractArray
mixed|null
offsetGet(mixed $offset)

Returns the value at the specified offset.

from AbstractArray
void
offsetSet(mixed|null $offset, mixed $value)

Sets the given value to the given offset in the map.

void
offsetUnset(mixed $offset)

Removes the given offset and its value from the array.

from AbstractArray
string
serialize()

Returns a serialized string representation of this array object.

from AbstractArray
void
unserialize(string $serialized)

Converts a serialized string representation into an instance object.

from AbstractArray
int
count()

Returns the number of items in this array.

from AbstractArray
void
clear()

Removes all items from this array.

from AbstractArray
array
toArray()

Returns a native PHP array representation of this array object.

from AbstractArray
bool
isEmpty()

Returns true if this array is empty.

from AbstractArray
bool
containsKey(mixed $key)

Returns true if this map contains a mapping for the specified key.

bool
containsValue(mixed $value)

Returns true if this map maps one or more keys to the specified value.

array
keys()

Return an array of the keys contained in this map.

mixed|null
get(mixed $key, mixed $defaultValue = null)

Returns the value to which the specified key is mapped, null if this map contains no mapping for the key, or (optionally) $defaultValue if this map contains no mapping for the key.

mixed|null
put(mixed $key, mixed $value)

Associates the specified value with the specified key in this map.

mixed|null
putIfAbsent(mixed $key, mixed $value)

Associates the specified value with the specified key in this map only if it is not already set.

mixed|null
remove(mixed $key)

Removes the mapping for a key from this map if it is present.

bool
removeIf(mixed $key, mixed $value)

Removes the entry for the specified key only if it is currently mapped to the specified value.

mixed|null
replace(mixed $key, mixed $value)

Replaces the entry for the specified key only if it is currently mapped to some value.

bool
replaceIf(mixed $key, mixed $oldValue, mixed $newValue)

Replaces the entry for the specified key only if currently mapped to the specified value.

Details

in AbstractArray at line 35
__construct(array $data = [])

Constructs a new array object.

Parameters

array $data The initial items to add to this array.

in AbstractArray at line 51
Traversable getIterator()

Returns an iterator for this array.

Return Value

Traversable

in AbstractArray at line 65
bool offsetExists(mixed $offset)

Returns true if the given offset exists in this array.

Parameters

mixed $offset The offset to check.

Return Value

bool

in AbstractArray at line 80
mixed|null offsetGet(mixed $offset)

Returns the value at the specified offset.

Parameters

mixed $offset The offset for which a value should be returned.

Return Value

mixed|null the value stored at the offset, or null if the offset does not exist.

at line 34
void offsetSet(mixed|null $offset, mixed $value)

Sets the given value to the given offset in the map.

Parameters

mixed|null $offset The offset to set. If null, the value may be set at a numerically-indexed offset.
mixed $value The value to set at the given offset.

Return Value

void

Exceptions

InvalidArgumentException if the offset provided is null.

in AbstractArray at line 110
void offsetUnset(mixed $offset)

Removes the given offset and its value from the array.

Parameters

mixed $offset The offset to remove from the array.

Return Value

void

in AbstractArray at line 122
string serialize()

Returns a serialized string representation of this array object.

Return Value

string a PHP serialized string.

in AbstractArray at line 134
void unserialize(string $serialized)

Converts a serialized string representation into an instance object.

Parameters

string $serialized A PHP serialized string to unserialize.

Return Value

void

in AbstractArray at line 146
int count()

Returns the number of items in this array.

Return Value

int

in AbstractArray at line 154
void clear()

Removes all items from this array.

Return Value

void

in AbstractArray at line 164
array toArray()

Returns a native PHP array representation of this array object.

Return Value

array

in AbstractArray at line 174
bool isEmpty()

Returns true if this array is empty.

Return Value

bool

at line 53
bool containsKey(mixed $key)

Returns true if this map contains a mapping for the specified key.

Parameters

mixed $key The key to check in the map.

Return Value

bool

at line 67
bool containsValue(mixed $value)

Returns true if this map maps one or more keys to the specified value.

This performs a strict type check on the value.

Parameters

mixed $value The value to check in the map.

Return Value

bool

at line 77
array keys()

Return an array of the keys contained in this map.

Return Value

array

at line 92
mixed|null get(mixed $key, mixed $defaultValue = null)

Returns the value to which the specified key is mapped, null if this map contains no mapping for the key, or (optionally) $defaultValue if this map contains no mapping for the key.

Parameters

mixed $key The key to return from the map.
mixed $defaultValue The default value to use if $key is not found.

Return Value

mixed|null the value or null if the key could not be found.

at line 113
mixed|null put(mixed $key, mixed $value)

Associates the specified value with the specified key in this map.

If the map previously contained a mapping for the key, the old value is replaced by the specified value.

Parameters

mixed $key The key to put or replace in the map.
mixed $value The value to store at $key.

Return Value

mixed|null the previous value associated with key, or null if there was no mapping for $key.

at line 134
mixed|null putIfAbsent(mixed $key, mixed $value)

Associates the specified value with the specified key in this map only if it is not already set.

If there is already a value associated with $key, this returns that value without replacing it.

Parameters

mixed $key The key to put in the map.
mixed $value The value to store at $key.

Return Value

mixed|null the previous value associated with key, or null if there was no mapping for $key.

at line 153
mixed|null remove(mixed $key)

Removes the mapping for a key from this map if it is present.

Parameters

mixed $key The key to remove from the map.

Return Value

mixed|null the previous value associated with key, or null if there was no mapping for $key.

at line 172
bool removeIf(mixed $key, mixed $value)

Removes the entry for the specified key only if it is currently mapped to the specified value.

This performs a strict type check on the value.

Parameters

mixed $key The key to remove from the map.
mixed $value The value to match.

Return Value

bool true if the value was removed.

at line 193
mixed|null replace(mixed $key, mixed $value)

Replaces the entry for the specified key only if it is currently mapped to some value.

Parameters

mixed $key The key to replace.
mixed $value The value to set at $key.

Return Value

mixed|null the previous value associated with key, or null if there was no mapping for $key.

at line 216
bool replaceIf(mixed $key, mixed $oldValue, mixed $newValue)

Replaces the entry for the specified key only if currently mapped to the specified value.

This performs a strict type check on the value.

Parameters

mixed $key The key to remove from the map.
mixed $oldValue The value to match.
mixed $newValue The value to use as a replacement.

Return Value

bool true if the value was replaced.