diff src/gaim-client-example.c @ 11241:66f872f30e40

[gaim-migrate @ 13404] New shared library libgaim-client, which provides C bindings to communicate with gaim. committer: Tailor Script <[e-mail]>

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/gaim-client-example.c	Fri Aug 12 16:56:45 2005 +0000
@@ -0,0 +1,31 @@
+#define DBUS_API_SUBJECT_TO_CHANGE
+
+#include <stdio.h>
+#include <stdlib.h>
+
+#include "gaim-client.h"
+
+/* 
+   This example demonstrates how to use libgaim-client to communicate
+   with gaim.  The names and signatures of functions provided by
+   libgaim-client are the same as those in gaim.  However, all
+   structures (such as GaimAccount) 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 gaim.  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 GaimAccount when an id of
+   GaimBuddy is expected.  According to glib manual, this technique is
+   portable.
+*/
+
+int main (int argc, char **argv)
+{
+    GaimAccount *account;
+    gaim_init();
+    
+    account = gaim_accounts_find_any("", "");
+    g_print("Alias: %s\n", gaim_account_get_alias(account));
+
+    return 0;
+}