LTrim

Declare Function LTrim ( ByRef str As Const String, [ Any ] ByRef trimset As Const String = " " ) As String
Declare Function LTrim ( ByRef str As Const WString, [ Any ] ByRef trimset As Const WString = WStr(" ") ) As WString

result = LTrim[$]( str [, [ Any ] trimset ] )

str
trimset

Returns the trimmed string.

This procedure trims surrounding characters from the left (beginning) of a source string. Substrings matching trimset will be trimmed if specified, otherwise spaces (ASCII code 32) are trimmed.

If the Any keyword is used, any character matching a character in trimset will be trimmed.

All comparisons are case-sensitive.

Dim s1 As String = "  101 Things to do."
Print "'" + LTrim(s1) + "'"
Print "'" + LTrim(s1, " 01") + "'"
Print "'" + LTrim(s1, Any " 01") + "'"

Dim s2 As String = "BaaBaaBAA Test Pattern"
Print "'" + LTrim(s2, "Baa") + "'"
Print "'" + LTrim(s2, Any "BaA") + "'"

will produce the output:

'101 Things to do.'
'  101 Things to do.'
'Things to do.'
'BAA Test Pattern'
' Test Pattern'

• DOS version/target of FreeBASIC does not support the wide-character version of LTrim.
  
  

• The string type suffix "$" is obligatory in the -lang qb dialect.
  
• The string type suffix "$" is optional in the -lang fblite and -lang fb dialects.
  
  

• QB does not support specifying a trimset string or the ANY clause.
  
  

• RTrim
  
• Trim