# String functions

Name	Description	Complexity
contains(String, String): Boolean	Checks whether the string contains substring	3
drop(String, Int): String	Returns a given string without the first `N` characters	20
dropRight(String, Int): String	Returns a given string without the last `N` characters	20
indexOf(String, String): Int\|Unit	Returns the index of the first occurrence of a substring	3
indexOf(String, String, Int): Int\|Unit	Returns the index of the first occurrence of a substring after a certain index	3
lastIndexOf(String, String): Int\|Unit	Returns the index of the last occurrence of a substring	3
lastindexOf(String, String, Int): Int\|Unit	Returns the index of the last occurrence of a substring before a certain index	3
makeString(List[String], String): String	Range of functions. Concatenate list strings adding a separator	1–11
size(String): Int	Returns the size of a string	1
split(String, String): List[String]	Range of functions. Split a string delimited by a separator into a list of substrings	1–51
take(String, Int): String	Takes the first `N` characters from a string	20
takeRight(String, Int): String	Takes the last `N` characters from a string	20

# contains(String, String): Boolean

Checks whether the string contains substring.

contains(haystack: String, needle: String): Boolean

# Parameters

Parameter	Description
`haystack`: String	String to search in
`needle`: String	String to search for

# Examples

"hello".contains("hell")    # Returns true
"hello".contains("world")   # Returns false

# drop(String, Int): String

Returns a given string without the first N characters.

drop(xs: String, number: Int): String

# Parameters

Parameter	Description
`xs`: String	String
`number`: Int	Number `N`. From 0 to 32,767

# Examples

drop("Apple", 0)     # Returns "Apple"
drop("Apple", 1)     # Returns "pple"
drop("Apple", 3)     # Returns "le"
drop("Apple", 5)     # Returns an empty string
drop("Apple", 15)    # Returns an empty string
drop("Apple", -10)   # Fails

# dropRight(String, Int): String

Returns a given string without the last N characters of a string.

dropRight(xs: String, number: Int): String

# Parameters

Parameter	Description
`xs`: String	String
`number`: Int	Number `N`. From 0 to 32,767

# Examples

dropRight("Apple", 0)    # Returns "Apple"
dropRight("Apple", 1)    # Returns "Appl"
dropRight("Apple", 3)    # Returns "Ap"
dropRight("Apple", 5)    # Returns an empty string
dropRight("Apple", 15)   # Returns an empty string
dropRight("Apple", -1)   # Fails

# indexOf(String, String): Int|Unit

Returns the index of the first occurrence of a substring.

indexOf(str: String, substr: String): Int|Unit

# Parameters

Parameter	Description
`str`: String	String
`substr`: String	Substring

# Examples

indexOf("Apple","ple")   # Returns 2
indexOf("Apple","le")    # Returns 3
indexOf("Apple","e")     # Returns 4

# indexOf(String, String, Int): Int|Unit

Returns the index of the first occurrence of a substring after a certain index.

indexOf(str: String, substr: String, offset: Int): Int|Unit

# Parameters

Parameter	Description
`str`: String	String
`substr`: String	Substring
`offset`: Int	Index

# Examples

indexOf("Apple","ple", 1)   # Returns 2
indexOf("Apple","le", 2)    # Returns 3
indexOf("Apple","e", 3)     # Returns 4
indexOf("Apple","p", 0)     # Returns 1
indexOf("Apple","p", 2)     # Returns 2
indexOf("Apple","p", 3)     # Returns unit

# lastIndexOf(String, String): Int|Unit

Returns the index of the last occurrence of a substring.

lastIndexOf(str: String, substr: String): Int|Unit

# Parameters

Parameter	Description
`str`: String	String
`substr`: String	Substring

# Examples

lastIndexOf("Apple","pp")   # Returns 1
lastIndexOf("Apple","p")    # Returns 2
lastIndexOf("Apple","s")    # Returns unit

# lastIndexOf(String, String, Int): Int|Unit

Returns the index of the last occurrence of a substring before a certain index.

lastIndexOf(str: String, substr: String, offset: Int): Int|Unit

# Parameters

Parameter	Description
`str`: String	String
`substr`: String	Substring
`offset`: Int	Index

# Examples

lastIndexOf("mamamama","ma",4) # Returns 4
lastIndexOf("mamamama","ma",3) # Returns 2

# makeString(List[String], String): String

Range of functions. Concatenate list strings adding a separator.

makeString(arr: List[String], separator: String): String
makeString_2C(arr: List[String], separator: String): String
makeString_11C(arr: List[String], separator: String): String

Name	Limitations	Complexity
makeString	Input list up to 70 elements; result up to 500 bytes	1
makeString_2C	Input list up to 100 elements; result up to 6000 bytes	2
makeString_11C	—	11

# Parameters

Parameter	Description
`arr`: List[String]	List of strings to concatenate
`separator`: String	Separator

# Example

makeString(["Apple","Orange","Mango"], " & ") # Returns "Apple & Orange & Mango"

# size(String): Int

Returns the size of a string.

size(xs: String): Int

# Parameters

Parameter	Description
`xs`: String	String

# Examples

size("Ap")      # Returns 2
size("Appl")    # Returns 4
size("Apple")   # Returns 5

# split(String, String): List[String]

Range of functions. Split a string delimited by a separator into a list of substrings.

split(str: String, separator: String): List[String]
split_4C(str: String, separator: String): List[String]
split_51C(str: String, separator: String): List[String]

Name	Limitations	Complexity
split	Input string up to 500 bytes; result up to 20 elements	1
split_4C	Input string up to 6000 bytes; result up to 100 elements	4
split_51C	—	51

# Parameters

Parameter	Description
`str`: String	String
`separator`: Int	Separator

# Examples

split("A.p.p.l.e", ".")    # Returns ["A", "p", "p", "l", "e"]
split("Apple", ".")        # Returns ["Apple"]
split("Apple", "")         # Returns ["A", "p", "p", "l", "e"]
split("Ap.ple", ".")       # Returns ["Ap","ple"]
split("Apple", "App")      # Returns ["", "le"]
split("Apple", "le")       # Returns ["App", ""]

# take(String, Int): String

Takes the first N characters from a string.

take(xs: String, number: Int): String

# Parameters

Parameter	Description
`xs`: String	String
`number`: Int	Number `N`. From 0 to 32,767

# Examples

take("Apple", 0)     # Returns an empty string
take("Apple", 1)     # Returns "A"
take("Apple", 3)     # Returns "App"
take("Apple", 5)     # Returns "Apple"
take("Apple", 15)    # Returns "Apple"
take("Apple", -10)   # Fails

# takeRight(String, Int): String

Takes the last n characters from a string.

takeRight(xs: String, number: Int): String

# Parameters

Parameter	Description
`xs`: String	String
`number`: Int	Number `N`. From 0 to 32,767

# Examples

takeRight("Apple", 0)     # Returns an empty string
takeRight("Apple", 1)     # Returns "e"
takeRight("Apple", 3)     # Returns "ple"
takeRight("Apple", 5)     # Returns "Apple"
takeRight("Apple", 15)    # Returns "Apple"
takeRight("Apple", -10)   # Fails