bcmp()
Compare a given number of characters in two strings
Synopsis:
#include <strings.h>
int bcmp( const void *s1,
const void *s2,
size_t n );
Since:
BlackBerry 10.0.0
Arguments:
- s1, s2
- The strings you want to compare.
- n
- The number of bytes to compare.
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
The bcmp() function compares the byte string pointed to by s1 to the string pointed to by s2. The number of bytes to compare is specified by n. NUL characters may be included in the comparison.
This function is similar to the ANSI memcmp() function, but tests only for equality. New code should use the ANSI function.
Returns:
- 0
- The byte strings are identical.
- 1
- The byte strings aren't identical.
Examples:
#include <stdlib.h>
#include <stdio.h>
#include <string.h>
int main( void )
{
if( bcmp( "Hello there", "Hello world", 6 ) ) {
printf( "Not equal\n" );
} else {
printf( "Equal\n" );
}
return EXIT_SUCCESS;
}
produces the output:
Equal
Classification:
| Safety: | |
|---|---|
| Cancellation point | No |
| Interrupt handler | Yes |
| Signal handler | Yes |
| Thread | Yes |
Last modified: 2014-06-24