# left

## Description

Extract a specified number of characters from the left side of a text.

## Input / Parameter

| Name             | Description                                                                                  | Input Type  | Default | Options | Required |
| ---------------- | -------------------------------------------------------------------------------------------- | ----------- | ------- | ------- | -------- |
| string           | The value where the extraction would happen.                                                 | String/Text | -       | -       | Yes      |
| length           | The number of characters to extract.                                                         | Number      | 0       | -       | Yes      |
| byLanguageFormat | To follow the language format. Usually this matters for languages that doesn't use alphabet. | Boolean     | false   | -       | No       |

## Output

| Description                 | Output Type |
| --------------------------- | ----------- |
| Returns the extracted text. | String/Text |

## Callback

N/A

## Video

Coming soon.

## Example

The user wants to display a specified number of characters from the left hand side of a string.

### Step

1. Call the function `console`. Call the function `left` inside the `value` parameter of the `console` function.\
   string: 123456789\
   length : 6<br>

   ![](https://399701567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwmJ1RKjM2uNFaL6fO3Xu%2Fuploads%2Fgit-blob-b10aaf36ba7a9c6c3759a9d714a353fbd9e7662e%2Fleft-step-1.png?alt=media)

   ![](https://399701567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwmJ1RKjM2uNFaL6fO3Xu%2Fuploads%2Fgit-blob-5bc9767a32ce69f7ed487170820654babd4e0971%2Fleft-step-2.png?alt=media)

### Result

![](https://399701567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwmJ1RKjM2uNFaL6fO3Xu%2Fuploads%2Fgit-blob-bdd4a90ea7218555953590749a6b08e6112f1cb4%2Fleft-result-1.png?alt=media)

## Links