# StringToHex()

Converts each character in a string to its hexadecimal equivalent.

## Availability

<table>
  <tr>
    <td>Marketing Cloud Engagement</td>
    <td>✅ Yes</td>
  </tr>
  <tr>
    <td>Marketing Cloud Next</td>
    <td>✅ Yes</td>
  </tr>
</table>

## Syntax

```
StringToHex(sourceString, charSet)
```

The `StringToHex()` function has two parameters:

- `sourceString` (string): Required. The string to convert to hexadecimal character codes.
- `charSet` (string): The character set to use for encoding. Accepted values are `UTF-8` and `UTF-16`. The default value is `UTF-8`.

## Usage

To use the function, pass it a string to encode and optionally a character set for encoding.

```
%%[
  Var @sourceString, @hexStringUtf8, @hexStringUtf16
  Set @sourceString = "Hello world!"
  Set @hexStringUtf8 = StringToHex(@sourceString)
  Set @hexStringUtf16 = StringToHex(@sourceString, 'UTF-16')
]%%
<p>Source string: %%=v(@sourceString)=%%</p>
<p>UTF-8 hex string: %%=v(@hexStringUtf8)=%%</p>
<p>UTF-16 hex string: %%=v(@hexStringUtf16)=%%</p>
```

The example returns the source string, the UTF-8 hex string, and the UTF-16 hex string.

```
Source string: Hello world!
UTF-8 hex string: 48656c6c6f20776f726c6421
UTF-16 hex string: 480065006c006c006f00200077006f0072006c0064002100
```