aboutsummaryrefslogtreecommitdiff
path: root/doc/language/function/cpsc-function-left.7.md
blob: 5bb5002193320020e09df23bfbb094b976528ebf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

% CPSC-FUNCTION-LEFT(7)

# NAME

cpsc-function-left - extract the beginning of a string

# SYNOPSIS

```text
LEFT(text : STRING, count : INTEGER) RETURNS STRING
```

# DESCRIPTION

Provided by the standard string library, loaded and linked by default.

Return up to count bytes from the beginning. Counts larger than the string length return the whole string; negative counts return an empty string.

# EXAMPLE

```text
OUTPUT LEFT("Hello", 2)
```

# SEE ALSO

[cpsc-language-overview(7)](../cpsc-language-overview.7.md), [cpsc-function-right(7)](cpsc-function-right.7.md), [cpsc-function-mid(7)](cpsc-function-mid.7.md).