Right (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Standard functions / String functions

Right and UNICODE

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Right (Function)

In french: Droite

Extracts the last characters from a string or string buffer.

In this version, the last characters of a buffer string cannot be extracted.

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 bytes
MyBuffer is Buffer = "Antananarivo - Madagascar"
Right(MyBuffer, 10)  // Returns "Madagascar"

Syntax

Extracting the last characters from a string Hide the details

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

<Result>: Character string

Last characters of <Initial string>. Corresponds to <Initial string> if <Length> is greater than the length of <Initial string>.
EOT if <Length> is negative. A WLanguage error occurs (non-fatal error). To get more details on the error, use ErrorInfo.

<Initial string>: Character string

String from which the last characters will be extracted. This string is not modified.

<Length>: Optional integer

Number of characters to extract. If this parameter is not specified, <Result> corresponds to <Initial string> without leading spaces.

Extracting the last characters of a string buffer Hide the details

<Result> = Right(<Initial buffer> [, <Length>])

<Result>: Buffer

Last characters of <Initial buffer>. Corresponds to <Initial buffer> if <Length> is greater than <Initial buffer>.
EOT if <Length> is negative. A WLanguage error occurs (non-fatal error). To get more details on the error, use ErrorInfo.
Invalid buffer if <Initial buffer> contains a UNICODE string.

<Initial buffer>: Buffer

Name of the string buffer from which the last characters will be extracted. This buffer is not modified.

<Length>: Optional integer

Number of bytes to extract. If this parameter is not specified, <Result> corresponds to <Initial buffer> without leading spaces.

Remarks

Right and UNICODE

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

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

Reminder: In UNICODE, each character uses two bytes.. Therefore, the memory size of UNICODE strings is twice the number of characters actually contained in the string.

The fist character in the string is at index 1.

Remark: If the function is used on an ANSI string and the result is assigned to a UNICODE string or vice versa, a conversion will be implicitly performed.

For more details, see Managing UNICODE.

Component: wd300vm.dll