Funções Left, Mid e Right
Aplica-se a:
Colunas Dataverse de fórmula de aplicativos de tela Fluxos de área de trabalho CLI de aplicativos Power Pages Power Platform orientados por modelo
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 retorna os caracteres iniciais de uma cadeia de caracteres.
- Mid retorna os caracteres do meio de uma cadeia de caracteres.
- Right retorna os caracteres finais de uma cadeia de caracteres.
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
Esquerda(String,NumberOfCharacters )
Mid( String,StartingPosition [, NumberOfCharacters ] )
Direita(String,NumberOfCharacters )
- string - obrigatório. A cadeia a partir da qual vai extrair o resultado.
- StartingPosition - Obrigatório (apenas Médio ). A posição inicial. O primeiro caráter da cadeia é a posição 1.
- NumberOfCharacters - Obrigatório (apenas à esquerda e à direita ). 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.
Esquerda(SingleColumnTable,NumberOfCharacters )
Mid( SingleColumnTable,StartingPosition [, NumberOfCharacters ] )
Direita(SingleColumnTable,NumberOfCharacters )
- SingleColumnTable - Obrigatório. Uma tabela de cadeias de coluna única a partir da qual vai extrair os resultados.
- StartingPosition - Obrigatório (apenas Médio ). A posição inicial. O primeiro caráter da cadeia é a posição 1.
- NumberOfCharacters - Obrigatório (apenas à esquerda e à direita ). 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 |
|---|---|---|
| Esquerda( Author.Text, 5 ) | Extrai até cinco carateres no início da cadeia. | "E. E." |
| Médio( Author.Text, 7, 4 ) | Extrai até quatro carateres, a começar no sétimo caráter, da cadeia. | "Cumm" |
| Médio( Author.Text, 7 ) | Extrai todos os carateres, a começar no sétimo caráter, da cadeia. | "Cummings" |
| Direita( 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:
| Nome | Morada |
|---|---|
| "Jean" | "123 Main St NE" |
| "Fred" | "789 SW 39th #3B" |
| Fórmula | Descrição | Resultado |
|---|---|---|
| Esquerda( ShowColumns( Pessoas, "Endereço" ), 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( Pessoas, "Endereço" ), 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" |
| Direita( ShowColumns( Pessoas, "Endereço" ), 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:
Direita(ThisItem.ProductName, 3)
A etiqueta mostra os três últimos carateres de cada nome de produto.