libpurple/purple-client-example.c

Sun, 21 Jun 2009 16:40:15 +0000

author
Richard Laager <rlaager@pidgin.im>
date
Sun, 21 Jun 2009 16:40:15 +0000
changeset 27361
62f1aa8045bb
parent 22582
838faa931042
child 38057
41f47eb1aa19
permissions
-rw-r--r--

propagate from branch 'im.pidgin.pidgin.2.5.7' (head 550e6ec7c9fd15db9956387a5775df07322ec766)
to branch 'im.pidgin.pidgin' (head 3029011cad5ac369187a44041818ef24c4911906)

#ifndef DBUS_API_SUBJECT_TO_CHANGE
#define DBUS_API_SUBJECT_TO_CHANGE
#endif

#include <stdio.h>
#include <stdlib.h>

#include "purple-client.h"

/*
   This example demonstrates how to use libpurple-client to communicate
   with purple.  The names and signatures of functions provided by
   libpurple-client are the same as those in purple.  However, all
   structures (such as PurpleAccount) are opaque, that is, you can only
   use pointer to them.  In fact, these pointers DO NOT actually point
   to anything, they are just integer identifiers of assigned to these
   structures by purple.  So NEVER try to dereference these pointers.
   Integer ids as disguised as pointers to provide type checking and
   prevent mistakes such as passing an id of PurpleAccount when an id of
   PurpleBuddy is expected.  According to glib manual, this technique is
   portable.
*/

int main (int argc, char **argv)
{
	GList *alist, *node;

	purple_init();

	alist = purple_accounts_get_all();
	for (node = alist; node != NULL; node = node->next)
	{
		PurpleAccount *account = (PurpleAccount*) node->data;
		char *name = purple_account_get_username(account);
		g_print("Name: %s\n", name);
		g_free(name);
	}
	g_list_free(alist);

	return 0;
}

mercurial