CutIfLong()
OutputVar := instance.CutIfLong(maxLen)
OutputVar := instance.CutIfLong(maxLen, trailChars)
Cuts a copy of this instance of MfString if it is longer than a given length and returns the result of the copy.
maxLen
The maximum length that the value of MfString is allowed to be before it is cut. Can be MfInteger or var containing Integer.
Cuts a copy of this instance of MfString if it is longer than a given length, replaces cut with the value of trailChars and returns the result of the copy.
maxLen
The maximum length that the value of MfString is allowed to be before it is cut. Can be MfInteger or var containing Integer.
TrailChars
The string to append to the value of MfString. To omit any TrailChars pass "" or Null in as the value. Can be MfString or var containing string.
Return string copy representing the MfString Instance cut with trailChars appended to the end if needed.
If ReturnAsObject Property for this instance is true then returns MfString otherwise returns var containing string.
Throws MfNullReferenceException is not set to an instance.
Throws MfArgumentNullException if missing maxLen.
Throws MfInvalidCastException if maxLen cannot be cast to MfInteger.
Throws MfArgumentOutOfRangeException if maxLen is less than one.
If the maxLen is less than the length of the trailChars then trailChars will not be included in the return value.
myStr := new MfString("Hello World") ; Create new instanc of MfString class
MsgBox % myStr.CutIfLong(10) ; Displays Hello W...
MsgBox % myStr.CutIfLong(10,"***") ; Displays Hello W***
MsgBox % myStr.CutIfLong(10, "") ; Displays Hello Worl
myStr.ReturnAsObject := true ; return object rather than vars from this instance
MsgBox % myStr.PadLeft(new MfParams(MfParams.I(14),MfParams.C("."))).CutIfLong(11).ToUpper().value ; displays ...HELLO...