VARBINARY

Click to skip syntax diagram
Read syntax diagramSkip visual syntax diagram>>-VARBINARY--(--string-expression--+------------+--)----------><
                                    '-,--integer-'
 

The VARBINARY function returns a VARBINARY representation of a string of any type.

The result of the function is VARBINARY. If the first argument can be null, the result can be null; if the first argument is null, the result is the null value.

string-expression
A string-expression whose value can be a character string, graphic string, binary string, or row ID.
integer
An integer constant that specifies the length attribute for the resulting binary string. The value must be between 1 and 32740 (32739 if nullable).

If integer is not specified:

The actual length of the result is the minimum of the length attribute of the result and the actual length of the expression (or twice the length of the expression when the input is graphic data). If the length of the string-expression is greater than the length attribute of the result, truncation is performed. A warning (SQLSTATE 01004) is returned unless the first input argument is a character string and all the truncated characters are blanks, or the first input argument is a graphic string and all the truncated characters are double-byte blanks, or the first input argument is a binary string and all the truncated bytes are hexadecimal zeroes.

Note

Syntax alternatives: When the length is specified, the CAST specification should be used for maximal portability. For more information, see CAST specification.

Example