GetFieldMaxLength

説明

Rational ClearQuest Designer を使用してフィールドを作成するときに指定された、フィールドの最大長を戻します。この値は、列に許容されるバイト数に対応します。許容される実際の文字数は、データベース エンコード (つまり、文字セットと文字セット エンコード) とフィールド文字列内の文字によって異なります。

このメソッドは、タイプが SHORT_STRING のフィールドに対してのみ関係します。

構文

VBScript

entity.GetFieldMaxLength field_name 

Perl

$entity->GetFieldMaxLength(field_name); 
識別子
説明
entity
Entity オブジェクトは、ユーザー データ レコードを表します。構文のこの部分を省略すると、フック内では、現在のデータ レコードに対応する Entity オブジェクトが想定されます (VBScript のみ)。
field_name
Entity の有効なフィールド名を識別する String。このフィールドには、固定長の文字列が含まれている必要があります。
戻り値
フィールドの最大長を示す Long。値は、フィールドを格納できるデータベースに表されるバイト数です。
注: バイト数と文字数は同じではありません。文字列を表すために必要な正確なバイト数は、データベース製造元のコード ページ、およびフィールドに格納される個々の文字によって決定されます。文字が異なれば使用するバイト数が異なる場合があり、個々の文字を格納するのに必要なバイト数は、データベース製造元のコード ページによって異なります。

VBScript

' Check the maximum length of a string field. 
fieldType = GetFieldType("field1") 
If fieldType = AD_SHORT_STRING Then 
   maxLength = GetFieldMaxLength("field1") 
End If 

Perl

# Check the maximum length of a string field. 

$fieldtype = $entity->GetFieldType("field1");

if ($fieldtype eq $CQPerlExt::CQ_SHORT_STRING)

 {

 $maxlength = $entity->GetFieldMaxLength("field1");

 } 

フィードバック