Left (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

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

Left and UNICODE

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Left (Function)

In french: Gauche

Extracts the left part (i.e., the first characters) from a string or buffer.

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

Example

Left("The cuckoo", 6)   // Returns "The cu"
Left("ABC", 50)        // Returns "ABC"
Left("AZELMA ")        // Returns "AZELMA"

MyString is string = "Developing is child's play"
Left(MyString, 10)   // Returns "Developing"

// Extract bytes
MyBuffer is Buffer = "Developing is child's play"
Left(MyBuffer, 10)   // Returns "Developing"

Syntax

Extracting the left part of a character string Hide the details

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

<Result>: Character string

Left part 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

Character string from which the left part 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 trailing spaces.

Extracting the left part of a buffer Hide the details

<Result> = Left(<Initial buffer> [, <Size>])

<Result>: Character string

Left part of <Initial buffer>. Corresponds to <Initial buffer> if <Length> is greater than <Initial buffer>.
EOT if <Size> is negative. A WLanguage error occurs (non-fatal error). To get more details on the error, use ErrorInfo.
Buffer invalid if <Buffer initial> contains a string in Unicode format.

<Initial buffer>: Buffer

Buffer from which the left 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 <Initial buffer> without trailing spaces.

Remarks

Left and UNICODE

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

If the string passed in parameter is in Unicode format, the result will be in Unicode format.

Reminder In Unicode, each character occupies two bytes of memory. The memory size of a Unicode string is therefore twice the number of characters actually contained in the string.

The fist character in the string is at index 1.

Note If the result on an ANSI string is assigned to a Unicode string (and vice versa), the conversion will be implicitly performed.

For more details, see Unicode management.

Component: wd300vm.dll