SUBSTR( ) (Función)

Devuelve un número de caracteres específico de una expresión de caracteres o un campo memo.

SUBSTR(cExpression, nStartPosition [, nCharactersReturned])

Valores devueltos

Character

Parámetros

• cExpression
  Especifica la expresión de caracteres o el campo memo desde los que se devuelve la cadena de caracteres.

• nStartPosition
  Especifica la posición en la expresión de caracteres o en la cExpression del campo memo desde la que se devuelve la cadena de caracteres. El primer carácter de cExpression es la posición 1.

  Si TALK toma el valor SET ON y nStartPosition es mayor que el número de caracteres de cExpression, Visual FoxPro generará un mensaje de error. Si TALK toma el valor SET OFF, se devuelve la cadena vacía.

• nCharactersReturned
  Especifica el número de caracteres que se devuelve de cExpression. Si se omite nCharactersReturned, los caracteres se devolverán hasta llegar al final de la expresión de caracteres.

Observaciones

SUBSTR( ) devuelve una cadena de caracteres de una expresión de tipo Character o de un campo memo, a partir de la posición especificada en la expresión Character o el campo memo, y hasta el número especificado de caracteres.

Cuando utilice SUBSTR( ) con campos memo en un comando SELECT – SQL, incluya la función PADR( ) en SUBSTR( ) de modo que los campos memo vacíos o de longitud variable produzcan resultados coherentes cuando se conviertan a cadenas de caracteres.

SUBSTR( ) no devolverá ningún valor para un campo memo si se ejecuta en la ventana Depuración. Para devolver un valor en la ventana Depuración, incluya el nombre del campo memo en ALLTRIM( ) e incluya ALLTRIM( ) en SUBSTR( ).

Ejemplo

STORE 'abcdefghijklm' TO mystring
CLEAR
? SUBSTR(mystring, 1, 5)  && Displays abcde
? SUBSTR(mystring, 6)  && Displays fghijklm

Vea también

AT( ) | AT_C( ) | ATC( ) | ATCC( ) | ATCLINE( ) | ATLINE( ) | LEFT( ) | PADR( ) | RAT( ) | RATLINE( ) | RIGHT( ) | LEFTC( ) | RIGHTC( ) | SUBSTRC( ) | STRTRAN( ) | STUFF( )