# To binary

## Description

This operation converts a text string into its binary representation. Each character in the input string is converted to its binary equivalent based on the specified bit length (typically 8 bits per character). The resulting binary segments are joined using a configurable delimiter.

This operation is the inverse of the [From Binary](https://docs.onum.com/the-workspace/pipelines/actions/transformation/field-transformation/field-transformation-operations/encoding-decoding/from-binary) operation.

***

## Data types

These are the input/output expected data types for this operation:

### Input data

![](https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2F19RZEXRonymaymkWujGR%2Fimage.png?alt=media\&token=31a8bb81-bfd0-4011-bbdf-f7933a84b11d) - Plain text to be converted.

### Output data

![](https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2F19RZEXRonymaymkWujGR%2Fimage.png?alt=media\&token=31a8bb81-bfd0-4011-bbdf-f7933a84b11d) - Resulting binary strings.

***

## Parameters

These are the parameters you need to configure to use this operation (mandatory parameters are marked with a <mark style="color:red;">**\***</mark>):

<details>

<summary>Delimiter<mark style="color:red;"><strong>*</strong></mark></summary>

Specify the delimiter you want to use to separate the binary segments in the output strings. Choose between:

* **Space**
* **Comma**
* **Semi-colon**
* **Colon**
* **None**

</details>

<details>

<summary>Byte Length<mark style="color:red;"><strong>*</strong></mark></summary>

Enter the number of bits per binary segment in the input values. Typically, this value is set to `8` (standard ASCII encoding).

</details>

***

## Example

Suppose you want to **transform** a series of **plain texts** into their corresponding **binary strings**:

1. In your Pipeline, open the required [Action](https://onum.gitbook.io/onum-docs/the-workspace/pipelines/actions) configuration and select the input **Field**.
2. In the **Operation** field, choose **To Binary**.
3. Set **Delimiter** to `Comma`.
4. Set **Byte Length** to `8`.
5. Give your **Output field** a name and click **Save**. The values in your input field will be transformed. For example:

<pre><code><strong>Hello -> 01001000,01100101,01101100,01101100,01101111
</strong></code></pre>

{% hint style="info" %}
You can try out operations with specific values using the **Input** field above the operation. You can enter the value in the example above and check the result in the **Output** field.
{% endhint %}


---

# 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://docs.onum.com/the-workspace/pipelines/actions/transformation/field-transformation/field-transformation-operations/encoding-decoding/to-binary.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.