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 do argumento de conversãosã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 o país/região do 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