# VerifyString

La función VerifyString se utiliza para verificar la cadena y generar una salida de pase/fallo.

## Entradas de VerifyString

Parámetro | Descripción
String | Especifica una cadena de texto o una referencia a una celda de la hoja de cálculo que contiene una cadena de texto.
Cadena de campo | Especifica el número de caracteres que contiene la cadena de caracteres y proporciona información sobre cuáles son los caracteres que se esperan en las distintas posiciones de la cadena.
Definiciones de campo | El parámetro de ajuste «Definiciones de campo» permite crear opcionalmente entradas definidas por el usuario para «Cadena de campo». Si se incluyen estas entradas en el parámetro «Cadena de campo», restringen la lista de caracteres válidos para las posiciones en las que se han insertado.

### Cadena de campo

En «Cadena de campo» puede entrarse cualquier carácter alfanumérico, incluidos (A - Z), (a - z), (0 - 9), guiones (-), puntos (.) y espacios en blanco ( ).

Cada carácter en «Cadena de campo» corresponde a una posición de campo indexada. «Cadena de campo» debe contener por lo menos tantas posiciones como caracteres hay en la cadena para que sea considerada como pase en la verificación de cadenas (es decir, si hay 10 caracteres, pero en «Cadena de campo» se especifican únicamente 9 caracteres, se devolverán los 9 que mejor coinciden. Sin embargo, si hay 8 caracteres y «Cadena de campo» define 9 caracteres, la función dará #ERR). De forma predeterminada, cada posición en «Cadena de campo» se representa con un carácter de asterisco (*) o «comodín» alfanumérico. Esto significa que cualquier carácter es válido en cualquier posición de la cadena.

La entradas predefinidas para «Cadena de campo» son:

Entrada en «Cadena de campo» | Descripción | Caracteres válidos
* | Comodín | Cualquier carácter entrenado en la fuente.
N | Numérico | 0123456789
A | Alfabético en mayúscula | ABCDEFGHIJKLMNOPQRSTUVWXYZ
a | Alfabético en minúscula | abcdefghijklmnopqrstuvwxyz
H | Hexadecimal, alfabético en mayúscula y numérico | 0123456789ABCDEF
h | Hexadecimal, alfabético en minúscula y numérico | 0123456789abcdef
O | Octal | 01234567

Ejemplos de «Cadena de campo»:

- Ejemplo 1: Si «Cadena de campo» es **********AN, cualquier carácter de la fuente será válido en las primeras 10 posiciones de «Cadena de campo». Pero en la 11ª posición, se considerarán en la verificación únicamente caracteres alfabéticos en mayúsculas. En la 12ª posición se considerarán únicamente caracteres numéricos.

- Ejemplo 2: La fuente contiene únicamente los caracteres numéricos 0-9 y /. Si «Cadena de campo» es NN/NN/NN, se considerarán únicamente caracteres numéricos en las posiciones primera y segunda, cuarta y quinta, séptima y octava. En las posiciones tercera y sexta, se considerará únicamente la barra inclinada hacia la derecha (/).

  Pero si «Cadena de campo» especifica NN/NN/AA, la verificación de cadenas dará #ERR debido a que la fuente especificada no contiene caracteres alfanuméricos.

### Definiciones de campo

El parámetro de ajuste «Definiciones de campo» permite crear opcionalmente entradas definidas por el usuario para «Cadena de campo». Si se incluyen estas entradas en el parámetro «Cadena de campo», restringen la lista de caracteres válidos para las posiciones en las que se han insertado.

Puede sobrescribir las definiciones predefinidas agregando una nueva definición a este campo. Por ejemplo, si el valor de definición de campo es A = A, entonces se considerará únicamente el carácter A como válido, ya que la definición de campo A = A sobrescribe la entrada predefinida de «Cadena de campo».

Ejemplos con «Definiciones de campo»

- Ejemplo 1: Si el valor de «Definiciones de campo» es #=123;$=3456;%=789 y el de «Cadena de campo» es #$%*******, entonces los únicos caracteres que son válidos en la primera posición son 1, 2 o 3. Los únicos caracteres válidos en la segunda posición son 3, 4, 5 o 6. Y en la tercera posición, solo son válidos 7, 8 o 9. En las posiciones cuarta a décima, cualquier carácter de la fuente es válido.
- Ejemplo 2: Si el valor de «Definiciones de campo» es #=123;$=3456;%=789, A=A y el de «Cadena de campo» es #$%******A, entonces los únicos caracteres que son válidos en la primera posición son 1, 2 o 3. Los únicos caracteres válidos en la segunda posición son 3, 4, 5 o 6. Y en la tercera posición, solo son válidos 7, 8 o 9. En las posiciones cuarta a novena, cualquier carácter de la fuente es válido. En la décima posición se admitirá únicamente el carácter A, ya que la definición de campo A=A reasigna la entrada predefinida de «Cadena de campo».

## Salidas de VerifyString

Devuelve | El estado de pase/fallo de la cadena en la estructura de datos Text referenciada, o #ERR si alguno de los parámetros de entrada no es válido. 0 = Fallo 1 = Pase