Funciones de texto

Las funciones de texto se encuentran disponibles en el menú Función de texto. Operan en propiedades de texto y resultan útiles para asignar formato a los resultados de las consultas relacionadas con texto. Estas funciones están disponibles para todos los proveedores de datos excepto para proveedores ráster, WFS y WMS.

Al crear expresiones para elementos geoespaciales, se pueden utilizar las siguientes funciones de texto:

Función	Definición	Sintaxis	Ejemplo
CONCAT	Une dos cadenas en una. CONCAT toma un número determinado de argumentos, que pueden ser cualquier tipo de propiedad salvo geometría o ráster. El valor devuelto utiliza el tipo de datos String. Utilice ‘\n’ para insertar un salto de línea cuando se utilicen estilos normalizados. Utilice '\P' para insertar un salto de línea cuando se utilicen estilos mejorados. Estos parámetros distinguen entre mayúsculas y minúsculas. Para incluir etiquetas de texto estático o espacios, debe escribirlos entre comillas simples. Cuando utilice Concat con una propiedad booleana, la operación generará 1/0 (no verdadero/falso) como resultado.	CONCAT(Property, Property, ...)	CONCAT(First_Name, ‘ ‘Last_Name,’\P’ ‘Address: ‘, Street_number, ‘ ‘, Street_name, ‘ ‘, Suffix) Este ejemplo tiene como resultado una etiqueta con este aspecto: John Smith Dirección: 123 Maple Street
INSTR	Localiza la posición de la primera vez que aparece una subcadena en otra cadena. Especifique la cadena de origen como primer argumento y la cadena que está buscando como segundo argumento. Devuelve un número entero con el tipo de datos Int64.	INSTR(propiedad de texto o valor, propiedad texto o valor)	INSTR(Propiedad_Parcela,'campo) Este ejemplo busca la subcadena “campo” dentro de la cadena del propietario de la parcela. Si el nombre del propietario de la parcela es Smithfield, el valor devuelto es 6.
LENGTH	Devuelve el número de caracteres de la cadena especificada como un número entero con el tipo de datos Int64. No incluye caracteres en blanco al final.	LENGTH(Propiedad_Texto)	LENGTH(Nombre) Este ejemplo determina el número de caracteres de la propiedad Nombre.
LOWER	Cambia el texto a todo minúsculas. El valor devuelto utiliza el tipo de datos String.	LOWER(Propiedad_Texto)	LOWER(Nombre_Producto) Este ejemplo cambia una entrada de nombre de producto a minúsculas (por ejemplo, PIPE COMPOUND a pipe compound).
LPAD	Rellena la parte izquierda de una cadena con los caracteres especificados. El valor devuelto utiliza el tipo de datos String. LPAD puede tomar entre dos y tres parámetros. Si no especifica el argumento del carácter de texto, se usará un carácter de espacio.	LPAD(Propiedad_Texto, Número de caracteres,'carácter de texto')	LPAD(Prioridad_Alta,3,'*') Este ejemplo muestra un valor para la propiedad Prioridad_Alta (por ejemplo, “Reparación emergencia”) precedida por ***.
LTRIM	Recorta caracteres de una cadena de texto comenzando por la izquierda. El valor devuelto utiliza el tipo de datos String.	LTRIM(Propiedad_Texto)	LTRIM(ID_Parcela) Este ejemplo elimina los caracteres iniciales de los identificadores de parcela.
RPAD	Rellena la parte derecha de una cadena con los caracteres especificados. El valor devuelto utiliza el tipo de datos String. RPAD puede tomar entre dos y tres parámetros. Si no especifica el argumento del carácter de texto, se usará un carácter de espacio.	RPAD(Propiedad_Texto, Número de caracteres,'carácter de texto')	RPAD(Reparación_Costosa,3,$) Este ejemplo muestra un valor para la propiedad Reparación_Costosa (por ejemplo, “Rediseño completo”) seguido de $$$.
RTRIM	Recorta caracteres de una cadena de texto comenzando por la derecha (caracteres finales). El valor devuelto utiliza el tipo de datos String. Para eliminar los caracteres iniciales, utilice TRIM. Véase TRIM.	RTRIM(Propiedad_Texto)	RTRIM(ID_Parcela) Este ejemplo elimina los caracteres que siguen a los identificadores de parcela.
SOUNDEX	Devuelve nombres que, en inglés, suenan de manera similar a la cadena de texto especificada. El valor devuelto utiliza el tipo de datos String. El SGBDR subyacente evalúa las expresiones que incluyen la función SOUNDEX. No obstante, el resultado que devuelve un proveedor MySQL puede diferir del resultado que se recibe de otros proveedores.	SOUNDEX(Propiedad_Texto) = SOUNDEX('cadena de texto')	SOUNDEX(Apellido) = SOUNDEX('Smith') Este ejemplo localiza los apellidos que se pronuncian de manera similar a Smith (por ejemplo, “Smythe”).
SUBSTR	Extrae una subcadena de una cadena. Si la posición inicial es 0, se tratará como 1. Si especifica un valor negativo para esta posición, la expresión contará hacia atrás a partir del final de la cadena. El valor devuelto utiliza el tipo de datos String. Por ejemplo, SUBSTR('ABCDEFG',-6,4) devolverá BCDE.	SUBSTR(Propiedad_Texto, Posición inicial, Longitud de subcadena)	SUBSTR(Apellido,0,4)
TRANSLATE	Reemplaza una secuencia de caracteres con otro conjunto de caracteres. El valor devuelto utiliza el tipo de datos String. Por ejemplo, TRANSLATE('A GIS Specialist''s Guide to C#' ' ''#', '___') transforma el título del libro mostrándolo como “A_GIS_Specialist_s_Guide_to_C_)”. El título original necesita una comilla simple adicional como carácter de escape.	TRANSLATE(Propiedad_Texto,'texto-origen','texto-destino')	TRANSLATE(Propiedad_Comentario ' ''#', '___') Este ejemplo convierte los espacios, las comillas y los caracteres # en caracteres de subrayado.
TRIM	Recorta los primeros caracteres de una cadena de texto. Para eliminar los caracteres finales, utilice RTRIM. El valor devuelto utiliza el tipo de datos String. Puede especificar un argumento opcional: ya sea BOTH, LEADING o TRAILING. Si no especifica el carácter de recorte, se asumirá que es el espacio en blanco. Véase RTRIM.	TRIM('argumento_opcional', Propiedad_Texto)	TRIM(‘trailing’, ID_Parcela) Este ejemplo recorta los caracteres finales del identificador de parcela.
UPPER	Cambia el texto a todo mayúsculas. El valor devuelto utiliza el tipo de datos String.	UPPER(Propiedad_Texto)	UPPER(Propietario_Parcela) Este ejemplo mostraría el valor “John McMansion” como “JOHN MCMANSION”.