Função StrConv

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

Retorna um valor () convertidoVariantString.

Sintaxe

StrConv(string, conversion [, LCID])

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

Argumento Descrição
string Obrigatório. A expressão de cadeia de caracteres a ser convertida.
conversion Obrigatório. Um número inteiro. A soma dos valores que especifica o tipo de conversão a ser executado.
LCID Opcional. A ID da localidade, se ela for diferente da ID da localidade do sistema. A ID de localidade do sistema é o padrão.

Configurações

As conversion configurações de argumento são:

Constante Valor Descrição
vbUpperCase 1 Converte a cadeia de caracteres em caracteres maiúsculos.
vbLowerCase 2 Converte a cadeia de caracteres em caracteres minúsculos.
vbProperCase 3 Converte a primeira letra de cada palavra da cadeia de caracteres em maiúsculas.
vbWide * 4* converte caracteres estreitos (byte único) na cadeia de caracteres em caracteres largos (bytes duplos).
vbNarrow * 8* converte caracteres largos (byte duplo) na cadeia de caracteres em caracteres estreitos (byte único).
vbKatakana ** 16** Converte caracteres Hiragana na cadeia de caracteres em caracteres Katakana.
vbHiragana ** 32** Converte caracteres Katakana na cadeia de caracteres em caracteres Hiragana.
vbUnicode 64 Converte a cadeia de caracteres em Unicode usando a página de código padrão do sistema. (Não disponível no Macintosh.)
vbFromUnicode 128 Converte a cadeia de caracteres de Unicode para a página de código padrão do sistema. (Não disponível no Macintosh.)

*Aplica-se a localidades do Leste Asiático.

**Aplica-se apenas ao Japão.

Observação

O Visual Basic for Applications (VBA) especifica essas constantes. Você pode usá-las em qualquer lugar do código em vez dos valores reais. É possível combinar a maioria das constantes. Por exemplo, use vbUpperCase + vbWide. Não combine constantes que sejam mutuamente exclusivas. Por exemplo, não use vbUnicode + vbFromUnicode. As vbWideconstantes , vbNarrow, vbKatakanae vbHiragana causam erros de tempo de execução quando você as usa em localidades nas quais elas não se aplicam.

A seguir estão separadores de palavras válidos para maiúsculas e minúsculas adequadas: Nulo (Chr$(0)), guia horizontal (Chr$(9)), avanço de linha (Chr$(10)), guia vertical (Chr$(11)), alimentação de formulário (Chr$(12)), retorno de carro (Chr$(13)) e espaço (SBCS) (Chr$(32)). Para DBCS, o valor real de um espaço varia de acordo com o país ou região.

Comentários

Ao converter uma Byte matriz no formato ANSI em uma cadeia de caracteres, use a StrConv função. Quando você estiver convertendo o mesmo tipo de matriz no formato Unicode, use uma instrução de atribuição.

Exemplos de consulta

Expressão. Resultados
SELECT StrConv(ProductDesc,1) AS Expr1 FROM ProductSales; Converte valores do ProductDesc campo em letras maiúsculas e os exibe na Expr1 coluna.
SELECT StrConv(ProductDesc,2) AS LowercaseID FROM ProductSales; Converte valores do ProductDesc campo em minúsculas e os exibe na LowercaseID coluna.

Exemplo de VBA

Observação

Os exemplos a seguir mostram como usar essa função em um módulo do Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do Desenvolvedor na lista suspensa ao lado de Pesquisa e insira um ou mais termos na caixa de pesquisa.

Este exemplo usa a StrConv função para converter uma cadeia de caracteres Unicode em uma cadeia de caracteres ANSI.

Dim i As Long
Dim x() As Byte
x = StrConv("ABCDEFG", vbFromUnicode) ' Convert string.
For i = 0 To UBound(x)
    Debug.Print x(i)
Next

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