PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
  • Left and UNICODE
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Extracts the left part (i.e., the first characters) from a string or buffer.
Versions 18 and later
Universal Windows 10 App This function is now available in Windows Store apps mode.
New in version 18
Universal Windows 10 App This function is now available in Windows Store apps mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
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"
WINDEVUniversal Windows 10 AppJavaUser code (UMC)
// 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 the details of the error, use ErrorInfo.
<Initial string>: Character string (with quotes)
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.
WINDEVUniversal Windows 10 AppJavaUser code (UMC)

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 <Size> is greater than the size of <Initial buffer>.
  • EOT if <Size> is negative. A WLanguage error occurs (non-fatal error). To find out the error details, use ErrorInfo.
  • Invalid buffer if <Initial buffer> contains a UNICODE string.
<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 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 bytes of memory. Therefore, the memory footprint of a UNICODE string is twice the number of characters actually contained in the string.
The fist character in the string is at index 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 UNICODE for more details.
Component: wd260vm.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment