Interface Salient\Contract\Collection\CollectionInterface

`<TKey is array-key, TValue>`

`extends`	`ArrayAccess<TKey, TValue>, Arrayable<TKey, TValue\|mixed[]>, Countable, IteratorAggregate<TKey, TValue>, JsonSerializable, Jsonable`

Salient\Contract\Collection\CollectionInterface extends ArrayAccess<TKey, TValue>, Arrayable<TKey, TValue|mixed[]>, Countable, IteratorAggregate<TKey, TValue>, JsonSerializable, Jsonable
- Salient\Collection\ListCollection implements CollectionInterface<int, TValue> uses ListCollectionTrait
- Salient\Collection\Collection implements CollectionInterface<TKey, TValue> uses CollectionTrait
  - Salient\Sync\Support\SyncErrorCollection implements SyncErrorCollectionInterface
- Salient\Contract\Sync\SyncErrorCollectionInterface extends CollectionInterface<int, SyncErrorInterface>, Stringable
  - Salient\Sync\Support\SyncErrorCollection implements SyncErrorCollectionInterface
- Salient\Contract\Http\HttpHeadersInterface extends CollectionInterface<string, string[]>, Immutable, Stringable
  - Salient\Http\HttpHeaders implements HttpHeadersInterface uses ReadOnlyCollectionTrait, ReadOnlyArrayAccessTrait, ImmutableTrait

Located at Toolkit/Contract/Collection/CollectionInterface.php

Methods


					
	public

__construct(Arrayable<TKey, TValue>|iterable<TKey, TValue> $items = [])

Implemented by

Salient\Http\HttpHeaders::__construct()


					
	public

isEmpty(): bool

Check if the collection is empty


					
	public

set(TKey $key, TValue $value): static

Add or replace an item with a given key

Implemented by

Salient\Http\HttpHeaders::set()


					
	public

has(TKey $key): bool

Check if an item with a given key exists


					
	public

get(TKey $key): TValue

Get the item with the given key

Throws

OutOfRangeException

if there is no such item in the collection.


					
	public

unset(TKey $key): static

Remove an item with a given key

Implemented by

Salient\Http\HttpHeaders::unset()


					
	public

add(TValue $value): static

Add an item

Implemented by

Salient\Http\HttpHeaders::add()


					
	public

merge(Arrayable<TKey, TValue>|iterable<TKey, TValue> $items): static

Merge the collection with the given items

Implemented by

Salient\Http\HttpHeaders::merge()


					
	public

sort(): static

Sort items in the collection

Implemented by

Salient\Http\HttpHeaders::sort()


					
	public

reverse(): static

Reverse the order of items in the collection

Implemented by

Salient\Http\HttpHeaders::reverse()


					
	public

forEach<TMode is int-mask-of<CollectionInterface::*>>(
	(TMode is 3|11|19 ? callable(array{TKey, TValue}, array{TKey, TValue}|null $next, array{TKey, TValue}|null $prev): mixed : (TMode is 2|10|18 ? callable(TKey, TKey|null $next, TKey|null $prev): mixed : callable(TValue, TValue|null $next, TValue|null $prev): mixed)) $callback,
	TMode $mode = CollectionInterface::CALLBACK_USE_VALUE,
): $this

Pass each item in the collection to a callback

The callback's return values are discarded.


					
	public

map<TMode is int-mask-of<CollectionInterface::*>>(
	(TMode is 3|11|19 ? callable(array{TKey, TValue}, array{TKey, TValue}|null $next, array{TKey, TValue}|null $prev): TValue : (TMode is 2|10|18 ? callable(TKey, TKey|null $next, TKey|null $prev): TValue : callable(TValue, TValue|null $next, TValue|null $prev): TValue)) $callback,
	TMode $mode = CollectionInterface::CALLBACK_USE_VALUE,
): static

Pass each item in the collection to a callback and populate a new collection with its return values

Implemented by

Salient\Http\HttpHeaders::map()


					
	public

filter<TMode is int-mask-of<CollectionInterface::*>>(
	(TMode is 3|11|19 ? callable(array{TKey, TValue}, array{TKey, TValue}|null $next, array{TKey, TValue}|null $prev): bool : (TMode is 2|10|18 ? callable(TKey, TKey|null $next, TKey|null $prev): bool : callable(TValue, TValue|null $next, TValue|null $prev): bool)) $callback,
	TMode $mode = CollectionInterface::CALLBACK_USE_VALUE,
): static

Reduce the collection to items that satisfy a callback

Implemented by

