IMPORTANT: To view this page as Markdown, append `.md` to the URL (e.g. /docs/manual/basics.md). For the complete Mojo documentation index, see llms.txt.
Skip to main content
Version: 1.0.0
For the complete Mojo documentation index, see llms.txt. Markdown versions of all pages are available by appending .md to any URL (e.g. /docs/manual/basics.md).

unsafe_pointer

Defines UnsafePointer and related aliases as backward-compatible names for Pointer.

UnsafePointer is a comptime alias for Pointer, kept for code written before the two pointer types were unified. Prefer Pointer directly in new code; see std.memory.pointer for the type's docstring and its unsafe_ method surface.

comptime values

ImmUnsafePointer

comptime ImmUnsafePointer[T: AnyType, origin: ImmOrigin, *, address_space: AddressSpace = AddressSpace.GENERIC] = Pointer[T, origin, address_space=address_space]

An immutable unsafe pointer.

Deprecated: 'ImmUnsafePointer' is deprecated, use 'ImmPointer' instead

Parameters

  • T (AnyType): The pointee type.
  • origin (ImmOrigin): The origin of the pointer.
  • address_space (AddressSpace): The address space of the pointer.

MutUnsafePointer

comptime MutUnsafePointer[T: AnyType, origin: MutOrigin, *, address_space: AddressSpace = AddressSpace.GENERIC] = Pointer[T, origin, address_space=address_space]

A mutable unsafe pointer.

Deprecated: 'MutUnsafePointer' is deprecated, use 'MutPointer' instead

Parameters

  • T (AnyType): The pointee type.
  • origin (MutOrigin): The origin of the pointer.
  • address_space (AddressSpace): The address space of the pointer.

OptionalUnsafePointer

comptime OptionalUnsafePointer[mut: Bool, //, T: AnyType, origin: Origin[mut=mut], *, address_space: AddressSpace = AddressSpace.GENERIC] = Optional[Pointer[T, origin, address_space=address_space]]

An optional (nullable) UnsafePointer.

Deprecated: 'OptionalUnsafePointer' is deprecated, use 'OptionalPointer' instead

Parameters

  • mut (Bool): The mutability of the pointer.
  • T (AnyType): The type of the pointee.
  • origin (Origin[mut=mut]): The origin of the pointer.
  • address_space (AddressSpace): The address space of the pointer.

UnsafePointer

comptime UnsafePointer[mut: Bool, //, T: AnyType, origin: Origin[mut=mut], *, address_space: AddressSpace = AddressSpace.GENERIC] = Pointer[T, origin, address_space=address_space]

An indirect reference to one or more values of T consecutively in memory, and can refer to uninitialized memory.

Deprecated: 'UnsafePointer' is deprecated, use 'Pointer' instead

Parameters

  • mut (Bool): Whether the pointer is mutable.
  • T (AnyType): The type the pointer points to.
  • origin (Origin[mut=mut]): The origin of the memory being addressed.
  • address_space (AddressSpace): The address space of the pointer.