> For the complete documentation index, see [llms.txt](https://cgps.gitbook.io/data-flo/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cgps.gitbook.io/data-flo/reference-guide/import-list-from-text-file.md).

# import-list-from-text-file

<mark style="color:purple;">`import-list-from-text-file`</mark> *adaptor imports a list from a text file*.

The character encoding can be changed using the encoding option in the adaptor, if unspecified defaults to utf8 encoding

## Inputs

**`file`**\
Type: `file`\
Required: Yes\
The text file to be converted.

**`encoding`**\
Type: `text`\
Required: No\
The character encoding of the output `text`. If unspecified, defaults to `utf8`.

**`separator`**\
Type: `text`\
Required: No\
Character used as a line separator. If unspecified, defaults to (newline).

**`trim`**\
Type: `boolean`\
Required: No\
Specifies whether to ignore whitespace characters immediately around the separator. If unspecified, defaults to `True`.

## Outputs

**`list`**\
Type: `list`\
A list of values.

## Examples

### Example 1: Default behaviour.

#### Inputs:

`file:` example.txt

```
January
February
March
April
```

`encoding:` *null (empty)*

`separator:` *null (empty)*

`trim:` *null (empty)*

#### Outputs:

`list`:

1. January
2. February
3. March
4. April

-> Imported a list from the text file `example.txt` into Data-flo.

### Example 2: Import list from text file with a `,` separator.

#### Inputs:

`file:` example.txt

```
January, February, March, April
```

`encoding:` *null (empty)*

`separator:` ,

`trim:` *null (empty)*

#### Outputs:

`list`:

1. January
2. February
3. March
4. April

-> Imported a comma separated list from the text file `example.txt` into Data-flo.