# Decode text

## Description

This operation decodes text from a specified character encoding into UTF-8 format. It supports a wide range of character encodings including Unicode, Windows code pages, IBM/DOS code pages, EBCDIC, ISO-8859 series, and various Asian language encodings.

Use this operation when you need to convert text from legacy or platform-specific encodings to the universal UTF-8 format for processing or display.

***

## Data types

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

### Input data

![](/files/PLlLS9WDthpZu0nbKCNG) - Encoded text you want to decode.

### Output data

![](/files/FiO6hMIDNPuoHDSTAxHC) - Decoded text.

<details>

<summary>Supported encodings</summary>

#### Unicode

* UTF-8 (65001)
* UTF-16LE (1200)
* UTF-16BE (1201)

#### Windows Code Pages

* Windows-874 Thai (874)
* Windows-1250 Central European (1250)
* Windows-1251 Cyrillic (1251)
* Windows-1252 Latin (1252)
* Windows-1253 Greek (1253)
* Windows-1254 Turkish (1254)
* Windows-1255 Hebrew (1255)
* Windows-1256 Arabic (1256)
* Windows-1257 Baltic (1257)
* Windows-1258 Vietnam (1258)

#### IBM/OEM DOS Code Pages

* OEM United States (437)
* OEM Multilingual Latin 1; Western European (DOS) (850)
* OEM Latin 2; Central European (DOS) (852)
* OEM Cyrillic (primarily Russian) (855)
* OEM Multilingual Latin 1 + Euro symbol (858)
* OEM Portuguese; Portuguese (DOS) (860)
* OEM Hebrew; Hebrew (DOS) (862)
* OEM French Canadian; French Canadian (DOS) (863)
* OEM Nordic; Nordic (DOS) (865)
* OEM Russian; Cyrillic (DOS) (866)

#### EBCDIC

* IBM EBCDIC US-Canada (37)
* IBM EBCDIC Latin 1/Open System (1047)

#### ISO-8859 Series

* ISO-8859-1 through ISO-8859-16 (Latin and regional variants)

#### Asian Language Encodings

* Japanese: Shift-JIS (932), EUC Japanese (51932), ISO 2022 JIS variants
* Chinese: GBK (936), GB18030 (54936), HZ-GB2312 (52936), Big5 (950)
* Korean: Korean (949), EUC Korean (51949)

#### Cyrillic

* KOI8-R Russian Cyrillic (20866)
* KOI8-U Ukrainian Cyrillic (21866)

#### Macintosh

* MAC Roman (10000)
* Cyrillic (Mac) (10007)

</details>

***

## 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>Source Encoding<mark style="color:red;"><strong>*</strong></mark></summary>

Choose the encoding format of your input text. The default value is `UTF-8 (65001)`

</details>

***

## Example

Decoding Windows-1252 (Latin) text to UTF-8:

```
Input: "caf\xe9" (Windows-1252 encoded)
Encoding: Windows-1252 Latin (1252)
Output: "café" (UTF-8)
```


---

# 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/data-encoding/decode-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.