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( )