VARBINARY

VARBINARY 函数返回任何类型的字符串的变长二进制字符串表示。

读取语法图跳过可视语法图VARBINARY (string-表达式,整数)

此函数的结果为 VARBINARY。 如果第一个自变量可以为空,那么结果可以为空; 如果第一个自变量为空,那么结果为空值。

字符串表达式
string-expression ,其值可以是字符串,图形字符串,二进制字符串或行标识。
整数
一个整数常量, 指定生成的二进制字符串的长度属性。 该值必须介于 1 与 32740 之间 (如果可空则为 32739)。

如果未指定 integer :

  • 如果 string-expression 是空字符串常量,那么结果的长度属性为 1。
  • 否则,除非自变量是图形字符串,否则结果的长度属性与第一个自变量的长度属性相同。 在这种情况下,结果的长度属性是自变量的长度属性的两倍。

结果的实际长度是结果的长度属性的最小值和表达式的实际长度 (或者输入为图形数据时表达式的长度的两倍)。 如果 string-expression 的长度大于结果的长度属性,那么将执行截断。 除非第一个输入参数是字符串并且所有截断的字符都是空格,或者第一个输入参数是图形字符串并且所有截断的字符都是双字节空格,或者第一个输入参数是二进制字符串并且所有截断的字节都是十六进制零,否则将返回警告 (SQLSTATE 01004)。

语法替代方法: 应使用 CAST 规范来提高指定长度时应用程序的可移植性。 有关更多信息,请参阅 CAST 规范

示例

  • 以下函数返回字符串 "This is a VARBINARY" 的 VARBINARY。
      SELECT VARBINARY('This is a VARBINARY')
        FROM SYSIBM.SYSDUMMY1