Função StrComp

Retorna uma variante (inteiro) que indica o resultado de um expressão de cadeia de caracteres.

Sintaxe

StrComp ( Seqüência1, seqüência2 [, comparar ] )

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

Argumento

Descrição

cadeia1

Obrigatório. Qualquer expressão de cadeia de caracteres válida.

cadeia2

Obrigatório. Qualquer expressão de cadeia de caracteres válida.

comparar

Opcional. Especifica o tipo de comparação de cadeias de caracteres. Se aargumento de comparação for nula, ocorrerá um erro. Se comparar for omitido, a configuração opção comparar determinará o tipo de comparação.

Configurações

As configurações do argumento comparar são:

Constante

Valor

Descrição

vbBinaryCompare

0

Executa uma comparação binária.

vbTextCompare

1

Executa uma comparação textual.

vbDatabaseCompare

2

Microsoft Office Access 2007 apenas. Executa uma comparação com base nas informações do seu banco de dados.

Valores de retorno

A função StrComp tem os seguintes valores de retorno:

If

StrComp retorna

seqüência1 é menor que seqüência2

-1

seqüência1 é igual a seqüência2

0

seqüência1 é maior do que seqüência2

1

seqüência1 ou seqüência2 é nulo

Nulo

Exemplo de consulta

Expressão

Resultados

Selecione ProductSales. ProductID, StrComp (ProductID, "PRO_XYZ10") como ComparisonResult do ProductSales;

Retorna os valores do campo "ProductID", compara os valores em "ProductID" com "PRO_XYZ1" e retorna os resultados na coluna ComparisonResult. "ProductID" é igual a "PRO_XYZ10", a função StrComp retornará 0. Se "ProductID" for menor que "PRO_XYZ10", a função StrComp retornará-1. Se "ProductID" for maior que "PRO_XYZ10", a função StrComp retornará 1. Se "ProductID" ou "PRO_XYZ10" for nulo, a função StrComp retornará nulo.

Exemplo de VBA

Observação: Exemplos a seguir demonstram o uso dessa função em um módulo do Visual Basic for Applications (VBA).

Este exemplo usa a função StrComp para retornar os resultados de uma comparação de cadeias de caracteres. Se o terceiro argumento for 1, uma comparação textual será realizada; Se o terceiro argumento for 0 ou omitido, uma comparação binária será realizada.

Dim MyStr1, MyStr2, MyComp
MyStr1 = "ABCD": MyStr2 = "abcd" ' Define variables.
MyComp = StrComp(MyStr1, MyStr2, 1) ' Returns 0.
MyComp = StrComp(MyStr1, MyStr2, 0) ' Returns -1.
MyComp = StrComp(MyStr2, MyStr1) ' Returns 1.

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.

×