ESC
No recent searches
Search by
Standard Library  /  Int8

Grain Docs

Welcome to Grain! Editor Setup Getting Grain

The Guide

Hello World The Basics Conditionals Functions Shadowing and Mutation Loops Lists and arrays Custom Data Types Modules Pattern Matching

Reference

Building for Production Built-in Types The Grain CLI Graindoc

Standard Library

Pervasives BigInt Array Buffer Bytes Char Exception Float32 Float64 Hash Int16 Int32 Int64 Int8 Json List Map Marshal Number Option Path PriorityQueue Queue Random Range Rational Regex Result Stack Set String Uint16 Uint32 Uint64 Uint8 Uri wasi / File wasi / Process wasi / Random wasi / Time

Int8

Utilities for working with the Int8 type.

Edit on GitHub
Added in 0.6.0 No other changes yet. 
from "int8" include Int8
1s
-1s

Values

Functions and constants included in the Int8 module.

Int8.fromNumber

Added in 0.6.0 No other changes yet. 
fromNumber : (number: Number) => Int8

Converts a Number to an Int8.

Parameters:

number: The value to convert

Returns:

Int8: The Number represented as an Int8

Int8.toNumber

Added in 0.6.0 No other changes yet. 
toNumber : (value: Int8) => Number

Converts an Int8 to a Number.

Parameters:

value: The value to convert

Returns:

Number: The Int8 represented as a Number

Int8.fromUint8

Added in 0.6.0 No other changes yet. 
fromUint8 : (number: Uint8) => Int8

Converts a Uint8 to an Int8.

Parameters:

number: The value to convert

Returns:

Int8: The Uint8 represented as an Int8

Examples:

Int8.fromUint8(1us) == 1s

Int8.incr

Added in 0.6.0 No other changes yet. 
incr : (value: Int8) => Int8

Increments the value by one.

Parameters:

value: The value to increment

Returns:

Int8: The incremented value

Examples:

Int8.incr(1s) == 2s
Int8.incr(-2s) == -1s

Int8.decr

Added in 0.6.0 No other changes yet. 
decr : (value: Int8) => Int8

Decrements the value by one.

Parameters:

value: The value to decrement

Returns:

Int8: The decremented value

Examples:

Int8.decr(2s) == 1s
Int8.decr(0s) == -1s

Int8.(+)

Added in 0.6.0 No other changes yet. 
(+) : (x: Int8, y: Int8) => Int8

Computes the sum of its operands.

Parameters:

x: The first operand
y: The second operand

Returns:

Int8: The sum of the two operands

Examples:

use Int8.{ (+) }
assert 1s + 1s == 2s

Int8.(-)

Added in 0.6.0 No other changes yet. 
(-) : (x: Int8, y: Int8) => Int8

Computes the difference of its operands.

Parameters:

x: The first operand
y: The second operand

Returns:

Int8: The difference of the two operands

Examples:

use Int8.{ (-) }
assert 2s - 1s == 1s

Int8.(*)

Added in 0.6.0 No other changes yet. 
(*) : (x: Int8, y: Int8) => Int8

Computes the product of its operands.

Parameters:

x: The first operand
y: The second operand

Returns:

Int8: The product of the two operands

Examples:

use Int8.{ (*) }
assert 2s * 2s == 4s

Int8.(/)

Added in 0.6.0 No other changes yet. 
(/) : (x: Int8, y: Int8) => Int8

Computes the quotient of its operands using signed division.

Parameters:

x: The first operand
y: The second operand

Returns:

Int8: The quotient of its operands

Examples:

use Int8.{ (/) }
assert 8s / 2s == 4s

Int8.rem

Added in 0.6.0 No other changes yet. 
rem : (x: Int8, y: Int8) => Int8

Computes the remainder of the division of its operands using signed division.

Parameters:

x: The first operand
y: The second operand

Returns:

Int8: The remainder of its operands

Examples:

Int8.rem(8s, 3s) == 2s

Int8.(%)

Added in 0.6.0 No other changes yet. 
(%) : (x: Int8, y: Int8) => Int8

Computes the remainder of the division of the first operand by the second. The result will have the sign of the second operand.

Parameters:

x: The first operand
y: The second operand

Returns:

Int8: The modulus of its operands

Throws:

ModuloByZero

  • When y is zero

Examples:

use Int8.{ (%) }
assert -5s % 3s == 1s

Int8.(<<)

Added in 0.6.0 No other changes yet. 
(<<) : (value: Int8, amount: Int8) => Int8

Shifts the bits of the value left by the given number of bits.

