Função StrConv

Retorna uma Variant (String) convertida como especificado.

Sintaxe

StrConv(cadeia de caracteres, conversão, [ LCID ])

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

Parte	Descrição
cadeia de caracteres	Obrigatório. Expressão de cadeia de caracteres a ser convertida.
conversão	Obrigatório. Número inteiro. A soma de valores especificando o tipo de conversão a realizar.
LCID	Opcional. O LocaleID, se diferente do LocaleID do sistema. (O LocaleID do sistema é o padrão).

Configurações

As configurações do argumento de conversão são:

Constant	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úscula.
vbWide	4	Converte os caracteres estreitos (de um byte) de uma cadeia de caracteres em caracteres largos (de dois bytes).
vbNarrow	8	Converte os caracteres largos (de dois bytes) de uma cadeia de caracteres em caracteres estreitos (de um byte).
vbKatakana	16	Converte os caracteres Hiragana de uma cadeia de caracteres em caracteres Katakana.
vbHiragana	32	Converte os caracteres Katakana de uma cadeia de caracteres em caracteres Hiragana.
vbUnicode	64	Converte a cadeia de caracteres em Unicode usando a página de códigos padrão do sistema. (Indisponível no Macintosh).
vbFromUnicode	128	Converte a cadeia de caracteres de Unicode na página de códigos padrão do sistema. (Indisponível no Macintosh).

*Aplica-se a localidades do Leste Asiático. **Aplica-se somente ao Japão.

Observação

Essas constants são especificadas pelo Visual Basic for Applications. Como resultado, podem ser usadas em qualquer lugar no seu código substituindo os valores reais. A maioria pode ser combinada, por exemplo, vbUpperCase + vbWide, quando eles 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.

Os itens a seguir são separadores de palavras válidos para o uso adequado de maiúsculas: Null (Chr$(0)), tabulação horizontal (Chr$(9)), avanço de linha (Chr$(10)), tabulação vertical (Chr$(11)), avanço de linha (Chr$(12)), retorno de carro (Chr$(13)), espaço (SBCS) (Chr$(32)). O valor real de um espaço varia de acordo com o país/região for DBCS.

Comentários

Durante a conversão de uma matriz de Byte em formato ANSI para uma cadeia de caracteres, use a função StrConv. Durante a conversão de como uma matriz no formato Unicode, use uma instrução de atribuição.

Exemplo

Este exemplo usa a função StrConv 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

Confira também

• Funções (Visual Basic for Applications)

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.