BINARY

BINARY 函數會傳回任何字串類型的 BINARY 表示法。

讀取語法圖跳過視覺化語法圖BINARY (字串表示式,整數)

函數的結果為固定長度的二進位字串。 若第一個引數可能為空值,結果就可能為空值;若第一個引數是空值,結果就是空值。

字串表示式
string-expression ,其值必須是內建字串、圖形字串、二進位字串或列 ID 資料類型。
整數
整數常數,其中 指定產生的二進位字串的長度屬性。 值必須介於 1 和 32766 之間。

如果未指定 integer :

  • 如果 string-expression 是空字串常數,則結果的長度屬性為 1。
  • 否則,結果的長度屬性與第一個引數的長度屬性相同,除非引數是圖形字串。 在此情況下,結果的長度屬性為引數長度屬性的兩倍。

實際的長度同於結果的長度屬性。 如果 string-expression 的長度小於結果的長度,則會以十六進位零填補結果,直到結果的長度為止。 如果 string-expression 的長度大於結果的 length 屬性,則會執行截斷。 除非第一個輸入引數是字串且所有截斷的字元都是空白,或第一個輸入引數是圖形字串且所有截斷的字元都是雙位元組空白,或第一個輸入引數是二進位字串且所有截斷的位元組都是十六進位零,否則會傳回警告 (SQLSTATE 01004)。

附註

替代語法: 當指定長度時,應使用 CAST 規格來增加應用程式的可攜性。 如需相關資訊,請參閱 CAST 規格

範例

  • 下列函數會針對字串 'This is a BINARY' 傳回 BINARY。
      SELECT BINARY('This is a BINARY')
        FROM SYSIBM.SYSDUMMY1