Funções de texto

As funções de texto estão disponíveis no menu Função de texto. Elas operam em propriedades de texto e são úteis para formatar os resultados de consultas relativas ao texto. Estas funções estão disponíveis para todos os provedores de dados, exceto para os provedores raster, WFS e WMS.

Ao criar uma expressão para recursos geoespaciais, você pode utilizar as seguintes funções de texto:

Função	Definição	Sintaxe	Exemplo
CONCAT	Une várias sequências de caracteres em uma. A função CONCAT pega qualquer número de argumentos, que pode ser qualquer tipo de propriedade, exceto Geometria ou Raster. O valor de retorno utiliza o tipo de dados Sequência de caracteres. Utilize '\n ' para inserir uma quebra de linha ao utilizar estilos padrão. Utilize '\P ' para inserir uma quebra de linha ao utilizar estilos aprimorados. Esses parâmetros diferenciam maiúsculas de minúsculas. Para incluir espaços ou legendas de texto estático, adicione aspas simples ao redor deles. Quando você utiliza Concat com uma propriedade booleana, a operação gera 1/0 (não True/False) como resultado.	CONCAT(Property, Property, ...)	CONCAT(First_Name, ‘ ‘Last_Name,’\P’ ‘Address: ‘, Street_number, ‘ ‘, Street_name, ‘ ‘, Suffix) Este exemplo produz uma legenda como esta: John Smith Endereço: Rua Carvalho 123
INSTR	Localiza a posição da primeira ocorrência de uma subsequência de caracteres em outra sequência de caracteres. Especifique a sequência de caracteres de origem como o primeiro argumento e a sequência de caracteres que você está procurando como o segundo argumento. Retorna um número inteiro com o tipo de dados Int64.	INSTR(Text property or value, Text property or value)	INSTR(Parcel_Owner,'field) Este exemplo olha para a subsequência de caracteres “campo” dentro da sequência de caracteres do proprietário do lote. Se o nome do proprietário do lote fosse Smithfield, o valor retornado seria 6.
COMPRIMENTO	Retorna o número de caracteres da sequência de caracteres especificada como um inteiro com o tipo de dados Int64. Não inclua caracteres em branco à direita.	LENGTH(Text_property)	LENGTH(First_Name) Este exemplo localiza o número de caracteres na propriedade First_Name.
LOWER	Converte o texto para letras minúsculas. O valor de retorno utiliza o tipo de dados Sequência de caracteres.	LOWER(Text_property)	LOWER(Product_Name) Este exemplo altera uma entrada de nome de produto para minúsculas (por exemplo, TUBULAÇÃO COMPOSTA para tubulação composta).
LPAD	Preenche o lado esquerdo de uma sequência de caracteres com os caracteres especificados. O valor de retorno utiliza o tipo de dados Sequência de caracteres. O LPAD pode levar de dois a três parâmetros. Se você não especificar o argumento de caractere de texto, um espaço é utilizado.	LPAD(Text_property, Número de caracteres,’caractere de texto')	LPAD(High_Prority,3,'*') Este exemplo pode mostrar um valor para a propriedade High_Priority (por exemplo, “Reparo de emergência) precedido por ***.
LTRIM	Recorta caracteres do lado esquerdo de uma sequência de texto. O valor de retorno utiliza o tipo de dados Sequência de caracteres.	LTRIM(Text_property)	LTRIM(Parcel_ID) Este exemplo remove caracteres à esquerda dos identificadores de lote.
RPAD	Preenche o lado direito de uma sequência de caracteres com os caracteres especificados. O valor de retorno utiliza o tipo de dados Sequência de caracteres. O RPAD pode levar de dois a três parâmetros. Se você não especificar o argumento de caractere de texto, um espaço é utilizado.	RPAD(Text_property, Número de caracteres,’caractere de texto')	RPAD(Costly_Repair,3,$) Este exemplo pode mostrar um valor para a propriedade Costly_Repair (por exemplo, “Reprojeto completo”) seguido por $$$.
RTRIM	Recorta caracteres no lado direito de uma sequência de caracteres texto (à direita). O valor de retorno utiliza o tipo de dados Sequência de caracteres. Para remover caracteres à esquerda, utilize TRIM. Consulte TRIM.	RTRIM(Text_Propert)	RTRIM(Parcel_ID) Este exemplo remove caracteres que seguem identificadores de lote.
SOUNDEX	Retorna os nomes que, em inglês, soam como a sequência de texto especificada. O valor de retorno utiliza o tipo de dados Sequência de caracteres. O RDBMS subjacente avalia uma expressão, incluindo a função SOUNDEX. No entanto, o resultado devolvido por um provedor MySQL pode diferir do resultado recebido de outros provedores.	SOUNDEX(Text_property) = SOUNDEX('text string')	SOUNDEX(Last_Name) = SOUNDEX('Smith') Este exemplo localiza os sobrenomes que soam como Smith (por exemplo, “Smythe”).
SUBSTR	Extrai uma subsequência de caracteres de uma sequência de caracteres. Se a posição inicial for 0, ela será tratada como 1. Se você especificar um valor negativo para esta posição, a expressão conta para trás a partir do fim da sequência de caracteres. O valor de retorno utiliza o tipo de dados Sequência de caracteres. Por exemplo, SUBSTR('ABCDEFG',-6,4) localiza BCDE.	SUBSTR(Text_property, Starting position, Length of substring)	SUBSTR(Last_Name,0,4)
TRANSLATE	Substitui uma sequência de caracteres por outro conjunto de caracteres. O valor de retorno utiliza o tipo de dados Sequência de caracteres. Por exemplo, TRANSLATE('A GIS Specialist''s Guide to C#' ' ''#', '___') transforma o título do livro mostrado para “A_GIS_Specialist_s_Guide_to_C_)”. O título original precisa de outra cota única como um caractere de escape.	TRANSLATE(Text_property,'from-text','to-text')	TRANSLATE(Comment_Property ' ''#', '___') Este exemplo altera espaços, aspas e caracteres # para caracteres sublinhados.
TRIM	Recorta caracteres à esquerda de uma sequência de caracteres de texto. Para remover caracteres à direita, utilize RTRIM. O valor de retorno utiliza o tipo de dados Sequência de caracteres. É possível especificar um argumento opcional: ser BOTH, LEADING ou TRAILING. Se você não especificar o caractere de recorte, um espaço em branco é assumido. Consulte RTRIM.	TRIM('optional_argument', Text_property)	TRIM(‘trailing’, Parcel_ID) Este exemplo recorta caracteres à direita da ID de lote.
UPPER	Converte o texto para letras maiúsculas. O valor de retorno utiliza o tipo de dados Sequência de caracteres.	UPPER(Text property)	UPPER(Parcel_Owner) Este exemplo exibirá o valor “John McMansion” como “JOHN MCMANSION”.