bbmsp_contact_compare()

Compare two contacts by display name.

Synopsis:

#include <bbmsp/bbmsp_contactlist.h>

BBMSP_API int bbmsp_contact_compare(const bbmsp_contact_t *contact, const bbmsp_contact_t *other_contact)

Since:

BlackBerry 10.0.0

Arguments:

contact: A pointer to the first contact name.

other_contact: A pointer to the contact name to compare to.

Library:

libbbmsp (For the qcc command, use the -l bbmsp option to link against this library)

Description:

You can use this function to create a list of contacts that are sorted alphabetically.

Returns:

A negative integer if contact display name is lexicographically less than other_contact display name; zero if contact display name is lexicographically equal to other_contact display name; a positive integer if contact display name is lexicographically greater than other_contact display name. -1 is returned if invalid parameters are provided.