Left, Mid, e Right funções

Aplica-se a: Aplicativos do Canvas Fluxos do Copilot Studio Desktop Colunas de fórmulas Dataverse Aplicações orientadas por modelos CLI da Power Platform Funções Dataverse Páginas de energia

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

Descrição

As Leftfunções , Mid, e retornam Right uma parte de uma cadeia de caracteres.

• 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 além do final da cadeia de caracteres, Mid retorna em branco. 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 )

• string - obrigatório. A cadeia a partir da qual vai extrair o resultado.
• StartingPosition - Obrigatório (Mid apenas). A posição inicial. O primeiro caráter da cadeia é a posição 1.
• NumberOfCharacters - Obrigatório (LeftRight e apenas). O número de carateres a devolver. Se omitida para a Mid função, a função retorna 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 cadeias de coluna única a partir da qual vai extrair os resultados.
• StartingPosition - Obrigatório (Mid apenas). A posição inicial. O primeiro caráter da cadeia é a posição 1.
• NumberOfCharacters - Obrigatório (LeftRight e apenas). O número de carateres a devolver. Se omitida para a Mid função, a função retorna a parte da posição inicial até o final da cadeia de caracteres.

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

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:

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.