SUB
sub( string, first, [last] )
string | the string that you want to convert into a table |
first | the number of characters from the beginning of the string to start pulling as the substring. *If not given, the full string is returned. |
last | (optional) the number of characters from the beginning of the string to stop pulling as the substring. (default: full length of string) |
The sub( string ) function is used to separate a part of a string into a smaller string. The first character of the string is 1.
For example, if we call sub("hello world")
, the function will return a character or string from within the full given string.
string = "hello world"
print( sub( string,1 ) ) --"hello world"
print( sub( string,2 ) ) --"ello world"
print( sub( string,4,8 ) ) --"lo wo"
print( sub( string,7,7 ) ) --"w"
It is also possible to use negative numbers as the first and last arguments. This will count backwards from the end of the string. The last character in the string is -1
. However, the substring will only return letters after first, so if you try to get characters from -3 to -6, you must order it from left to right (-6, -3)
.
string = "hello world"
print( sub( string,-1 ) ) --"d"
print( sub( string,-3,-6 ) ) --"" (empty string)
print( sub( string,-5,-1 ) ) --"world"
Common Uses
The most common usage of the function sub()
is to create a text appearance animation as if it is being typed out one character at a time. Example:
string = "hello world"
first = 1
last = 1
function _draw()
cls()
last+=.5
print( sub(string,first,last) )
end
Another way to reveal text is to use the clip()
function. See the tutorial Text Wipe for a detailed example.
392
6 Dec 2023