This documentation was styled with a demo skin from the Premium Pack 4 add-on for Help & Manual. The contents of the skin are encrypted and not configurable. You can only publish HM projects with this skin. You cannot edit it or change it.
This version is copyright and may only be used for local testing purposes. It may not be distributed.
Please purchase the full version of the Premium Pack to get the configurable skins and remove this notice. The package will also include the Toolbox configuration utility for Premium Pack skins.
Description
Return the left-most n bytes of a string.
Syntax
s = LEFT$(StringExpression, nBytes)
Returns
String
Parameters
Name |
Type |
Optional |
Meaning |
StringExpression |
String |
No |
Original string from which portion will be extracted |
nBytes |
Numeric |
No |
Number of bytes to return
•if nBytes is greater than or equal to the length of StringExpression, all of StringExpression is returned •if nBytes is zero, LEFT$ returns an empty string •if nBytes is negative, it is interpreted as: •if nBytes is negative but its absolute value is greater than or equal to the length of StringExpression, all of StringExpression is returned |
Remarks
Restrictions
See also
String Handling, RIGHT$, MID$, LEFTW$
Examples
Thanks to Abraxas for the following script example
' Usage of the LEFT$ Keyword example
' Usage of the MID$ Keyword example
' Usage of the RIGHT$ Keyword example
Dim MyOLDString As String VALUE "HELLO WORLD"
Dim MyLEFTString As String
Dim MyMIDString As String
Dim MyRIGHTString As String
Dim sMsg As String
MyLEFTString = LEFT$ (MyOLDString, 4)
MyMIDString = MID$ (MyOLDString, 4, 2)
MyRIGHTString = RIGHT$(MyOLDString, 5)
sMsg += "Normal " & MyOLDString & $CRLF & $CRLF
sMsg += "LEFT$ " & MyLEFTString & $CRLF & $CRLF
sMsg += "MID$ " & MyMIDString & $CRLF & $CRLF
sMsg += "RIGHT$ " & MyRIGHTString & $CRLF & $CRLF
MSGBOX 0, sMsg
History
thinBasic Version |
Date |
Changes |
1.12.0 |
2024/07/02 |
Added help on how to use negative values in nBytes parameter |