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
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).

masked_load

masked_load[dtype: DType, //, size: Int, alignment: Int = 1](addr: UnsafePointer[Scalar[dtype], address_space=addr.address_space], mask: SIMD[DType.bool, size], passthrough: SIMD[dtype, size]) -> SIMD[dtype, size]

Loads data from memory and return it, replacing masked lanes with values from the passthrough vector.

Parameters:

  • dtype (DType): DType of the return SIMD buffer.
  • size (Int): Size of the return SIMD buffer.
  • alignment (Int): The alignment of the destination locations. Must be 0 or a power of two constant integer value. Default is 1.

Args:

Returns:

SIMD[dtype, size]: The loaded memory stored in a vector of type SIMD[dtype, size].