Função String

Aplica-se A
Access para Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Devolve um Variant (String) que contém uma cadeia de carateres repetitivo do comprimento especificado.

Sintaxe

String(number, character)

A String sintaxe da função tem estes argumentos:

Argumento Descrição
number Obrigatório. Long. O comprimento da cadeia devolvida. Se number contém Null, Null é devolvido.
character Obrigatório. Variant. Um código de carateres que especifica o caráter ou uma expressão de cadeia cujo primeiro caráter é utilizado para criar a cadeia devolvida. Se character contém Null, Null é devolvido.

Observações

Se especificar um número superior a 255 para character, String o converte o número num código de carateres válido com esta fórmula:

character Mod 256

Exemplo de consulta

Expressão Resultados
SELECT ProductSales.ProductDesc, String(4, ProductDesc) AS testString FROM ProductSales; Devolve a descrição do produto e repete o primeiro caráter de ProductDesc quatro vezes na testString coluna.

Exemplo de VBA

Nota

Os exemplos seguintes demonstram a utilização desta função no módulo VBA (Visual Basic for Applications). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.

Este exemplo utiliza a String função para devolver cadeias de carateres de repetição do comprimento especificado.

Dim MyString
MyString = String(5, "*")    ' Returns "*****"
MyString = String(5, 42)    ' Returns "*****"
MyString = String(10, "ABC")    ' Returns "AAAAAAAAAA"

As funções de cadeia e como utilizá-las