as-variant

Variant Data Type for AssemblyScript
===


Supports any builtin types like i32, bool, string and any custom classes (managed and unmanaged).

$3

``ts
import { Variant } from 'as-variant/assembly'
// before 0.20.x
// import { Variant } from 'as-variant'

class Foo { }

let vNum = Variant.from(123) // stored as i32
let vStr = Variant.from('hello') // stored as string
let vFoo = Variant.from(new Foo) // stored as Foo reference

vNum.set(2.0) // now stored as f64

assert(vNum.is()) // ok
assert(!vStr.is()) // ok
assert(vStr.is()) // ok
assert(vFoo.is()) // ok

assert(vNum.id != vStr.id) // compare dynamic IDs.
assert(vFoo.id == Variant.idof())

let valF64 = vNum.get() // safely extract value
let willFail = vNum.get() // will throw exception!
`

$3

`ts
let vNum = Variant.from(123)
// getUnchecked skips all checks. It may be danger.
assert(vNum.getUnchecked() == 123)
`

$3

`ts
const dict = new Map()

dict.set('str', Variant.from('hello'))
dict.set('num', Variant.from(124.0))

dict.set('arr', Variant.from([1, 2, 3]))

assert(dict.get('arr').get()[2] == 3)
// or
assert(dict['arr'].get()[2] == 3)
`

which equivalent to JavaScript:

`js
const dict = {
str: 'hello',
num: 124.0,
}

dict.arr = [1, 2, 3]

assert(dict.arr[2] == 3)
``