# LEFT()

Extract the leftmost substring of a character expression

Syntax

  LEFT( <cString>, <nLen> ) --> cReturn

Arguments

  <cString> Main character to be parsed
  <nLen> Number of bytes to return beggining at the leftmost position

Returns

  <cReturn> Substring of evaluation

Description

  This functions returns the leftmost <nLen> characters of <cString>. It is equivalent to the following expression: <fixed> SUBSTR( <cString>, 1, <nLen> ) </fixed>

Examples

          ? LEFT( 'HELLO HARBOUR', 5 )    // HELLO

Status

  Ready

Compliance

  This functions is CA CLIPPER compatible

Platforms

  All

Files

  Library is rtl

See Also

- SUBSTR()
- RIGHT()
- AT()
- RAT()