Ordinary Text Manipulation Functions

Obtaining Text Length

length-of-text 
	(text-expression: text)
	->	length: integer

length-of-text ("message") = 7

length-of-text ("") = 0

is-contained-in-text 
	(text-expression1: text, text-expression2:text)
	->	substring-exists: truth-value

is-contained-in-text ("your", "Your flight") = true

position-of-text 
	(text-expression1: text, text-expression2: text)
	-> start-position: integer

position-of-text ("fli", "Your flight") = 6

get-from-text 
	(text-expression: text, start-position: integer, end-position: integer) 
	->	substring: text)

get-from-text ("one two three", 5, 7) = "two"

insert-in-text 
	(text-expression1: text, text-expression2: text, insert-position: integer) 
	->	combined-text: text

insert-in-text ("not ", "do enter", 4) = "do not enter"

replace-in-text 
	(text-to-substitute: text, source-text: text, 
	 start-index: integer, end-index: integer) 
	-> 	modified-text: text

replace-in-text ("exit", "do not enter here", 8 , 12) 
-> "do not exit here"

omit-from-text 
	(text-expression: text, start-position: integer, end-position: integer)
	->	remaining-text: text

omit-from-text ("do not enter",4,7) = "do enter"

capitalize-words 
	(text-expression: text)
	-> 	capitalized-string: text

capitalize-words ("this is a test") = "This Is A Test"

upper-case-text 
	(text-expression: text)
	->	uppercased-text: text

upper-case-text ("123AbcDef") = "123ABCDEF"

lower-case-text 
	(text-expression: text) 
	->	lowercased-text: text

lower-case-text ("123AbcDef")="123abcdef"

text-begins-with-quantity 
	(text-expression: text)
	->	quantity-present: truth-value

text-begins-with-quantity ("123abc") = true

text-begins-with-quantity ("+456def") = true

text-begins-with-quantity ("abc123") = false