Constructor()
Creates a new instance of MfChar Class
OutputVar := new MfChar([c, returnAsObj, readonly])
Initializes a new instance of the MfChar class optionally setting the Value property and the ReturnAsObject property and the Readonly property.
c
The object to get the char from. Can be instance of MfInteger, MfChar, or MfString. Can be integer var, string var.
returnAsObj
Determines if the current instance of MfChar class will return MfChar instances from functions or vars containing char. If omitted value is false
readonly
Determines if the current instance of MfChar class will allow its Value or CharCode to be altered after it is constructed.
The Readonly property will reflect this value after the class is constructed.
If omitted value is false
Sealed Class.
This constructor initializes the MfChar with the char value of c.
Value property to the value of c.
ReturnAsObject will have a value of returnAsObj
Readonly will be set to the value of readonly.
If Readonly is true then any attempt to change the underlying value will result in MfNotSupportedException being thrown.
Throws MfNotSupportedException if Class in extended.
Throws MfArgumentException if there is an error getting the value of c
Throws MfNotSupportedException if incorrect type of parameters or incorrect number of parameters.
c := new MfChar("a") ; create a new instance of MfChar class.
var := c.Value
MsgBox %var% ; displays a
; create a new instance of MfChar class and have it return MfChar object instances on methods it applys to.
c := new MfChar("F", true)
var := c.Value
MsgBox %var% ; displays F
c := new MfChar("hello world") ; only the first char will be used
var := c.Value
MsgBox %var% ; displays h
c := new MfChar(237) ; only the first char of 237 which is 2 will be used
var := c.Value
MsgBox %var% ; displays 2
c := new MfChar(-642) ; only the first char of -642 which is - will be used
var := c.Value
MsgBox %var% ; displays -
; MfStrng instances passed into the constructor will use the first character
str := new MfString("Hello world")
c := new MfChar(str)
var := c.Value
MsgBox %var% ; displays H
; hex values inf formart of 0x#### are converted into the Unicode a character
; hex values must be passed into constructor as a string
c := new MfChar("0x0045")
var := c.Value
MsgBox %var% ; displays E
; hex value is not in format of 0x#### and is treated like string
c := new MfChar("0x45")
var := c.Value
MsgBox %var% ; displays 0
; hex value in a MfString instance is be treated like a string
str := new MfString("0x0045")
c := new MfChar(str)
var := c.Value
MsgBox %var% ; displays 0
i := new MfInteger(89) ; create new MfInteger instance
; pass MfInteger into MfChar constructor. MfInteger are converted to charcode values
c := new MfChar(i)
var := c.Value
MsgBox %var% ; displays Y
; create a new instance of MfChar class and set it to read-only
c := new MfChar("F", , true)
var := c.Value
MsgBox %var% ; displays F
; trying to change the Value or Charcode of read-only MfChar results in an error
; the following displays The instance of MfChar is read-only and can not be modified in this way.
try
{
c.Value := "A"
}
catch e
{
MsgBox, 16, Error, % e.Message
}