Funções Left, Mid e Right no PowerAppsLeft, Mid, and Right functions in PowerApps

Extrai a parte intermediária, à esquerda ou à direita de uma cadeia de caracteres de texto.Extracts the left, middle, or right portion of a string of text.

DescriçãoDescription

As funções Left, Mid e Right retornam uma parte de uma cadeia de caracteres.The Left, Mid, and Right functions return a portion of a string.

  • Left retorna os caracteres do início de uma cadeia de caracteres.Left returns the beginning characters of a string.
  • Mid retorna os caracteres do meio de uma cadeia de caracteres.Mid returns the middle characters of a string.
  • Right retorna os caracteres do final de uma cadeia de caracteres.Right returns the ending characters of a string.

Se você especificar uma única cadeia de caracteres como um argumento, a função retorna a parte que você solicitou da cadeia de caracteres.If you specify a single string as an argument, the function returns the portion that you requested of the string. Se você especificar uma tabela de coluna única que contém cadeias de caracteres, a função retorna uma tabela de coluna única das partes que você solicitou dessas cadeias de caracteres.If you specify a single-column table that contains strings, the function returns a single-column table of the portions that you requested of those strings. 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.If you specify a multi-column table, you can shape it into a single-column table, as working with tables describes.

Se a posição inicial for negativa ou após o final da cadeia de caracteres, Mid retorna em branco.If the starting position is negative or beyond the end of the string, Mid returns blank. Você pode verificar o comprimento de uma cadeia de caracteres usando a função Len.You can check the length of a string by using the Len function. 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.If you request more characters than the string contains, the function returns as many characters as possible.

SintaxeSyntax

Left( String, NumberOfCharacters )Left( String, NumberOfCharacters )
Mid( String, StartingPosition, NumberOfCharacters )Mid( String, StartingPosition, NumberOfCharacters )
Right( String, NumberOfCharacters )Right( String, NumberOfCharacters )

  • String - obrigatório.String - Required. A cadeia de onde será extraído o resultado.The string to from which to extract the result.
  • StartingPosition - Obrigatório (Mid only).StartingPosition - Required (Mid only). A posição inicial.The starting position. O primeiro caractere da cadeia de caracteres é a posição 1.The first character of the string is position 1.
  • NumberOfCharacters - obrigatório.NumberOfCharacters - Required. O número de caracteres a ser retornado.The number of characters to return.

Left( SingleColumnTable, NumberOfCharacters )Left( SingleColumnTable, NumberOfCharacters )
Mid( SingleColumnTable, StartingPosition, NumberOfCharacters )Mid( SingleColumnTable, StartingPosition, NumberOfCharacters )
Right( SingleColumnTable, NumberOfCharacters )Right( SingleColumnTable, NumberOfCharacters )

  • SingleColumnTable – Obrigatório.SingleColumnTable - Required. Uma tabela de coluna única de cadeias de caracteres da qual serão extraídos os resultados.A single-column table of strings from which to extract the results.
  • StartingPosition - Obrigatório (Mid only).StartingPosition - Required (Mid only). A posição inicial.The starting position. O primeiro caractere da cadeia de caracteres é a posição 1.The first character of the string is position 1.
  • NumberOfCharacters - obrigatório.NumberOfCharacters - Required. O número de caracteres a ser retornado.The number of characters to return.

ExemplosExamples

Cadeia de caracteres únicaSingle string

Os exemplos desta seção usam um controle de entrada de texto como fonte de dados.The examples in this section use a text-input control as their data source. O controle é chamado Autor e contém a cadeia de caracteres “E.The control is named Author and contains the string "E. E.E. Cummings”.Cummings".

FórmulaFormula DescriçãoDescription ResultadoResult
Left( Author.Text, 5 )Left( Author.Text, 5 ) Extrai até cinco caracteres do início da cadeia de caracteres.Extracts up to five characters from the start of the string. “E."E. E”.E."
Mid( Author.Text, 7, 4 )Mid( Author.Text, 7, 4 ) Extrai até quatro caracteres, começando com o sétimo caractere da cadeia de caracteres.Extracts up to four characters, starting with the seventh character, from the string. “Cumm”"Cumm"
Right( Author.Text, 5 )Right( Author.Text, 5 ) Extrai até cinco caracteres do início da cadeia de caracteres.Extracts up to five characters from the end of the string. “mings”"mings"

Tabela de coluna únicaSingle-column table

Cada exemplo nesta seção extrai cadeias de caracteres da coluna Endereço desta fonte de dados, chamada Pessoase retorna uma tabela de coluna única que contém os resultados:Each example in this section extracts strings from the Address column of this data source, named People, and returns a single-column table that contains the results:

FórmulaFormula DescriçãoDescription ResultadoResult
Left( ShowColumns( People, "Endereço" ), 8 )Left( ShowColumns( People, "Address" ), 8 ) Extrai os oito primeiros caracteres de cada cadeia de caracteres.Extracts the first eight characters of each string.
Mid( ShowColumns( People, "Endereço" ), 5, 7 )Mid( ShowColumns( People, "Address" ), 5, 7 ) Extrai os sete caracteres do meio de cada cadeia de caracteres, começando com o quinto caractere.Extracts the middle seven characters of each string, starting with the fifth character.
Right( ShowColumns( People, "Endereço" ), 7 )Right( ShowColumns( People, "Address" ), 7 ) Extrai os últimos sete caracteres de cada cadeia de caracteres.Extracts the last seven characters of each string.

Exemplo passo a passoStep-by-step example

  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.Import or create a collection named Inventory, and show it in a gallery, as the first procedure in Show images and text in a gallery describes.
  2. Defina a propriedade Texto do rótulo inferior na Galeria para esta função:Set the Text property of the lower label in the gallery to this function:

    Right(ThisItem.ProductName, 3)Right(ThisItem.ProductName, 3)

    O rótulo mostra os três últimos caracteres de cada nome de produto.The label shows the last three characters of each product name.