String Functions


Functions

Function Val (str$ As String) As NumericType
Function Asc (str$ As String) As Integer
Function Len (ByRef str$ As String) As Integer
Function Strcomp (ByRef str1$ As String, ByRef str2$ As String) As Integer
Function Instr (ByRef str1$ As String, ByRef str2$ As String, ByVal startpos As Integer) As Integer
Function Left$ (ByRef str$ As String, ByVal length As Integer) As String
Function Right$ (ByRef str$ As String, ByVal length As Integer) As String
Function Mid$ (ByRef str$ As String, ByVal start As Integer, ByVal length As Integer) As String
Function LTrim$ (ByRef str$ As String) As String
Function RTrim$ (ByRef str$ As String) As String
Function Trim$ (ByRef str$ As String) As String
Function LCase$ (ByRef str$ As String) As String
Function UCase$ (ByRef str$ As String) As String
Function Space$ (ByVal count As Integer) As String
Function Hex$ (ByVal val As Integer) As String
Function Chr$ (ByVal val As Integer) As String

Function Documentation

Function Asc ( str$ As  String  ) 

Returns numeric (ASCII) value of the first character in the string.

Parameters:
[in] str$ string
Returns:
ASCII value of the first character or 0 if string is empty
Function        Asc(str$ As String) As Integer

Function Chr$ ( ByVal val As  Integer  ) 

Converts Integer ASCII value to string representation. If the value is < 0 or > 255 runtime error "Bad argument value" is issued.

Parameters:
[in] val 
Returns:
String representing ASCII character.
Function        Chr$(ByVal val As Integer) As String

Function Hex$ ( ByVal val As  Integer  ) 

Converts Integer value to HEXadecimal string representation

Parameters:
[in] val 
Returns:
destination string
Function        Hex$(ByVal val As Integer) As String

Function Instr ( ByRef str1$ As  String,
ByRef str2$ As  String,
ByVal startpos As  Integer 
)

Finds position of string str2 in string str1

Parameters:
[in] str1$ string
[in] str2$ string
[in] startpos integer, starting position in string str1
Returns:
Integer value indicating position of the string str2 in str1
Function        Instr(ByRef str1$ As String, ByRef str2$ As String, ByVal startpos As Integer) As Integer

Function LCase$ ( ByRef str$ As  String  ) 

Returns string converted to lower case

Parameters:
[in] str$ source string
Returns:
destination string
Function        LCase$(ByRef str$ As String) As String

Function Left$ ( ByRef str$ As  String,
ByVal length As  Integer 
)

Returns string from start up to the specified number of characters

Parameters:
[in] str$ source string
[in] length sequence length integer value
Returns:
destination string
Function        Left$(ByRef str$ As String, ByVal length As Integer) As String

Function Len ( ByRef str$ As  String  ) 

Returns length of the string

Parameters:
[in] str$ string
Returns:
Numeric value representing number of characters (length) in the string
Function        Len(ByRef str$ As String) As Integer

Function LTrim$ ( ByRef str$ As  String  ) 

Removes leading spaces from the string

Parameters:
[in] str$ source string
Returns:
destination string
Function        LTrim$(ByRef str$ As String) As String

Function Mid$ ( ByRef str$ As  String,
ByVal start As  Integer,
ByVal length As  Integer 
)

Returns string from start position up to the specified number of characters

Parameters:
[in] str$ source string
[in] start sequence start position integer value
[in] length sequence length integer value
Returns:
destination string
Function        Mid$(ByRef str$ As String, ByVal start As Integer, ByVal length As Integer) As String

Function Right$ ( ByRef str$ As  String,
ByVal length As  Integer 
)

Returns string from end up to the specified number of characters

Parameters:
[in] str$ source string
[in] length sequence length integer value
Returns:
destination string
Function        Right$(ByRef str$ As String, ByVal length As Integer) As String

Function RTrim$ ( ByRef str$ As  String  ) 

Removes trailing spaces from the string

Parameters:
[in] str$ source string
Returns:
destination string
Function        RTrim$(ByRef str$ As String) As String

Function Space$ ( ByVal count As  Integer  ) 

Fills string with spaces up to the count or string max length

Parameters:
[in] count 
Returns:
destination string
Function        Space$(ByVal count As Integer) As String

Function Strcomp ( ByRef str1$ As  String,
ByRef str2$ As  String 
)

Returns value indicating case insensitive comparison of two strings.

Parameters:
[in] str1$ string
[in] str2$ string
Returns:
Integer value indicating comparison of the strings str1 and str2
Return values:
-1 - str1 is less then str2
0 - str1 is same as str2
1 - str1 is greater then str2
Function        Strcomp(ByRef str1$ As String, ByRef str2$ As String) As Integer

Function Trim$ ( ByRef str$ As  String  ) 

Removes leading and trailing spaces from the string

Parameters:
[in] str$ source string
Returns:
destination string
Function        Trim$(ByRef str$ As String) As String

Function UCase$ ( ByRef str$ As  String  ) 

Returns string converted to upper case

Parameters:
[in] str$ source string
Returns:
destination string
Function        UCase$(ByRef str$ As String) As String

Function Val ( str$ As  String  ) 

Converts string to the numeric value. Stops at the first character that can not be recognized

Parameters:
[in] str$ string representing numeric value
Returns:
Numeric value representing string, 0 if conversion has failed
Function        Val(str$ As String) As NumericType

Footer