Right (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Functions for managing strings

Different operating mode in GO mode and at runtime

See also

Right (Function)

In french: Droite

Extracts the right part (which means the last characters) from a character string or from a buffer.

In this version, the right part of a buffer cannot be extracted.

Versions 15 and later

This function is now available for Android applications.

New in version 15

This function is now available for Android applications.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 18 and later

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

Versions 21 and later

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

Example

// Extract characters
Right("The cuckoo", 6) // Returns "cuckoo"
Right("ABC", 50) // Returns "ABC"
Right(" AZELMA") // Returns "AZELMA"

MyString is string = "Antananarivo - Madagascar"
Right(MyString, 10) // Returns "Madagascar"

// Extract the bytes
MyBuffer is Buffer = "Antananarivo - Madagascar"
Right(MyBuffer, 10) // Returns "Madagascar"

Syntax

Extracting the right part from a character string Hide the details

<Result> = Right(<Source string> [, <Length>])

<Result>: Character string

Right part of <Source string>. Corresponds to <Source string> if <Length> is greater than the length of <Source string>.
EOT if <Length> is negative. A WLanguage error occurs (non-fatal error). To get the details of the error, use ErrorInfo.

<Source string>: Character string (with quotes)

Character string whose right part must be extracted. This string is not modified.

<Length>: Optional integer

Number of characters to extract. If this parameter is not specified, <Result> corresponds to <Source string> without the space characters on the left.

Extracting the right part from a buffer Hide the details

<Result> = Right(<Source buffer> [, <Size>])

<Result>: Buffer

Right part of <Source buffer>. Corresponds to <Source buffer> if <Size> is greater than the size of <Source buffer>.
EOT if <Size> is negative. A WLanguage error occurs (non-fatal error). To get the details of the error, use ErrorInfo.
Invalid buffer if <Source buffer> contains a character string in UNICODE format.
Invalid buffer if <Source buffer> contains a character string in ANSI format.

<Source buffer>: Buffer

Name of buffer whose right part will be extracted. This buffer is not modified.

<Size>: Optional integer

Number of bytes to extract. If this parameter is not specified, <Result> corresponds to <Source buffer> without the space characters on the left.
In UNICODE, each character occupies two memory bytes. Therefore, the number of bytes is twice the number of characters.

Remarks

Right and UNICODE

If the string passed as a parameter is in ANSI format, the result will be in ANSI format.

If the string passed as a parameter is in UNICODE format, the result will be in UNICODE format.

Reminder: In UNICODE, each character occupies two memory bytes. Therefore, the memory footprint of a UNICODE string is twice the number of characters actually found in the string.

In UNICODE, the subscript of the first character in the string is set to 1.

Remark: If the result on an ANSI string is assigned to a UNICODE string (and conversely), the conversion will be implicitly performed.

See Managing the UNICODE format for more details.

Different operating mode in GO mode and at runtime

In GO mode (simulation on the development computer), when extracting the right part of a buffer (syntax 2), <Size> corresponds to the number of characters to extract and not the number of bytes.

For example, running the following code:

MyBuffer is Buffer = "WINDEV is tremendous"

Right(MyBuffer, 10)

in GO mode, returns "tremendous".
in real use, returns "ndous".

The differences between GO mode (simulator) and real use are presented in Differences between GO mode and real use.

Component : wd250vm.dll