Monkeybread Xojo plugin - BigNumberMBS methods

BigNumberMBS.Abs as BigNumberMBS

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Queries absolute value.
Example:

dim o as BigNumberMBS = new BigNumberMBS(-123)
dim z as BigNumberMBS = o.Abs

MsgBox z.StringValue

Notes: Removes sign.

See also:

Abs(value as BigNumberMBS) as BigNumberMBS

BigNumberMBS.Add(other as BigNumberMBS, round as boolean = true) as BigNumberMBS

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Adds a number.
Example:

dim x as new BigNumberMBS(2)
dim d as new BigNumberMBS(3)
dim p as BigNumberMBS = x.Add(d)

MsgBox p.StringValue // shows 5

BigNumberMBS.BitAnd(other as BigNumberMBS) as BigNumberMBS

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Calculates bitwise AND operation.
Example:

dim x as new BigNumberMBS(17)
dim y as new BigNumberMBS(16)
dim r as BigNumberMBS = x.BitAnd(y)

MsgBox r.StringValue

BigNumberMBS.BitOr(other as BigNumberMBS) as BigNumberMBS

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Calculates bitwise or operation.
Example:

dim x as new BigNumberMBS(17)
dim y as new BigNumberMBS(16)
dim r as BigNumberMBS = x.BitOr(y)

MsgBox r.StringValue

BigNumberMBS.BitXOr(other as BigNumberMBS) as BigNumberMBS

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Calculates bitwise xor operation.
Example:

dim x as new BigNumberMBS(17)
dim y as new BigNumberMBS(16)
dim r as BigNumberMBS = x.BitXOr(y)

MsgBox r.StringValue

BigNumberMBS.Ceil as BigNumberMBS

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	21.1	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: This function returns a value representing the smallest integer that is greater than or equal to x.
Example:

Dim c As New BigNumberMBS(-3.7)
Dim d As BigNumberMBS = c.Ceil

MsgBox d // shows -3

Notes:
e.g.
Ceil(-3.7) = -3
Ceil(-3.1) = -3
Ceil(-3.0) = -3
Ceil(4.0) = 4
Ceil(4.2) = 5
Ceil(4.8) = 5

BigNumberMBS.Constructor

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Initialize the number with zero value.
Example:

dim o as BigNumberMBS = new BigNumberMBS
MsgBox o.StringValue

See also:

BigNumberMBS.Constructor(other as BigNumberMBS)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Initialize the number with other value.
Example:

dim o as BigNumberMBS = new BigNumberMBS(2.5)
dim c as BigNumberMBS = new BigNumberMBS(o)

MsgBox c.StringValue

See also:

BigNumberMBS.Constructor(value as Currency)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Creates a new number object with a currency object.
Example:

dim v as Currency = 123.456
dim b as new BigNumberMBS(v)
MsgBox b.StringValue

See also:

BigNumberMBS.Constructor(value as Double)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Initialize the number with double value.
Example:

dim o as BigNumberMBS = new BigNumberMBS(2.5)
MsgBox str(o.DoubleValue)+" = "+str(o.StringValue)#

See also:

BigNumberMBS.Constructor(value as Int32)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Creates a new number with a 32-bit integer.
Example:

dim v as Int32 = 123
dim b as new BigNumberMBS(v)
MsgBox b.StringValue

See also:

BigNumberMBS.Constructor(value as Int64)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Creates a new number with a 64-bit integer.
Example:

dim v as Int64 = 123
dim b as new BigNumberMBS(v)
MsgBox b.StringValue

See also:

BigNumberMBS.Constructor(value as Single)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Creates a new number with a 32-bit floating point number.
Example:

dim v as Single = 123
dim b as new BigNumberMBS(v)
MsgBox b.StringValue

See also:

BigNumberMBS.Constructor(value as String)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Initialize the number with string value.
Example:

dim o as BigNumberMBS = new BigNumberMBS("123.456")
MsgBox o.StringValue

See also:

BigNumberMBS.Constructor(value as UInt32)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Creates a new number with an unsigned 32-bit integer.
Example:

dim v as UInt32 = 123
dim b as new BigNumberMBS(v)
MsgBox b.StringValue

See also:

BigNumberMBS.Constructor(value as UInt64)

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Creates a new number with an unsigned 32-bit integer.
Example:

dim v as UInt64 = 123
dim b as new BigNumberMBS(v)
MsgBox b.StringValue

See also:

BigNumberMBS.Divide(other as BigNumberMBS, round as boolean = true) as BigNumberMBS

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Divides the number.
Example:

