LENGTH

構文

length::=

図length.epsの説明

目的

LENGTHの各ファンクションは、charの長さを戻します。LENGTHは、入力文字セットによって定義された文字を使用して、長さを算出します。LENGTHBは、文字のかわりにバイトを使用します。LENGTHCは、完全なUnicodeキャラクタを使用します。LENGTH2は、UCS2コードポイントを使用します。LENGTH4には、UCS4コード・ポイントを使用します。

charのデータ型は、CHAR、VARCHAR2、NCHAR、NVARCHAR2、CLOBまたはNCLOBです。例外は、LENGTHC、LENGTH2およびLENGTH4であり、これらでは、charをCLOBおよびNCLOBのいずれにもできません。戻り値のデータ型はNUMBERです。charのデータ型がCHARの場合、その長さにはすべての後続空白が含まれます。charがNULLの場合、このファンクションはNULLを戻します。

文字長の詳細は、次を参照してください。

• Oracle Databaseグローバリゼーション・サポート・ガイド

• Oracle Database SecureFilesおよびラージ・オブジェクト開発者ガイド

LENGTHBの制限事項

LENGTHBファンクションは、シングルバイトLOBのみでサポートされています。このファンクションは、マルチバイトの文字セットのCLOBとNCLOBデータでは使用できません。

例

次の例では、シングルバイトおよびマルチバイトのデータベース文字セットを使用するLENGTHファンクションを使用します。

SELECT LENGTH('CANDIDE') "Length in characters"
  FROM DUAL;

Length in characters
--------------------
                   7

次の例では、データベース文字セットがダブルバイトの場合を想定しています。

SELECT LENGTHB ('CANDIDE') "Length in bytes"
  FROM DUAL;
 
Length in bytes
---------------
             14