Share via


Pop Method

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Removes and returns the object at the top of the Stack.

Namespace:  System.Collections
Assembly:  mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Overridable Function Pop As Object
public virtual Object Pop()
public:
virtual Object^ Pop()
abstract Pop : unit -> Object 
override Pop : unit -> Object 
public function Pop() : Object

Return Value

Type: System. . :: . .Object
The Object removed from the top of the Stack.

Exceptions

Exception Condition
InvalidOperationException

The Stack is empty.

Remarks

This method is similar to the Peek method, but Peek does not modify the Stack.

null Nothing nullptr unit a null reference (Nothing in Visual Basic) can be pushed onto the Stack as a placeholder, if needed. To distinguish between a null value and the end of the stack, check the Count property or catch the InvalidOperationException, which is thrown when the Stack is empty.

Stack is implemented as a circular buffer. This method is an O(1) operation.

.NET Framework Security

See Also

Reference

Stack Class

System.Collections Namespace