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 contém cadeias de caracteres, a função retorna uma tabela de coluna única das 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 (Mid only). A posição inicial. O primeiro caractere da cadeia de caracteres é a posição 1.
  • NumberOfCharacters - obrigatório. O número de caracteres a ser retornado.

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 only). A posição inicial. O primeiro caractere da cadeia de caracteres é a posição 1.
  • NumberOfCharacters - obrigatório. O número de caracteres a ser retornado.

Exemplos

Cadeia de caracteres única

Os exemplos desta seção usam um controle de entrada de texto como fonte de dados. O controle é chamado Autor 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”
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 coluna Endereço desta fonte de dados, chamada Pessoase retorna uma tabela de coluna única que contém os resultados:

Fórmula Descrição Resultado
Left( ShowColumns( People, "Endereço" ), 8 ) Extrai os oito primeiros caracteres de cada cadeia de caracteres.
Mid( ShowColumns( People, "Endereço" ), 5, 7 ) Extrai os sete caracteres do meio de cada cadeia de caracteres, começando com o quinto caractere.
Right( ShowColumns( People, "Endereço" ), 7 ) Extrai os últimos sete caracteres de cada cadeia de caracteres.

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