Função StrCmpNICA (shlwapi.h)

Compara um número especificado de caracteres do início de duas cadeias de caracteres usando regras de ordenação ASCII (tempo de execução C). A comparação não diferencia maiúsculas de minúsculas.

Sintaxe

int StrCmpNICA(
  [in] LPCSTR pszStr1,
  [in] LPCSTR pszStr2,
       int    nChar
);

Parâmetros

[in] pszStr1

Tipo: LPCTSTR

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

[in] pszStr2

Tipo: LPCTSTR

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

nChar

Tipo: int

O número de caracteres do início de cada cadeia de caracteres a ser comparado.

Retornar valor

Tipo: int

Retornará zero se as subcadeias de caracteres forem idênticas. Retornará um valor positivo se a cadeia de caracteres retirada daquela apontada por pszStr1 for alfabéticamente maior que a cadeia de caracteres obtida a partir da qual o pszStr2 apontou. Retornará um valor negativo se a cadeia de caracteres obtida daquela apontada por pszStr1 for alfabéticamente menor do que a cadeia de caracteres obtida daquela apontada por pszStr2.

Comentários

Observe que StrCmpNIC 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 dois bytes) 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, suponha que pszStr1="abczb", pszStr2="abcdefg" e você esteja comparando os quatro primeiros caracteres de cada um. StrCmpNIC determina que o primeiro caractere desigual está na posição quatro ("z" em pszStr1 e "d" em pszStr2) e retorna um valor positivo, pois o código ASCII para "z" é maior que o código ASCII para "d".

Para as versões do Windows que não incluem StrCmpNIC em Shlwapi.h, a versão INDIVIDUAL ANSI ou Unicode dessa função deve ser chamada diretamente de Shlwapi.dll. StrCmpNICA é ordinal 153 e StrCmpNICW é ordinal 154.

Requisitos

Confira também

CompareString

StrCmpIC

StrCmpNI