Parameters:

value: The value to shift
amount: The number of bits to shift by

Returns:

Int8: The shifted value

Examples:

use Int8.{ (<<) }
assert (5s << 1s) == 10s

Int8.(>>)

Added in 0.6.0 No other changes yet. 
(>>) : (value: Int8, amount: Int8) => Int8

Shifts the bits of the value right by the given number of bits, preserving the sign bit.

Parameters:

value: The value to shift
amount: The amount to shift by

Returns:

Int8: The shifted value

Examples:

use Int8.{ (>>) }
assert (5s >> 1s) == 2s

Int8.(==)

Added in 0.6.0 No other changes yet. 
(==) : (x: Int8, y: Int8) => Bool

Checks if the first value is equal to the second value.

Parameters:

x: The first value
y: The second value

Returns:

Bool: true if the first value is equal to the second value or false otherwise

Examples:

use Int8.{ (==) }
assert 1s == 1s

Int8.(!=)

Added in 0.6.0 No other changes yet. 
(!=) : (x: Int8, y: Int8) => Bool

Checks if the first value is not equal to the second value.

Parameters:

x: The first value
y: The second value

Returns:

Bool: true if the first value is not equal to the second value or false otherwise

Examples:

use Int8.{ (!=) }
assert 1s != 2s

Int8.(<)

Added in 0.6.0 No other changes yet. 
(<) : (x: Int8, y: Int8) => Bool

Checks if the first value is less than the second value.

Parameters:

x: The first value
y: The second value

Returns:

Bool: true if the first value is less than the second value or false otherwise

Examples:

use Int8.{ (<) }
assert 1s < 2s

Int8.(>)

Added in 0.6.0 No other changes yet. 
(>) : (x: Int8, y: Int8) => Bool

Checks if the first value is greater than the second value.

Parameters:

x: The first value
y: The second value

Returns:

Bool: true if the first value is greater than the second value or false otherwise

Examples:

use Int8.{ (>) }
assert 2s > 1s

Int8.(<=)

Added in 0.6.0 No other changes yet. 
(<=) : (x: Int8, y: Int8) => Bool

Checks if the first value is less than or equal to the second value.

Parameters:

x: The first value
y: The second value

Returns:

Bool: true if the first value is less than or equal to the second value or false otherwise

Examples:

use Int8.{ (<=) }
assert 1s <= 2s
use Int8.{ (<=) }
assert 1s <= 1s

Int8.(>=)

Added in 0.6.0 No other changes yet. 
(>=) : (x: Int8, y: Int8) => Bool

Checks if the first value is greater than or equal to the second value.

Parameters:

x: The first value
y: The second value

Returns:

Bool: true if the first value is greater than or equal to the second value or false otherwise

Examples:

use Int8.{ (>=) }
assert 2s >= 1s
use Int8.{ (>=) }
assert 1s >= 1s

Int8.lnot

Added in 0.6.0 No other changes yet. 
lnot : (value: Int8) => Int8

Computes the bitwise NOT of the given value.

Parameters:

value: The given value

Returns:

Int8: Containing the inverted bits of the given value

Examples:

Int8.lnot(-5s) == 4s

Int8.(&)

Added in 0.6.0 No other changes yet. 
(&) : (x: Int8, y: Int8) => Int8

Computes the bitwise AND (&) on the given operands.

Parameters:

x: The first operand
y: The second operand

Returns:

Int8: Containing a 1 in each bit position for which the corresponding bits of both operands are 1

Examples:

use Int8.{ (&) }
assert (3s & 4s) == 0s

Int8.(|)

Added in 0.6.0 No other changes yet. 
(|) : (x: Int8, y: Int8) => Int8

Computes the bitwise OR (|) on the given operands.

Parameters:

x: The first operand
y: The second operand

Returns:

Int8: Containing a 1 in each bit position for which the corresponding bits of either or both operands are 1

Examples:

use Int8.{ (|) }
assert (3s | 4s) == 7s

Int8.(^)

Added in 0.6.0 No other changes yet. 
(^) : (x: Int8, y: Int8) => Int8

Computes the bitwise XOR (^) on the given operands.

Parameters:

x: The first operand
y: The second operand

Returns:

Int8: Containing a 1 in each bit position for which the corresponding bits of either but not both operands are 1

Examples:

use Int8.{ (^) }
assert (3s ^ 5s) == 6s
Int64 Json

Sign up for farm-to-inbox developer news

You can unsubscribe at any time. Read our privacy policy.

Copyright © 2024 The Grain Programming Language