In computer science, peek is an operation on certain abstract data types, specifically sequential collections such as stacks and queues, which returns the value of the top of the collection without removing the element from the collection. It thus returns the same value as operations such as "pop" or "dequeue", but does not modify the data. The name "peek" is similar to the basic "push" and "pop" operations on a stack, but the name for this operation varies depending on data type and language. Peek is generally considered an inessential operation, compared with the more basic operations of adding and removing data, and as such is not included in the basic definition of these data types. However, since it is a useful operation and generally easily implemented, it is frequently included in practices, and in some definitions peek is included as basic, with pop defined in terms of peek; see [|abstract definition].
Data types
Sequential types for which peek is often implemented include:
Single-ended types, such as stack, generally only admit a single peek, at the end that is modified. Double-ended types, such as deques, admit two peeks, one at each end. Names for peek vary. "Peek" or "top" are common for stacks, while for queues "front" is common. Operations on deques have varied names, often "front" and "back" or "first" and "last". The name "peak" is also occasionally found, in the sense of "top, summit", though this also occurs as a spelling error for the verb "peek".
Abstract definition
Intuitively, peek returns the same value as pop, but does not change the data. Behavior when the collection is empty varies – most often this yields an underflow error, identically to a pop on an empty collection, but some implementations provide a function which instead simply returns, essentially implementing if isempty then return, else peek. This behavior can be axiomatized in various ways. For example, a common VDM description of a stack defines top and remove as atomic, where top returns the top value, and remove modifies the stack. In this case pop is defined in terms of top and remove. Alternatively, given pop, the operation peek can be axiomatized as: meaning "returns the same value as pop", and "does not change the underlying data".
Implementation
Peek can generally be implemented very easily in simple routine taking O time and no added space, by a simple variant of the pop operation. Most sequential data types are implemented by a data structure containing a reference to the end, and thus peek is simply implemented by dereferencing this. In some cases it is more complicated, however. For some data types, such as stacks, this can be replicated in terms of more basic operations, but for other data types, such as queues, it cannot. Even if peek can be replicated in terms of other operations, it is almost always more efficient to implement it separately, as this avoids modifying the data, and it is easy to implement, as this simply consists of returning the same value as the "pop", but then not modifying the data. For the stack, priority queue, deque, and DEPQ types, peek can be implemented in terms of pop and push. For stacks and deques this is generally efficient, as these operations are O in most implementations, and do not require memory allocation – the two ends of a deque each functioning as a stack. For priority queues and DEPQs, however, dequeuing and enqueuing often take O time, while O performance of "peek" is a key desired characteristic of priority queues, and thus peek is almost invariably implemented separately. For queue, because enqueuing and dequeuing occur at opposite ends, peek cannot be implemented in terms of basic operations, and thus is often implemented separately. One case in which peek is not trivial is in an ordered list type implemented by a self-balancing binary search tree. In this case find-min or find-max take O time, as does access to any other element. Making find-min or find-max take O time can be done by caching the min or max values, but this adds overhead to the data structure and to the operations of adding or removing elements.
