Descripción
Devuelve la longitud máxima del campo según se ha especificado al crear el campo utilizando Rational ClearQuest Designer. Este valor corresponde al número de bytes permitidos en la columna. El número real de caracteres permitidos depende de la codificación de la base de datos (es decir, el juego de caracteres y la codificación de juego de caracteres) y los caracteres de la serie del campo.
Este método sólo es relevante para los campos cuyo tipo es SHORT_STRING.
Sintaxis
VBScript
entity.GetFieldMaxLength field_name
Perl
$entity->GetFieldMaxLength(field_name);
- Identificador
- Descripción
- entity
- Un objeto Entity que representa un registro de datos de usuario.
En un enganche, si se omite esta parte de la sintaxis, se presupone el objeto Entity correspondiente al registro de datos actual (sólo VBScript).
- field_name
- Un valor String que identifica el nombre de campo válido de la entidad. El campo debe contener una serie de longitud fija.
- Valor de retorno
- Un valor Long que indica la longitud máxima del campo.
El valor es el número de bytes tal como se representa en la base de datos que puede almacenar el campo.
Nota: El número de bytes no es lo mismo que el número de caracteres. La página de códigos del proveedor determina el número exacto de bytes que se necesitan para representar una serie, y los caracteres determinados que se pueden almacenar en el campo. Caracteres diferentes pueden consumir números de bytes distintos, y el número de bytes que se necesitan para almacenar un carácter determinado depende de la página de códigos del proveedor de la base de datos.
Ejemplos
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");
}