dim x as new BigNumberMBS(8)
dim d as new BigNumberMBS(2)
dim p as BigNumberMBS = x.Divide(d)

MsgBox p.StringValue // shows 4

BigNumberMBS.Equals(other as BigNumberMBS) as Boolean

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Checks if two numbers are the same.
Example:

dim o as BigNumberMBS = new BigNumberMBS(123)
dim z as BigNumberMBS = new BigNumberMBS(123)

if o.Equals(z) then
  MsgBox "equal"
else
  Break // error
end if

Notes: Returns true if equal.

BigNumberMBS.Floor as BigNumberMBS

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Removes any fraction part.
Example:

dim o as BigNumberMBS = new BigNumberMBS(2.3)
dim s as BigNumberMBS = o.Floor

MsgBox s.StringValue

dim a as BigNumberMBS = new BigNumberMBS(-2.3)
dim b as BigNumberMBS = a.Floor

MsgBox b.StringValue

BigNumberMBS.Frac as BigNumberMBS

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Extracts the fraction part.
Example:

dim o as BigNumberMBS = new BigNumberMBS(2.5)
dim s as BigNumberMBS = o.Frac

MsgBox s.StringValue

dim a as BigNumberMBS = new BigNumberMBS(-2.5)
dim b as BigNumberMBS = a.Frac

MsgBox b.StringValue

BigNumberMBS.GetStringValue(Base as Integer = 10, scientific as boolean = false, scientificFrom as Integer = 15, round as Integer = -1, TrimZeros as Boolean = true, comma as String = ".") as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Queries string value.
Example:

dim o as new BigNumberMBS(1234)

// show as hex
MsgBox o.GetStringValue(16)

// show as number with comma and 3 digits
dim z as new BigNumberMBS(12.345)
MsgBox z.GetStringValue(10, false, 15, 3, true, ",")

Notes:
Base: The base of the number system. Normally 10, but also 16 for hex is common.
scientific: Whether to use scientific notation.
scientificFrom: How many digits we show.
Round: Whether to round to n digits.
TrimZeros: Whether to trim unneeded zeros.
comma: The character to use as decimal dot.

BigNumberMBS.Modulate(other as BigNumberMBS) as BigNumberMBS

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Modulates a number.
Example:

dim x as new BigNumberMBS(17)
dim y as new BigNumberMBS(3)
dim r as BigNumberMBS = x.Modulate(y)

MsgBox r.StringValue

Notes: Similar to mod keyword in Xojo.

BigNumberMBS.Modulate2 as Integer

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Modulates by 2.
Example:

dim x as new BigNumberMBS(8)
dim y as new BigNumberMBS(9)

MsgBox str(x.Modulate2)+" "+str(y.Modulate2)

Notes: Returns 0 or 1.

BigNumberMBS.Multiply(other as BigNumberMBS, round as boolean = true) as BigNumberMBS

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Multiplies two numbers.
Example:

dim x as new BigNumberMBS(8)
dim d as new BigNumberMBS(2)
dim p as BigNumberMBS = x.Multiply(d)

MsgBox p.StringValue // shows 16

See also:

BigNumberMBS.Multiply(value as Integer) as BigNumberMBS

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Multiply by an integer.
Example:

dim x as new BigNumberMBS(2)
dim p as BigNumberMBS = x.Multiply(3)

MsgBox p.StringValue // shows 6

See also:

BigNumberMBS.Multiply(value as UInt32) as BigNumberMBS

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Multiply by an unsigned integer.
Example:

dim x as new BigNumberMBS(17)
dim r as BigNumberMBS = x.Multiply(3)

MsgBox r.StringValue

See also:

BigNumberMBS.Negate as BigNumberMBS

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Negates the number.
Example:

dim o as BigNumberMBS = new BigNumberMBS(123)
dim z as BigNumberMBS = o.Negate

MsgBox z.StringValue

BigNumberMBS.Operator_Add(other as BigNumberMBS) as BigNumberMBS

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Adds a number.
Example:

dim a as new BigNumberMBS(3)
dim b as new BigNumberMBS(4)

// add
dim c as BigNumberMBS = a + b

MsgBox c.StringValue

BigNumberMBS.Operator_AddRight(other as BigNumberMBS) as BigNumberMBS

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Math	MBS DataTypes Plugin	16.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Adds a number.
Example:

dim a as new BigNumberMBS(3)
dim b as new BigNumberMBS(4)

// add
dim c as BigNumberMBS = a + b

MsgBox c.StringValue