MDN self-hosted library · e01.org

or: Wasm numeric instruction

The or numeric instruction is used for performing a bitwise OR, similar to the | operator in other languages.

no runnable cells webassembly-instruction upstream source

The or numeric instruction is used for performing a bitwise OR, similar to the | operator in other languages.

tabbed-taller

```wat interactive-example (module

(func (export "or") (param $a i32) (param $b i32) (result i32) ;; load both numbers onto the stack local.get $a local.get $b

;; `or` both numbers and return the result
i32.or

)

)


```js interactive-example
const url = "{%wasm-url%}";
await WebAssembly.instantiateStreaming(fetch(url), { console }).then(
  (result) => {
    const or = result.instance.exports.or;

    const res = or(0b10000010, 0b01101111);
    console.log(numToBin(res));
    // Expected output: "11101111"
  },
);

function numToBin(num) {
  return (num >>> 0).toString(2).padStart(8, "0");
}

Syntax

value_type.or
  • value_type
  • : The type of value the instruction is being run on. The following types support or:
  • or
  • : The or instruction. Must always be included after the value_type and a period (.).

Type

[input1, input2] -> [output]
  • input1
  • : The first input value.
  • input2
  • : The second input value.
  • output
  • : The output value.

For a non-SIMD or, these will be basic numeric values such as 14 or 3.

For a SIMD or, these will be v128 value interpretations, for example i32x4 9 4 -16 100. Each lane of the output pushed to the stack is the bitwise OR of the corresponding lanes in the input values.

Binary encoding

Instruction Binary format Example text => binary
i32.or 0x72 i32.or => 0x72
i64.or 0x84 i64.or => 0x84
v128.or 0xfd 80:u32 v128.or => 0xfd 0x50

Examples

SIMD or example

In this example, we demonstrate running v128.or on two SIMD values and outputting one of the lane values of the result.

JavaScript

In our script, we grab a reference to a p element that we will output our result to, then define an object for import into Wasm containing a single function that writes a value to the output <p>. We then compile and instantiate our Wasm module using the WebAssembly.instantiateStreaming() method, importing the object in the process.

```html hidden live-sample___simd_or


```js live-sample___simd_or
const outputElem = document.querySelector("p");

const obj = {
  output(val) {
    outputElem.textContent += val;
  },
};

WebAssembly.instantiateStreaming(fetch("{%wasm-url%}"), {
  obj,
});

Wasm

In our Wasm module, we first import the JavaScript output() function, making sure to declare that it has an i32 parameter. We then declare two SIMD i32x4 values and use v128.or to "or" the bits of each value's binary representation. Finally we extract the value stored in lane 3 of the output value using the extract_lane instruction, and output it to the DOM by calling the imported output() function.

```wat live-sample___simd_or (module ;; Import output function (import "obj" "output" (func $output (param i32)))

(func $main ;; load two SIMD values onto the stack v128.const i32x4 12 10 11 782 v128.const i32x4 12 14 15 400

v128.or ;; "or" the two values
i32x4.extract_lane 3 ;; Extract a value from the result
call $output

)

(start $main) )


#### Result

The output is as follows:

100%

`926` is output because this is the result of "or"ing lane 3 of the first value (`782`) and the second value (`400`). If you look at their binary equivalents, it is clear how this works:

```plain
782 = 0000 0011 0000 1110
400 = 0000 0001 1001 0000
      -------------------
 OR = 0000 0011 1001 1110 = 926

Specifications

Browser compatibility