Função StrConv

Retorna uma Variante (Cadeia) convertida conforme especificado.

Sintaxe

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

A sintaxe da função StrConv tem os seguintes argumentos:

Argumento

Descrição

cadeia

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

conversão

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

LCID

Opcional. O LocaleID, se for diferente do LocaleID do sistema. (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úsculos.

vbLowerCase

2

Converte a cadeia de caracteres em caracteres em minúsculas.

vbProperCase

3

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

vbWide *

4

Converte caracteres estreitos (de byte único) em cadeia de caracteres para caracteres largos (bytes duplos).

vbNarrow *

08

Converte caracteres largos (de dois bytes) em cadeia de caracteres para caracteres estreitos (byte único).

vbKatakana **

16 * *

Converte caracteres hiragana em cadeia de caracteres para caracteres Katakana.

vbHiragana **

32 * *

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

* Aplica-se a localidades da Ásia Oriental.

* * Aplica-se apenas ao Japão.

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

Estes são os separadores de palavras válidos para o capital correto: nulo (Chr$ (0)), guia horizontal (Chr$ (9)), avanço de texto (Chr$ (10)), guia vertical (Chr$ ( 11)), feed de formulário(Chr$ (12)), retorno de carro (Chr$ (13)), espaçamento (SBCS) (Chr$ (32)). O valor real para um espaço varia de acordo com o país/região de DBCS.

Comentários

Quando você estiver convertendo de uma matriz de bytes 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

Selecione strConv (ProductDesc, 1) como expr1 FROM ProductSales;

Converte os valores do campo "ProductDesc" em maiúsculas e exibe na coluna expr1

Selecione strConv (ProductDesc, 2) como 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 em minúsculas.

Exemplo de VBA

Observação: Exemplos a seguir demonstram o uso dessa função em um módulo do Visual Basic for Applications (VBA). 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

Observação:  Esta página foi traduzida automaticamente e pode apresentar erros gramaticais ou imprecisões. Nosso objetivo é que este conteúdo seja útil para você. Você pode nos dizer se as informações foram úteis? Use o artigo em inglês como referência.​

Consulte Também

As funções de cadeia de caracteres e como usá-las

Expanda suas habilidades no Office
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×