Descrizione
Restituisce la
lunghezza massima del campo come specificato quando si crea il campo utilizzando Rational ClearQuest Designer. Questo valore
corrisponde al numero di byte consentiti nella colonna. Il numero effettivo di caratteri consentiti dipende dalla
codifica del database (ovvero, la serie di caratteri e la codifica della serie di caratteri)
e dai caratteri nella stringa del campo.
Questo metodo è relativo solo ai
campi di tipo SHORT_STRING.
Sintassi
VBScript
entity.GetFieldMaxLength field_name
Perl
$entity->GetFieldMaxLength(field_name);
- Identificativo
- Descrizione
- entity
- Un oggetto Entity che rappresenta un record di dati dell'utente. All'interno di
un hook, se si omette questa parte della sintassi, viene utilizzato l'oggetto Entity corrispondente al record di dati
corrente (solo VBScript).
- field_name
- Una stringa che identifica un nome del campo valido dell'entità.
Il campo deve contenere una stringa di lunghezza fissa.
- Valore di ritorno
- Un valore Long che indica la lunghezza massima del campo. Il valore è il numero di
byte come rappresentato nel database che può essere memorizzato dal campo.
Nota: il numero di
byte non è uguale al numero di caratteri. Il numero esatto di
byte necessario per rappresentare una stringa viene determinato dalla code page del fornitore
di database e dai caratteri specifici memorizzati nel campo. In base ai caratteri vengono utilizzati
numeri di byte differenti e il numero di byte richiesti per memorizzare un carattere
specifico dipende dalla code page del fornitore di database.
Esempi
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");
}