GetValue()
Overrides MfPrimitive.GetValue().
OutputVar := MfUInt64.GetValue(Obj)
OutputVar := MfUInt64.GetValue(Obj, Default)
OutputVar := MfUInt64.GetValue(Obj, Default, AllowAny)
Gets the integer number from Object or var containing integer.
Obj
The Object or var containing, integer or hex value
Can be any type that matches IsNumber, var integer or var string of integer numbers.
Returns a var containing a integer No less then MinValue and no greater then MaxValue.
Throws MfInvalidOperationException if not called as a static method.
Throws MfArgumentOutOfRangeException if Obj is less then MinValue or Greater then MaxValue.
Throws MfArgumentException if argument Obj is can not be converted to integer value.
Static Method
AutoHotkey has an integer upper limit of MfInt64.MaxValue. As a precaution all integer values passed into MfUInt64 methods can be wrapped in double quotes. eg: i := new MfUInt64("10", true)
Throws an error if unable to convert Obj to integer.
Gets a integer number from Obj or returns Default value if Obj is unable to be converted to integer. Default must be a value that can be converted to integer or it will be ignored if Obj can not be converted to integer and an error will be thrown.
Obj
The Object or var containing, integer or hex value
Can be any type that matches IsNumber, var integer or var string of integer numbers.
Default
The value to return if Obj is Cannot be converted
Can be any type that matches IsIntegerNumber or var of integer.
Returns a var containing a integer or Default value if Obj is unable to be converted to integer.
Throws MfInvalidOperationException if not called as a static method.
Static Method
AutoHotkey has an integer upper limit of MfInt64.MaxValue. As a precaution all integer values passed into MfUInt64 methods can be wrapped in double quotes. eg: i := new MfUInt64("10", true)
If Default is not a valid integer or MfUInt64 instance then GetValue will throw an error if Obj can not be converted to integer.
If Default can not be converted to a integer then this would method will yield the same results as calling MfUInt64.GetValue(Obj).
Gets a integer number from Obj or returns Default value if Obj is unable to be converted to integer.
Obj
The Object or var containing, integer or hex value
Can be any type that matches IsNumber, var integer or var string of integer numbers.
Default
The value to return if Obj is Cannot be converted
Can be any type that matches IsIntegerNumber or var of integer.
AlowAny
Determines if Default can be a value other then integer. If true Default can be any var, Object or null; Otherwise Default must be a integer value.
Static Method.
AutoHotkey has an integer upper limit of MfInt64.MaxValue. As a precaution all integer values passed into MfUInt64 methods can be wrapped in double quotes. eg: i := new MfUInt64("10", true)
If AllowAny is true then Default can be any value including var, object or null. However if AllowAny is false then this method will yield the same result as calling MfUInt64.GetValue(Obj, Default).
Throws MfInvalidOperationException if not called as a static method.
Throws MfArgumentException if AllowAny is not a valid boolean.
If Obj is a float or MfFloat instance then GetValue() will alway round down for positive number and round up for negative numbers. For instance MfInteger.GetValue(2.8) will be 2 and MfInteger.GetValue(-2.8) will be -2.
Throws MfNotSupportedException if incorrect number of parameters are passed in.
Obj := new MfUInt64("233")
val := MfUInt64.GetValue(Obj)
MsgBox %val% ; displays 233
Obj := new MfInt16(214)
val := MfUInt64.GetValue(Obj)
MsgBox %val% ; displays 214
val := MfUInt64.GetValue(214)
MsgBox %val% ; displays 214
val := MfUInt64.GetValue(0x100000001) ; displays 4294967297
MsgBox %val%
val := MfUInt64.GetValue("0xFFFFFFFFFFFFFFFE") ; displays 18446744073709551614
MsgBox %val%
; the following will display zero due to integer overflow Default is returned
; MfUInt64 can be min of 0 and max of 18446744073709551615
val := MfUInt64.GetValue("0xFFFFFFFFFFFFFFFFF", 0)
MsgBox %val% ; displays 0
; the following will throw MfArgumentException
; MfUInt64 can be min of 0 and max of 18446744073709551615
; Default value passed in is not a valid UInt64
val := MfUInt64.GetValue("18446744073709551616", -3147483656)
MsgBox %val%
; the following will display -1 due to integer overflow Default is returned
; Default value passed in is not a valid UInt64 but will return anyways
; because AllowAny is Set to true
val := MfUInt64.GetValue("18446744073709551616", -1, true)
MsgBox %val% ; displays -1
val := MfUInt64.GetValue(0x00F4)
MsgBox %val% ; displays 244
; the following will throw MfArgumentException
val := MfUInt64.GetValue("abc")
MsgBox %val%
; the Default set to 25 will be returned
val := MfUInt64.GetValue("abc", 25)
MsgBox %val% ; displays 25
VarDefault := new MfUInt64(MfUInt64.MaxValue)
val := MfUInt64.GetValue("abc", VarDefault)
MsgBox %val% ; displays 18446744073709551615
; Default Obj is not a valid UInt64 and Default
; is not a valid UInt64 but AllowAny is true
val := MfUInt64.GetValue("abc", "Undefined", true)
MsgBox %val% ; displays Undefined
; MfNumberStyles.Instance.Number is MfEnum.EnumItem
; and MfEnum.EnumItem is of type IsIntegerNumber
val := MfUInt64.GetValue(MfNumberStyles.Instance.Number)
MsgBox %val% ; displays 111