The very start of a small framework for social.
[cascardo/sgp.git] / include / sgp / group.h
diff --git a/include/sgp/group.h b/include/sgp/group.h
new file mode 100644 (file)
index 0000000..26f940a
--- /dev/null
@@ -0,0 +1,38 @@
+/*
+ *  Copyright (C) 2013  Thadeu Lima de Souza Cascardo <cascardo@cascardo.info>
+ *
+ *  This program is free software; you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation; either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License along
+ *  with this program; if not, write to the Free Software Foundation, Inc.,
+ *  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+ */
+
+#ifndef _SGP_GROUP_H
+#define _SGP_GROUP_H
+
+#include <stdlib.h> /* for NULL */
+#include <sgp/friend.h>
+
+struct sgp_group;
+
+struct sgp_group * sgp_group_new();
+int sgp_group_add_friend(struct sgp_group *, struct sgp_friend *);
+
+#define sgp_foreach_friend(group, friend, pfriend) \
+       for (pfriend = sgp_group_first(group), friend = pfriend ? *pfriend : NULL; \
+               pfriend != NULL; \
+               pfriend = sgp_group_next(group, pfriend), friend = pfriend ? *pfriend : NULL)
+
+struct sgp_friend ** sgp_group_first(struct sgp_group *);
+struct sgp_friend ** sgp_group_next(struct sgp_group *, struct sgp_friend **);
+
+#endif