Retorna uma Variante (Cadeia) que contém uma cadeia de caracteres repetida com o comprimento especificado.
Sintaxe
Cadeia(número; caráter)
A sintaxe da função Cadeia tem estes argumentos:
| Argumento | Descrição |
|---|---|
| número | Obrigatório. Longo. Comprimento da cadeia retornada. Se núm contiver Nulo, será devolvido Nulo . |
| caractere | Obrigatório. Variante. código de carateres que especifica o caráter ou expressão de cadeia cujo primeiro caráter é utilizado para criar a cadeia de retorno. Se o caráter contiver Nulo, será devolvido Nulo . |
Comentários
Se especificar um número para carateres superiores a 255, a Cadeia converte o número num código de carateres válido com a fórmula:
characterMod 256
Exemplo de consulta
| Expressão. | Resultados |
|---|---|
| SELECT ProductSales.ProductDesc, String(4,ProductDesc) AS testString FROM ProductSales; | Devolve a Descrição do produto, repita o primeiro caráter da Descrição do Produto 4 vezes na coluna testString. |
Exemplo de VBA
Observação
Exemplos que se seguem demonstram a utilização desta função num módulo Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do Programador na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.
Este exemplo utiliza a função Cadeia para devolver cadeias de carateres repetitivos do comprimento especificado.
Dim MyString
MyString = String(5, "*") ' Returns "*****"
MyString = String(5, 42) ' Returns "*****"
MyString = String(10, "ABC") ' Returns "AAAAAAAAAA"