Left, Mide Right funções

Aplica-se a: Aplicativos de tela O Copilot Studio Desktop flui colunas de fórmula do Dataverse para aplicativos controlados por modelos do Power Platform CLI Dataverse functions Power Pages

Extrai a parte intermediária, à esquerda ou à direita de uma cadeia de caracteres de texto.

Descrição

O Left, Mide Right as funções retornam uma parte de uma cadeia de caracteres.

• Left retorna os caracteres inicialmente 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 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 além do final da cadeia de caracteres, Mid retornará 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 (Mid somente). A posição inicial. O primeiro caractere da cadeia está na posição 1.
• NumberOfCharacters – Obrigatório (Left e Right somente). O número de caracteres a ser retornado. Se omitida para a Mid função, a função retornará a parte 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 (Mid somente). A posição inicial. O primeiro caractere da cadeia está na posição 1.
• NumberOfCharacters – Obrigatório (Left e Right somente). O número de caracteres a ser retornado. Se omitida para a Mid função, a função retornará a parte 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".

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:

Exemplo passo a passo

1. 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.

2. 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.