# concatenate-text

## Description

<mark style="color:purple;">`concatenate-text`</mark> *adaptor concatenates two text strings.*

By default there is no separator between the concatenated texts, use the `separator` input to add a separator.

## Inputs

**`text one`**\
Type: `text`\
Required: Yes\
First text to be concatenated.

**`text two`**\
Type: `text`\
Required: Yes\
Second text to be concatenated.

**`separator`**\
Type: `text`\
Required: No\
Specifies text to separate the concatenated texts. If unspecified, defaults to no separator.

## Outputs

**`combination`**\
Type: `text`\
The concatenated text.

## Examples

### Example 1: Default behaviour.

#### Inputs:

`text one`: Hello

`text two`: World

#### Outputs:

`combination`: HelloWorld

-> concatenate the texts `Hello` and `World`.

### Example 2: Concatenation with a separator.

#### Inputs:

`text one`: Hello

`text two`: World

`separator`: (space)

#### Outputs:

`combination`: Hello World

-> concatenate the texts `Hello` and `World` with a space separator.

## Use Cases

* Concatenating text is often used to create more informative and descriptive labels or names
* Concatenation is employed to build complete sentences or phrases from individual text components
* Combining first names and last names into a single "full name" column or merging address components into a complete address string.
* When constructing URLs or file paths, concatenation is used to combine different components, such as domain names, paths, and filenames.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cgps.gitbook.io/data-flo/reference-guide/concatenate-text.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.