Funções Left, Mid e Right
Aplica-se a:
Aplicativos de tela Colunas de fórmula do Dataverse Fluxos da área de trabalho Aplicativos baseados em modelo Power Platform CLI
Extrai a parte intermediária, à esquerda ou à direita de uma cadeia de caracteres de texto.
Descrição
As funções Left, Mid e Right retornam uma parte de uma cadeia de caracteres.
- Left retorna os caracteres do início de uma cadeia de caracteres.
- Mid retorna os caracteres do meio de uma cadeia de caracteres.
- Right retorna os caracteres do final de uma cadeia de caracteres.
Se você especificar uma única cadeia de caracteres como um argumento, a função retorna a parte que você solicitou da cadeia de caracteres. Se você especificar uma tabela de coluna única que contenha cadeias de caracteres, a função retornará uma tabela de coluna única com uma coluna Valor contendo as partes que você solicitou dessas cadeias de caracteres. Se você tiver uma tabela de várias colunas, é possível formatá-la como uma tabela de coluna única, conforme descrito em trabalhando com tabelas.
Se a posição inicial for negativa ou após o final da cadeia de caracteres, Mid retorna em branco. Você pode verificar o comprimento de uma cadeia de caracteres usando a função Len. Se você solicitar um número de caracteres maior do que aquele existente na cadeia de caracteres, a função retorna o maior número de caracteres possível.
Sintaxe
Left( String, NumberOfCharacters )
Mid( String, StartingPosition [, NumberOfCharacters ] )
Right( String, NumberOfCharacters )
- String - obrigatório. A cadeia de onde será extraído o resultado.
- StartingPosition - obrigatório (somente Mid). A posição inicial. O primeiro caractere da cadeia está na posição 1.
- NumberOfCharacters - obrigatório (somente Left e Right). O número de caracteres a ser retornado. Se omitido para a função Mid, a função retorna a porção da posição inicial até o final da cadeia de caracteres.
Left( SingleColumnTable, NumberOfCharacters )
Mid( SingleColumnTable, StartingPosition [, NumberOfCharacters ] )
Right( SingleColumnTable, NumberOfCharacters )
- SingleColumnTable - obrigatório. Uma tabela de coluna única de cadeias de caracteres da qual serão extraídos os resultados.
- StartingPosition - obrigatório (somente Mid). A posição inicial. O primeiro caractere da cadeia está na posição 1.
- NumberOfCharacters - obrigatório (somente Left e Right). O número de caracteres a ser retornado. Se omitido para a função Mid, a função retorna a porção da posição inicial até o final da cadeia de caracteres.
Exemplos
Cadeia de caracteres única
Os exemplos desta seção usam um controle de entrada de texto como fonte de dados. O controle é chamado Author e contém a cadeia de caracteres "E. E. Cummings".
| Fórmula | Descrição | Resultado |
|---|---|---|
| Left( Author.Text, 5 ) | Extrai até cinco caracteres do início da cadeia de caracteres. | "E. E." |
| Mid( Author.Text, 7, 4 ) | Extrai até quatro caracteres, começando com o sétimo caractere da cadeia de caracteres. | “Cumm” |
| Mid( Author.Text, 7 ) | Extrai todos os caracteres, começando com o sétimo caractere da cadeia de caracteres. | "Cummings" |
| Right( Author.Text, 5 ) | Extrai até cinco caracteres do início da cadeia de caracteres. | "mings" |
Tabela de coluna única
Cada exemplo nesta seção extrai cadeias de caracteres da colunaEndereço desta fonte de dados, chamada Pessoa se retorna uma tabela de coluna única que contém os resultados:
| Name | Address |
|---|---|
| "Jean" | "123 Main St NE" |
| "Fred" | "789 SW 39th #3B" |
| Fórmula | Description | Result |
|---|---|---|
| Left( ShowColumns( People, "Address" ), 8 ) | Extrai os oito primeiros caracteres de cada cadeia de caracteres. | 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 caracteres do meio de cada cadeia de caracteres, começando com o quinto caractere. | 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 sete caracteres de cada cadeia de caracteres. | Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: "n St NE", "9th #3B" |
Exemplo passo a passo
Importa ou cria uma coleção denominada Inventário e mostra esta em uma galeria, conforme descrito no primeiro procedimento em Mostrar imagens e texto em uma galeria.
Defina a propriedade Text do rótulo inferior na Galeria para esta função:
Right(ThisItem.ProductName, 3)
O rótulo mostra os três últimos caracteres de cada nome de produto.