Funções Left, Mid e Right
Aplica-se a:
Aplicações de tela Colunas de fórmula do Dataverse Fluxos de ambiente de trabalho Aplicações condicionadas por modelo Power Platform CLI
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 com uma coluna Valor contendo as partes que pediu dessas cadeias. 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 colunaAddress desta origem de dados, denominada People e devolve uma tabela de coluna única com os resultados:
| Name | Morada |
|---|---|
| "Jean" | "123 Main St NE" |
| "Fred" | "789 SW 39th #3B" |
| Fórmula | Descrição | Resultado |
|---|---|---|
| Left( ShowColumns( People, "Address" ), 8 ) | Extrai os primeiros oito carateres de cada cadeia. | Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: "123 Main", "789 SW 3" |
| Mid( ShowColumns( People, "Address" ), 5, 7 ) | Extrai os sete carateres centrais de cada cadeia, a começar no quinto caráter. | Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: "Main St", "SW 39th" |
| Right( ShowColumns( People, "Address" ), 7 ) | Extrai os últimos oito carateres de cada cadeia. | Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: "n St NE", "9th #3B" |
Exemplo passo a passo
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.
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.