Blob

A blob is an immutable sequences of bytes. Blobs are similar to arrays of bytes [Nat8].

The convention is to name the module alias after the file name it is defined in:

import Blob "mo:base/Blob";

Blob.fromArray

func fromArray(bytes : [Nat8]) : Blob

import Blob "mo:base/Blob";

let a : [Nat8] = [253, 254, 255];

Blob.fromArray(a);

func toArray(blob : Blob) : [Nat8]

import Blob "mo:base/Blob";

let blob : Blob = "\0a\0b\0c" : Blob;

Blob.toArray(blob);

func toArrayMut(blob : Blob) : [var Nat8]

import Blob "mo:base/Blob";

let blob : Blob = "\0a\0b\0c" : Blob;

Blob.toArrayMut(blob);

func fromArrayMut(bytes : [var Nat8]) : Blob

import Blob "mo:base/Blob";

let a : [var Nat8] = [var 253, 254, 255];

Blob.fromArrayMut(a);

func hash(blob : Blob) : Nat32

The function hash takes one Blob value and returns a Nat32 value.

import Blob "mo:base/Blob";

let blob : Blob = "\00\ff\00" : Blob;

Blob.hash(blob);

func compare(blob1 : Blob, blob2 : Blob) : {#less; #equal; #greater}

The function compare takes two Blob value and returns an Order value.

import Blob "mo:base/Blob";

let blob1 : Blob = "\00\ef\00" : Blob;
let blob2 : Blob = "\00\ff\00" : Blob;

Blob.compare(blob1, blob2);

func equal(blob1 : Blob, blob2 : Blob) : Bool

The function equal takes two Blob value and returns a Bool value.

import Blob "mo:base/Blob";

let blob1 : Blob = "\00\ff\00" : Blob;
let blob2 : Blob = "\00\ff\00" : Blob;

Blob.equal(blob1, blob2);

func notEqual(blob1 : Blob, blob2 : Blob) : Bool

The function notEqual takes two Blob value and returns a Bool value.

import Blob "mo:base/Blob";

let blob1 : Blob = "\00\ff\00" : Blob;
let blob2 : Blob = "\00\ef\00" : Blob;

Blob.notEqual(blob1, blob2);

func less(blob1 : Blob, blob2 : Blob) : Bool

The function less takes two Blob value and returns a Bool value.

import Blob "mo:base/Blob";

let blob1 : Blob = "\00\ef\00" : Blob;
let blob2 : Blob = "\00\ff\00" : Blob;

Blob.less(blob1, blob2);

func lessOrEqual(blob1 : Blob, blob2 : Blob) : Bool

The function lessOrEqual takes two Blob value and returns a Bool value.

import Blob "mo:base/Blob";

let blob1 : Blob = "\00\ef\00" : Blob;
let blob2 : Blob = "\00\ff\00" : Blob;

Blob.lessOrEqual(blob1, blob2);

func greater(blob1 : Blob, blob2 : Blob) : Bool

The function greater takes two Blob value and returns a Bool value.

import Blob "mo:base/Blob";

let blob1 : Blob = "\00\ff\00" : Blob;
let blob2 : Blob = "\00\ef\00" : Blob;

Blob.greater(blob1, blob2);

func greaterOrEqual(blob1 : Blob, blob2 : Blob) : Bool

The function greaterOrEqual takes two Blob value and returns a Bool value.

import Blob "mo:base/Blob";

let blob1 : Blob = "\00\ff\00" : Blob;
let blob2 : Blob = "\00\ef\00" : Blob;

Blob.greaterOrEqual(blob1, blob2);