Descrizione
Restituisce la lunghezza massima del campo specificata al momento della creazione del 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 codepage 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 codepage 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");
}