Applies ToAccess para Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Retorna uma Variante (Cadeia) convertida conforme especificado.

Sintaxe

StrConv ( string, conversion [, LCID ] )

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

Argumento

Descrição

cadeia

Obrigatório. Expressão de cadeia de caracteres a ser convertida.

conversão

Obrigatório. Inteiro. A soma de valores que especifica o tipo de conversão que deve ser executada.

LCID

Opcional. O LocaleID, se diferente do sistema LocaleID. (O LocaleID do sistema é o padrão.)

Configurações

As configurações deargumento de conversão são:

Constante

Valor

Descrição

vbUpperCase

1

Converte a cadeia de caracteres em caracteres maiúsculas.

vbLowerCase

2

Converte a cadeia de caracteres em caracteres minúsculas.

vbProperCase

3

Converte a primeira letra de cada palavra na cadeia de caracteres em maiúsculas.

vbWide *

4*

Converte caracteres estreitos (bytes únicos) na cadeia de caracteres em caracteres largos (bytes duplos).

vbNarrow *

8*

Converte caracteres largos (bytes duplos) na cadeia de caracteres para caracteres estreitos (bytes únicos).

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 do Unicode na página de código padrão do sistema. (Não disponível no Macintosh.)

*Aplica-se a localidades do leste da Ásia.

**Aplica-se somente ao Japão.

Observação: Essas constantes são especificadas pelo VBA (Visual Basic for Applications). Como resultado, eles podem ser usados em qualquer lugar do código no lugar dos valores reais. A maioria pode ser combinada, por exemplo, vbUpperCase + vbWide, exceto quando são mutuamente exclusivas, por exemplo, vbUnicode + vbFromUnicode. As constantes vbWide, vbNarrow, vbKatakana e vbHiragana causam erros de tempo de execução quando usadas em localidades em que não se aplicam.

Veja a seguir separadores de palavras válidos para invólucro adequado: Null (Chr$(0)), guia horizontal (Chr$(9)), linefeed (Chr$(10)), guia vertical (Chr$(11)), feed de formulário (Chr$(12)), retorno de carruagem (Chr$(13)), espaço (SBCS) (Chr$(32)). O valor real de um espaço varia de acordo com país/região para DBCS.

Comentários

Quando você estiver convertendo de uma matriz Byte no formato ANSI em uma cadeia de caracteres, você deve usar a função StrConv . Quando você estiver convertendo de tal 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 os valores do campo "ProductDesc" em maiúsculas e exibe na coluna Expr1

SELECT strConv(ProductDesc,2) AS LowercaseID FROM ProductSales;

Converte os valores do campo "ProductDesc" em minúsculas e exibe na coluna LowercaseID. Converte a primeira letra de cada palavra de "ProductDesc" em maiúsculas e exibe na coluna PropercaseID. Todos os outros caracteres são deixados como minúsculas.

Exemplo de VBA

Observação: Exemplos a seguir demonstram o uso dessa função em um módulo VBA (Visual Basic for Applications). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do Desenvolvedor na lista suspensa ao lado de Pesquisar e insira um ou mais termos na caixa de pesquisa.

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

Dim i As LongDim x() As Bytex = 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

Precisa de mais ajuda?

Quer mais opções

Explore os benefícios da assinatura, procure cursos de treinamento, saiba como proteger seu dispositivo e muito mais.

As comunidades ajudam você a fazer e responder perguntas, fazer comentários e ouvir especialistas com conhecimento avançado.