Funções Left, Mid e Right no Power Apps

Extrai a parte esquerda, central ou direita de uma cadeia de texto.

Descrição

As funções Left, Mid e Right devolvem parte de um cadeia.

• Left devolve os carateres iniciais de uma cadeia.
• Mid devolve os carateres centrais de uma cadeia.
• Right devolve os carateres finais de uma cadeia.

Se especificar uma cadeia única como um argumento, a função devolverá a parte da cadeia solicitada. Se especificar uma tabela de coluna única com cadeias, a função devolverá uma tabela de coluna única das partes dessas cadeias solicitadas. Se especificar uma tabela com várias colunas, poderá formatá-las para uma tabela de coluna única, conforme descrito em trabalhar com tabelas.

Se a posição inicial for negativa ou for além do fim da cadeia, a função Mid devolverá um resultado blank. Pode verificar o comprimento de uma cadeia com a função Len. Se pedir mais carateres do que os da cadeia, a função devolverá o máximo de carateres possível.

Sintaxe

Left( String, NumberOfCharacters )
Mid( String, StartingPosition [, NumberOfCharacters ] )
Right( String, NumberOfCharacters )

• Cadeia – Obrigatório. A cadeia a partir da qual vai extrair o resultado.
• StartingPosition - Obrigatório (apenas Mid). A posição inicial. O primeiro caráter da cadeia é a posição 1.
• NumberOfCharacters - Obrigatório (Left e Right apenas). O número de carateres a devolver. Se for omitido para a função Mid, a função devolve a parte da posição inicial até ao final da cadeia.

Left( SingleColumnTable, NumberOfCharacters )
Mid( SingleColumnTable, StartingPosition [, NumberOfCharacters ] )
Right( SingleColumnTable, NumberOfCharacters )

• TabelaComUmaÚnicaColuna – Obrigatório. Uma tabela de cadeias de coluna única a partir da qual vai extrair os resultados.
• StartingPosition - Obrigatório (apenas Mid). A posição inicial. O primeiro caráter da cadeia é a posição 1.
• NumberOfCharacters - Obrigatório (Left e Right apenas). O número de carateres a devolver. Se for omitido para a função Mid, a função devolve a parte da posição inicial até ao final da cadeia.

Exemplos

Cadeia única

Os exemplos nesta secção utilizam um controlo de introdução de texto como a origem de dados. O controlo é denominado Author e contém a cadeia "E. E. Cummings".

Fórmula	Descrição	Resultado
Left( Author.Text, 5 )	Extrai até cinco carateres no início da cadeia.	"E. E."
Mid( Author.Text, 7, 4 )	Extrai até quatro carateres, a começar no sétimo caráter, da cadeia.	"Cumm"
Mid( Author.Text, 7 )	Extrai todos os carateres, a começar no sétimo caráter, da cadeia.	"Cummings"
Right( Author.Text, 5 )	Extrai até cinco carateres no final da cadeia.	"mings"

Tabela de coluna única

Cada exemplo nesta secção extrai cadeias da coluna Address desta origem de dados, denominada People e devolve uma tabela de coluna única com os resultados:

Fórmula	Descrição	Resultado
Left( ShowColumns( People, "Address" ), 8 )	Extrai os primeiros oito carateres de cada cadeia.
Mid( ShowColumns( People, "Address" ), 5, 7 )	Extrai os sete carateres centrais de cada cadeia, a começar no quinto caráter.
Right( ShowColumns( People, "Address" ), 7 )	Extrai os últimos oito carateres de cada cadeia.

Exemplo passo a passo

1. Importe ou crie uma coleção denominada Inventory e mostre-a numa galeria, como descreve o primeiro procedimento em Mostrar imagens e texto numa galeria.

2. Defina a propriedade Text da etiqueta inferior na galeria para esta função:

   Right(ThisItem.ProductName, 3)

   A etiqueta mostra os três últimos carateres de cada nome de produto.

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).