Salient\Http\HttpHeaders::filter()


					
	public

find<TMode is int-mask-of<CollectionInterface::*>>(
	(TMode is 3|11|19 ? callable(array{TKey, TValue}, array{TKey, TValue}|null $next, array{TKey, TValue}|null $prev): bool : (TMode is 2|10|18 ? callable(TKey, TKey|null $next, TKey|null $prev): bool : callable(TValue, TValue|null $next, TValue|null $prev): bool)) $callback,
	TMode $mode = CollectionInterface::CALLBACK_USE_VALUE | CollectionInterface::FIND_VALUE,
): (TMode is 16|17|18|19 ? TKey : TValue)|null

Get the first item that satisfies a callback, or null if there is no such item in the collection


					
	public

only(TKey[] $keys): static

Reduce the collection to items with keys in an array

Implemented by

Salient\Http\HttpHeaders::only()


					
	public

onlyIn(array<TKey, true> $index): static

Reduce the collection to items with keys in an index

Implemented by

Salient\Http\HttpHeaders::onlyIn()


					
	public

except(TKey[] $keys): static

Reduce the collection to items with keys not in an array

Implemented by

Salient\Http\HttpHeaders::except()


					
	public

exceptIn(array<TKey, true> $index): static

Reduce the collection to items with keys not in an index

Implemented by

Salient\Http\HttpHeaders::exceptIn()


					
	public

slice(int $offset, ?int $length = null): static

Extract a slice of the collection

Implemented by

Salient\Http\HttpHeaders::slice()


					
	public

hasValue(TValue $value, bool $strict = false): bool

Check if a value is in the collection


					
	public

keyOf(TValue $value, bool $strict = false): TKey|null

Get the first key at which a value is found, or null if it's not in the collection


					
	public

firstOf(TValue $value): TValue|null

Get the first item equal but not necessarily identical to a value, or null if it's not in the collection


					
	public

all(): array<TKey, TValue>

Get all items in the collection


					
	public

first(): TValue|null

Get the first item, or null if the collection is empty


					
	public

last(): TValue|null

Get the last item, or null if the collection is empty


					
	public

nth(int $n): TValue|null

Get the nth item (1-based), or null if there is no such item in the collection

If $n is negative, the nth item from the end of the collection is returned.


					
	public

push(TValue ...$items): static

Push items onto the end of the collection

Implemented by

Salient\Http\HttpHeaders::push()


					
	public

pop(TValue|null &$last = null): static

Pop an item off the end of the collection

Parameters

$last

Receives the value removed from the collection, or null if the collection is empty.

Implemented by

Salient\Http\HttpHeaders::pop()


					
	public

shift(TValue|null &$first = null): static

Shift an item off the beginning of the collection

Parameters

$first

Receives the value removed from the collection, or null if the collection is empty.

Implemented by

Salient\Http\HttpHeaders::shift()


					
	public

unshift(TValue ...$items): static

Add items to the beginning of the collection

Items are added in one operation and stay in the given order.

Implemented by

Salient\Http\HttpHeaders::unshift()

Methods inherited from ArrayAccess
`offsetExists(), offsetGet(), offsetSet(), offsetUnset()`

Methods inherited from Salient\Contract\Core\Arrayable
`toArray()`

Methods inherited from Countable
`count()`

Methods inherited from IteratorAggregate
`getIterator()`

Methods inherited from JsonSerializable
`jsonSerialize()`

Methods inherited from Salient\Contract\Core\Jsonable
`toJson()`

Constants
`public`	`CALLBACK_USE_VALUE = 1` Pass the value of each item to the callback Pass the value of each item to the callback	#
`public`	`CALLBACK_USE_KEY = 2` Pass the key of each item to the callback Pass the key of each item to the callback	#
`public`	`CALLBACK_USE_BOTH = 3` Pass a key-value pair to the callback for each item Pass a key-value pair to the callback for each item	#
`public`	`FIND_VALUE = 8` Return the first item that satisfies the callback Return the first item that satisfies the callback	#
`public`	`FIND_KEY = 16` Return the key of the first item that satisfies the callback Return the key of the first item that satisfies the callback	#

Namespaces

Interfaces

Interface Salient\Contract\Collection\CollectionInterface

`<TKey is array-key, TValue>`

Implemented by

Implemented by

Throws

Implemented by

Implemented by

Implemented by

Implemented by

Implemented by

Implemented by

Implemented by

Implemented by

Implemented by

Implemented by

Implemented by

Implemented by

Implemented by

Parameters

Implemented by

Parameters

Implemented by

Implemented by