Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

roInt also contains the ifIntOps interface, which provides the following:

ToStr() As String

Returns the integer value as a string. A space is not appended to the front for positive numbers.

ifFloat

roFloat contains the ifFloat interface, which provides the following:

...

roString also contains the ifStringOps interface, which provides the following:

Note
titleNote

Some global functions offer the same functionality as ifStringOps methods. The function indexes of ifStringOps methods of ifStringOps methods start at zero, while the function indexes those of global methods functions start at one.

SetString(str As String, str_len As Integer)

Sets the a string using the specified string and string-length values. This is similar to the roString.SetString() method, which does not accept a parameter for string length.

AppendString(str As String, str_len As Integer)

Appends the to a string using the specified string and string-length values. This method modifies itself—this can cause unexpected results when you pass an intrinsic string type, rather than a string object.

Code Block
titleExample
x="string"
x.ifstringops.appendstring("ddd",3)
print x 'will print 'string' 
y=box("string")
y.ifstringops.appendstring("ddd",3)
print y 'will print 'stringddd'
Len() As Integer

Returns the number of characters in a string.

GetEntityEncode() As String

Returns the string with certain characters replaced with HTML entity encoding sequences:

Character
Replaced with
" (double quote)
"
' (single quote)
'
<
&lt;
>
&gt;
&
&amp;
Tokenize(delim As String) As Object

Splits a string into substrings using the specified delimiter character(s). The delim parameter can contain one or more characters to treat as delimiters. If the string object contains multiple contiguous delimiters, they will be treated as a single delimiter. This method returns the substrings as an roList object; the delimiters are not returned with the substrings.

Code Block
titleExample
BrightScript> s = "one&&two"
BrightScript> print s.Tokenize("&")
one
two
Trim() As String

Returns the string with any leading and trailing whitespace characters (e.g. TAB, LF, CR, VT, FF, NO-BREAK SPACE) removed.

ToInt() As Integer

Returns the value of the string as an integer number.

ToFloat() As Float

Returns the value of the string as a floating point number.

Left(

...

n As Integer) As String

Returns the first n characters of the string.

Right(

...

n As Integer) As String

Returns the last n characters of the string.

Mid(start_index As Integer) As String

Returns a subset of the string that begins at the zero-based start_index and terminates at the end of the string.

Mid(start_index As Integer,

...

n As Integer) As String

Returns a subset of the string, beginning at the zero-based start_index and consisting of n characters. If the string contains fewer than n characters after the specified start_index, this method will return all characters after the start_index.

Instr(substring As String) As Integer

Returns the zero-based index of the first occurence of the substring in the string. If the substring does not occur in the string, this method returns -1. 

Instr(start_index As Integer, substring As String) As Integer

Returns the zero-based index of the first occurence of the substring after the specified start_index in the string. If the substring does not occur after the specified start_index, this method returns -1.

 

...

 

Code Block
titleExample
BrightScript> o=CreateObject("roInt")
BrightScript> o.SetInt(555)
BrightScript> print o
555
BrightScript> print o.GetInt()
555
BrightScript> print o-55
500 

...