Share via


SUBSTRC( ) (Función)

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

SUBSTRC(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 está establecido en ON y nStartPosition es mayor que el número de caracteres de cExpression, Visual FoxPro genera un mensaje de error. Si TALK está establecido en OFF, se devolverá una 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

SUBSTRC( ) se ha diseñado para expresiones que contengan caracteres de dos bytes. Si la expresión contiene sólo caracteres de un byte, SUBSTRC( ) es igual a SUBSTR( ).

SUBSTRC( ) devuelve una cadena de caracteres a partir de la expresión de caracteres o del campo memo especificados. La expresión de caracteres o el campo memo pueden contener cualquier combinación de caracteres de uno y de dos bytes.

SUBSTRC( ) no devolverá un valor para un campo memo si se ejecuta en la ventana Depuración. Si desea que se devuelva un valor en la ventana Depuración, coloque el nombre del campo memo en ALLTRIM( ) y coloque ALLTRIM( ) en SUBSTRC( ).

Esta función es útil para manipular juegos de caracteres de dos bytes para idiomas como Hiragana y Katakana.

Vea también

AT( ) | AT_C( ) | ATC( ) | ATCC( ) | ATCLINE( ) | ATLINE( ) | LEFT( ) | RAT( ) | RATLINE( ) | RIGHT( ) | LEFTC( ) | RIGHTC( ) | SUBSTR( ) | STRTRAN( ) | STUFFC( )