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 definiçõ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 utilizadas em regiões onde 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
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.