> For the complete documentation index, see [llms.txt](https://mariadb.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mariadb.com/docs/connectors/mariadb-connector-c/api-functions/mysql_hex_string.md).

# mysql\_hex\_string

## Syntax

```c
unsigned long mysql_hex_string(char * to,
                               const char * from,
                               unsigned long len);
```

## Parameters

* `to` - result buffer
* `from` - the string which will be encoded
* `len` - length of the string (from)

## Description

This function is used to create a hexadecimal string which can be used in SQL statements. e.g. `INSERT INTO my_blob VALUES(X'A0E1CD')`.

## Return Value

Returns the length of the encoded string without the trailing null character.

{% hint style="info" %}

* The size of the buffer for the encoded string must be 2 \* length + 1.
* The encoded string does not contain a leading X'.
  {% endhint %}

## See Also

* [mysql\_real\_escape\_string()](/docs/connectors/mariadb-connector-c/api-functions/mysql_real_escape_string.md)

{% @marketo/form formId="4316" %}