Method

PurplePersonmatches

unstable since: 3.0

Declaration [src]

gboolean
purple_person_matches (
  PurplePerson* person,
  const char* needle
)

Description [src]

Checks if any of the names that could be used for display match the needle.

This checks needle against PurplePerson:alias, and calls purple_contact_info_matches() for each PurpleContactInfo that has been added to the person.

If needle is null or empty string, true will be returned.

Available since: 3.0

Parameters

needle

Type: const char*

The string to match on.

The argument can be NULL.
The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.

Return value

Type: gboolean

True if the person matches in any way.