RIGHT$

<< Click to Display Table of Contents >>

Navigation:  ThinBASIC Core Language > BuiltIn Functions > String functions >

RIGHT$

 

Description

 

Return the rightmost n bytes of a string.

 

Syntax

 

s = RIGHT$(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, RIGHT$ returns an empty string
 

if nBytes is negative, it is interpreted as:
(LEN(StringExpression) - ABS(nBytes))
 
For example:
RIGHT$("thinBasic", -4) '--returns "Basic"
 

if nBytes is negative but its absolute value is greater than or equal to the length of StringExpression, all of StringExpression is returned
 
For example:
RIGHT$("thinBasic", -10) '--returns "thinBasic"

 

Remarks

 

Restrictions

 

See also

 

String Handling, LEFT$, LEFTF$, MID$, RIGHTF$, RIGHTW$

 

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