Compares substrings.

#include <string.h>

int strncmp(const char *string1, const char *string2, size_t count);

int _strncmp(const char *string1, const char *string2, size_t count);

#include <wchar.h>

int wcsncmp(const wchar_t *string1, const wchar_t *string2, size_t count);

Parameters

string1, string2

Strings to compare.

count

Number of characters compared.

Remarks

The strncmp function performs an ordinal comparison of at most the first count characters in string1 and string2 and returns a value indicating the relationship between the substrings. _strncmp is an alternate name for strncmp.

wcsncmp is a wide-character version of strncmp.  

Return Values

A value indicating the relationship between the substrings:

Value	Description
< 0	string1 less than string2
= 0	string1 equal to string2
> 0	string1 greater than string2

Generic Text Routines

Requirements