Função StrCmpCW (shlwapi.h)

Compara cadeias de caracteres usando regras de ordenação ASCII (tempo de execução C). A comparação diferencia maiúsculas de minúsculas.

Sintaxe

int StrCmpCW(
  [out] LPCWSTR pszStr1,
  [out] LPCWSTR pszStr2
);

Parâmetros

[out] pszStr1

Tipo: LPCTSTR

Um ponteiro para a primeira cadeia de caracteres terminada em nulo a ser comparada.

[out] pszStr2

Tipo: LPCTSTR

Um ponteiro para a segunda cadeia de caracteres terminada em nulo a ser comparada.

Retornar valor

Tipo: int

Retornará zero se as cadeias de caracteres forem idênticas. Retorna um valor positivo se a cadeia de caracteres apontada por lpStr1 for alfabéticamente maior do que a apontada por lpStr2. Retorna um valor negativo se a cadeia de caracteres apontada por lpStr1 for alfabéticamente menor do que a apontada por lpStr2.

Comentários

É altamente recomendável que você use a função CompareString no lugar dessa função. StrCmpC foi projetado para comparar cadeias de caracteres canônicas. Essas cadeias de caracteres não são localizadas e consistem apenas em caracteres abaixo do valor ASCII 128. Portanto, ele não funcionará corretamente com um DBCS (conjunto de caracteres de byte duplo) ou outros dados de vários caracteres.

Essa função localiza os primeiros caracteres desiguais e retorna um número positivo se o caractere da primeira cadeia de caracteres for maior que o caractere do segundo, um número negativo se for menor ou zero se eles forem iguais. Por exemplo, se lpStr1="abczb" e lpStr2="abcdefg", StrCmpC determinará que o primeiro caractere desigual está na posição quatro ("z" em lpStr1 e "d" em lpStr2) e retornará um valor positivo, uma vez que o código ASCII para "z" é maior que o código ASCII para "d".

Para as versões do Windows que não incluem StrCmpC em Shlwapi.h, a versão individual do ANSI ou Unicode dessa função deve ser chamada diretamente de Shlwapi.dll. StrCmpCA é ordinal 155 e StrCmpCW é ordinal 156.

Observação

O cabeçalho shlwapi.h define StrCmpC como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlwapi.h
Biblioteca	Shlwapi.lib
DLL	Shlwapi.dll (versão 5.0 ou posterior)

Confira também

CompareString