Devolve uma Variante (Cadeia) convertida conforme especificado.
Sintaxe
StrConv ( cadeia, conversão [, LCID ] )
A sintaxe da função StrConv tem estes argumentos:
|
Argumento |
Descrição |
|
cadeia |
Obrigatório. Expressão de cadeia a converter. |
|
conversão |
Obrigatório. Número inteiro. A soma de valores que especifica o tipo de conversão a ser efetuada. |
|
LCID |
Opcional. O LocaleID, se diferente do LocaleID do sistema. (O LocaleID do sistema é a predefinição.) |
Definições
As definições de conversãoargumento são:
|
Constante |
Valor |
Descrição |
|
vbUpperCase |
1 |
Converte a cadeia em carateres em maiúsculas. |
|
vbLowerCase |
2 |
Converte a cadeia em carateres minúsculos. |
|
vbProperCase |
3 |
Converte a primeira letra de cada palavra na cadeia em maiúsculas. |
|
vbWide * |
4* |
Converte carateres estreitos (byte único) na cadeia em carateres largos (byte duplo). |
|
vbNarrow * |
8* |
Converte carateres largos (byte duplo) na cadeia em carateres estreitos (byte único). |
|
vbKatakana ** |
16** |
Converte carateres hiragana em cadeia em carateres Katakana. |
|
vbHiragana ** |
32** |
Converte carateres katakana em cadeia em carateres Hiragana. |
|
vbUnicode |
64 |
Converte a cadeia em Unicode utilizando a página de código predefinida do sistema. (Não disponível no Macintosh.) |
|
vbFromUnicode |
128 |
Converte a cadeia de carateres de Unicode para a página de código predefinida do sistema. (Não disponível no Macintosh.) |
*Aplica-se às regiões da Ásia Oriental.
**Aplica-se apenas ao Japão.
Nota: Estas constantes são especificadas por Visual Basic for Applications (VBA). Como resultado, podem ser utilizados em qualquer parte do seu código em vez dos valores reais. A maioria pode ser combinada, por exemplo, vbUpperCase + vbWide, exceto quando são mutuamente exclusivos, 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.
Seguem-se separadores de palavras válidos para maiúsculas/nulas: Nulo (Chr$(0)), separador horizontal (Chr$(9)), linefeed (Chr$(10)), separador vertical (Chr$(11)), feed de formulário (Chr$(12)), símbolo de retorno (Chr$(13)), espaço (SBCS) (Chr$(32)). O valor real de um espaço varia de acordo com o país/região para DBCS.
Observações
Quando estiver a converter de uma matriz byte no formato ANSI para uma cadeia, deve utilizar a função StrConv . Quando estiver a converter a partir de uma matriz deste tipo no formato Unicode, utilize 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 é apresentado na coluna Expr1 |
|
SELECT strConv(ProductDesc,2) AS LowercaseID FROM ProductSales; |
Converte os valores do campo "ProductDesc" em minúsculas e é apresentado na coluna LowercaseID. Converte a primeira letra de cada palavra de "ProductDesc" em maiúscula e é apresentada na coluna PropercaseID. Todos os outros carateres são deixados em minúsculas. |
Exemplo de VBA
Nota: Os exemplos seguintes demonstram a utilização desta função no módulo VBA (Visual Basic for Applications). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.
Este exemplo utiliza a função StrConv para converter uma cadeia Unicode numa cadeia 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
