Sintaxis
LEFT( <expresión carácter>, <expresión numérica> )
Propósito
Extrae una parte de una cadena de caracteres.
Argumentos
<expresión carácter>
Define la cadena de caracteres de la cual se desea extraer una parte. Esta cadena podrá tener, como máximo, 64 Kbytes, es decir, 65.535 caracteres.
<expresión numérica>
Define el número de caracteres que se extraerá de la cadena de caracteres especificada, a partir del primer carácter. Es decir, define el tamaño de la parte que se extraerá.
Utilización
La función LEFT() permite extraer la primera parte (parte más a la izquierda) de una cadena de caracteres, con el número de caracteres especificado por la expresión numérica.
Si el resultado de la expresión numérica es menor o igual a cero, se suministrará una cadena de caracteres nula. En caso de que el resultado de la expresión numérica sea mayor que el tamaño total de la cadena de caracteres especificada, se suministrará toda la cadena de caracteres.
Sugerencias
Las funciones LEFT(), RIGHT() y SUBSTR() se vinculan, suministrando partes extraídas de una cadena de caracteres especificada. La función LEFT() suministra la parte de la izquierda, RIGHT() suministra la parte de la derecha y SUBSTR() suministra una parte intermedia. Estas funciones acostumbra utilizarse con las funciones AT() y RAT(), que ubican la posición de las partes que se extraerán.
Por medio de estas funciones puede manejarse cualquier cadena de caracteres con un máximo de 64 Kbytes de tamaño (65.535 posiciones).
Ejemplos
MsgAlert( LEFT("AdvPL", 4) ) // Suministra “AdvP”
Este ejemplo extrae un fragmento a partir del inicio de un string hasta la primera ocurrencia de una coma:
LOCAL cName := "James, William"
MsgAlert( LEFT(cName, AT(",", cName) - 1) ) // Resulta: James