Função StrCmpNCW (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 diferencia maiúsculas de minúsculas.
Sintaxe
int StrCmpNCW(
[in] LPCWSTR pszStr1,
[in] LPCWSTR 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 desde o início de cada cadeia de caracteres a ser comparada.
Retornar valor
Tipo: int
Retornará zero se as subcadeias de caracteres forem idênticas. Retornará um valor positivo se a cadeia de caracteres obtida a partir daquela apontada por pszStr1 for alfabéticamente maior do que a cadeia de caracteres obtida a partir daquela apontada por pszStr2. Retornará um valor negativo se a cadeia de caracteres obtida do apontado por pszStr1 for em ordem alfabética menor do que a cadeia de caracteres obtida da apontada por pszStr2.
Comentários
Observe que StrCmpNC 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, suponha que pszStr1="abczb", pszStr2="abcdefg" e você esteja comparando os quatro primeiros caracteres de cada um. StrCmpNC 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 StrCmpNC em Shlwapi.h, a versão individual do ANSI ou Unicode dessa função deve ser chamada diretamente de Shlwapi.dll. StrCmpNCA é ordinal 151 e StrCmpNCW é ordinal 152.
Observação
O cabeçalho shlwapi.h define StrCmpNC 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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de