# import-text-from-file

## Description

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

This adaptor imports the text file into Data-flo to make it available to other adaptors for processing. By default, the file is encoded using `utf-8` if no encoding is specified.

## Inputs

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

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

## Outputs

**`text`**\
Type: `text`\
The content of the text file.

## Examples

### Example 1: Default behaviour.

#### Inputs:

`file` : hello-world.txt

```
Hello World
```

`encoding` : *null (empty)*

#### Outputs:

`text`: Hello World

-> Imported text from `hello-world.txt` with the default `utf-8` encoding.

### Example 2: Import a text file with specified encoding.

#### Inputs:

`file` : hello-world.txt

```
Hello World
```

`encoding` : base64

#### Outputs:

`text`: SGVsbG8gV29ybGQ=

-> Imported text from `hello-world.txt` with `base64` encoding.