Função StrComp

Retorna uma Variant (Integer) indicando o resultado de um expressão de cadeia de caracteres.

Sintaxe

StrComp ( string1, string2 [, compare ] )

A sintaxe da função StrComp tem estes 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 cadeia de caracteres. Se a comparaçãoargumento for Null, ocorrerá um erro. Se compare for omitido, a configuração Comparação de Opção determinará o tipo de comparação.

Configurações

As configurações de argumento de comparação 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 somente. Executa uma comparação com base em informações em seu banco de dados.

Valores de retorno

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

If

StrComp retorna

string1 é menor que string2

-1

string1 é igual a string2

0

string1 é maior que string2

1

string1 ou string2 é Null

Nulo

Exemplo de consulta

Expressão

Resultados

SELECT ProductSales.ProductID, StrComp(ProductID,"PRO_XYZ10") AS ComparisonResult FROM 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 NULL, a função StrComp retornará NULL.

Exemplo do VBA

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

Este exemplo usa a função StrComp para retornar os resultados de uma comparação de cadeia 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á executada.

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.

Consulte Também

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

Precisa de mais ajuda?

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

Essas informações foram úteis?

×