ConstMap

:::info[Note] This is a point-in-time snapshot of the API documentation from January 2026. Going forward, we will not be maintaining a public copy of these references, and recommend users to refer to the built-in signature helpers available in the Hack LSP instead for complete and up-to-date information. :::

Represents a read-only (immutable) sequence of key/value pairs, (i.e. a map)

Guides

• Introduction
• Interfaces

Interface Synopsis

interface ConstMap implements ConstCollection<Pair<Tk, Tv>>, ConstMapAccess<Tk, Tv>, HH\KeyedIterable<Tk, Tv>, HH\KeyedContainer<Tk, Tv> {...}

Public Methods

• ->concat<Tu super Tv>(Traversable<Tu> $traversable): ConstVector<Tu>
  Returns a ConstVector that is the concatenation of the values of the current ConstMap and the values of the provided Traversable
• ->filter((function(Tv): bool) $fn): ConstMap<Tk, Tv>
  Returns a ConstMap containing the values of the current ConstMap that meet a supplied condition
• ->filterWithKey((function(Tk, Tv): bool) $fn): ConstMap<Tk, Tv>
  Returns a ConstMap containing the values of the current ConstMap that meet a supplied condition applied to its keys and values
• ->firstKey(): ?Tk
  Returns the first key in the current ConstMap
• ->firstValue(): ?Tv
  Returns the first value in the current ConstMap
• ->keys(): ConstVector<Tk>
  Returns a ConstVector containing the keys of the current ConstMap
• ->lastKey(): ?Tk
  Returns the last key in the current ConstMap
• ->lastValue(): ?Tv
  Returns the last value in the current ConstMap
• ->map<Tu>((function(Tv): Tu) $fn): ConstMap<Tk, Tu>
  Returns a ConstMap after an operation has been applied to each value in the current ConstMap
• ->mapWithKey<Tu>((function(Tk, Tv): Tu) $fn): ConstMap<Tk, Tu>
  Returns a ConstMap after an operation has been applied to each key and value in the current ConstMap
• ->skip(int $n): ConstMap<Tk, Tv>
  Returns a ConstMap containing the values after the n-th element of the current ConstMap
• ->skipWhile((function(Tv): bool) $fn): ConstMap<Tk, Tv>
  Returns a ConstMap containing the values of the current ConstMap starting after and including the first value that produces true when passed to the specified callback
• ->slice(int $start, int $len): ConstMap<Tk, Tv>
  Returns a subset of the current ConstMap starting from a given key location up to, but not including, the element at the provided length from the starting key location
• ->take(int $n): ConstMap<Tk, Tv>
  Returns a ConstMap containing the first n key/values of the current ConstMap
• ->takeWhile((function(Tv): bool) $fn): ConstMap<Tk, Tv>
  Returns a ConstMap containing the keys and values of the current ConstMap up to but not including the first value that produces false when passed to the specified callback
• ->toDArray(): darray<Tk, Tv>
• ->toVArray(): varray<Tv>
• ->values(): ConstVector<Tv>
  Returns a ConstVector containing the values of the current ConstMap
• ->zip<Tu>(Traversable<Tu> $traversable): ConstMap<Tk, Pair<Tv, Tu>>
  Returns a ConstMap where each value is a Pair that combines the value of the current ConstMap and the provided Traversable

Public Methods (ConstCollection)

• ->count(): int
  Get the number of items in the collection

• ->isEmpty(): bool
  Is the collection empty?

• ->items(): HH\Iterable<Te>
  Get access to the items in the collection

Public Methods (IPureStringishObject)

• ->__toString(): string

Public Methods (ConstSetAccess)

• ->contains(arraykey $m): bool
  Checks whether a value is in the current Set

Public Methods (ConstIndexAccess)

• ->at(Tk $k): Tv
  Returns the value at the specified key in the current collection
• ->containsKey(mixed $k): bool
  Determines if the specified key is in the current collection
• ->get(Tk $k): ?Tv
  Returns the value at the specified key in the current collection

Public Methods (HH\KeyedIterable)

• ->getIterator(): KeyedIterator<Tk, Tv>
  Returns an iterator that points to beginning of the current KeyedIterable
• ->lazy(): KeyedIterable<Tk, Tv>
  Returns a lazy, access elements only when needed view of the current KeyedIterable
• ->toImmMap(): ImmMap<Tk, Tv>
  Returns an immutable map (ImmMap) based on the keys and values of the current KeyedIterable
• ->toKeysArray(): varray
  Returns an array with the keys from the current KeyedIterable

Public Methods (HH\Iterable)

• ->toImmSet(): ImmSet<Tv>
  Returns an immutable set (ImmSet) converted from the current Iterable
• ->toImmVector(): ImmVector<Tv>
  Returns an immutable vector (ImmVector) converted from the current Iterable
• ->toValuesArray(): varray<Tv>
  Returns an array with the values from the current Iterable