# sqlite_udf_encode_binary

(PHP 5, PECL sqlite:1.0-1.0.3)

sqlite_udf_encode_binary — Encode binary data before returning it from an UDF

### Description

string sqlite_udf_encode_binary ( string `$data` )

sqlite_udf_encode_binary() applies a binary encoding to the `data` so that it can be safely returned from queries (since the underlying libsqlite API is not binary safe).

If there is a chance that your data might be binary unsafe (e.g.: it contains a NUL byte in the middle rather than at the end, or if it has and 0x01 byte as the first character) then you must call this function to encode the return value from your UDF.

PHP does not perform this encode/decode operation automatically as it would severely impact performance if it did.

> Note: Do not use sqlite_escape_string() to quote strings returned from UDF's as it will lead to double-quoting of the data. Use sqlite_udf_encode_binary() instead!

### See Also

- sqlite_udf_decode_binary()
- sqlite_escape_string()
- sqlite_create_function()
- sqlite_create_aggregate()