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 Long
Dim x() As Byte x = StrConv("ABCDEFG", vbFromUnicode) ' Convert string. For i = 0 To UBound(x) Debug.Print x(i) Next