src/include/Eina.h

   1 /* EINA - EFL data type library
   2  * Copyright (C) 2008-2012 Enlightenment Developers:
   3  *           Albin "Lutin" Tonnerre <albin.tonnerre@gmail.com>
   4  *           Alexandre "diaxen" Becoulet <diaxen@free.fr>
   5  *           Andre Dieb <andre.dieb@gmail.com>
   6  *           Arnaud de Turckheim "quarium" <quarium@gmail.com>
   7  *           Carsten Haitzler <raster@rasterman.com>
   8  *           Cedric Bail <cedric.bail@free.fr>
   9  *           Corey "atmos" Donohoe <atmos@atmos.org>
  10  *           Fabiano Fidêncio <fidencio@profusion.mobi>
  11  *           Gustavo Chaves <glima@profusion.mobi>
  12  *           Gustavo Sverzut Barbieri <barbieri@gmail.com>
  13  *           Jorge Luis "turran" Zapata <jorgeluis.zapata@gmail.com>
  14  *           Peter "pfritz" Wehrfritz <peter.wehrfritz@web.de>
  15  *           Raphael Kubo da Costa <kubo@profusion.mobi>
  16  *           Tilman Sauerbeck <tilman@code-monkey.de>
  17  *           Vincent "caro" Torri  <vtorri at univ-evry dot fr>
  18  *           Tom Hacohen <tom@stosb.com>
  19  *           Jonas M. Gastal <jgastal@profusion.mobi>
  20  *
  21  * This library is free software; you can redistribute it and/or
  22  * modify it under the terms of the GNU Lesser General Public
  23  * License as published by the Free Software Foundation; either
  24  * version 2.1 of the License, or (at your option) any later version.
  25  *
  26  * This library is distributed in the hope that it will be useful,
  27  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  28  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  29  * Lesser General Public License for more details.
  30  *
  31  * You should have received a copy of the GNU Lesser General Public
  32  * License along with this library;
  33  * if not, see <http://www.gnu.org/licenses/>.
  34  */
  35
  36 #ifndef EINA_H_
  37 #define EINA_H_
  38
  39 /**
  40  * @file
  41  * @brief Eina Utility library
  42  *
  43  * These routines are used for Eina.
  44  */
  45
  46 /**
  47  * @mainpage Eina
  48  *
  49  * @version 1.1
  50  * @date 2008-2012
  51  *
  52  * @section eina_intro_sec Introduction
  53  *
  54  * The Eina library is a library that implements an API for data types
  55  * in an efficient way. It also provides some useful tools like
  56  * opening shared libraries, errors management, type conversion,
  57  * time accounting and memory pool.
  58  *
  59  * This library is cross-platform and can be compiled and used on
  60  * Linux, BSD, Opensolaris and Windows (XP and CE).
  61  *
  62  * The data types that are available are (see @ref Eina_Data_Types_Group):
  63  * @li @ref Eina_Inline_Array_Group standard array of inlined members.
  64  * @li @ref Eina_Array_Group standard array of @c void* data.
  65  * @li @ref Eina_Hash_Group standard hash of @c void* data.
  66  * @li @ref Eina_Inline_List_Group list with nodes inlined into user type.
  67  * @li @ref Eina_CList_Group Compact List.
  68  * @li @ref Eina_List_Group standard list of @c void* data.
  69  * @li @ref Eina_Iterator_Group Iterator functions.
  70  * @li @ref Eina_Matrixsparse_Group sparse matrix of @c void* data.
  71  * @li @ref Eina_Rbtree_Group red-black tree with nodes inlined into user type.
  72  * @li @ref Eina_String_Buffer_Group mutable string to prepend, insert or append strings to a buffer.
  73  * @li @ref Eina_Stringshare_Group saves memory by sharing read-only string references.
  74  * @li @ref Eina_Tiler_Group split, merge and navigates into 2D tiled regions.
  75  * @li @ref Eina_Trash_Group container of unused but allocated data.
  76  * @li @ref Eina_Value_Group container for generic value storage and access.
  77  * @li @ref Eina_Model_Group container for data with user defined hierarchy/structure.
  78  *
  79  * The tools that are available are (see @ref Eina_Tools_Group):
  80  * @li @ref Eina_Benchmark_Group helper to write benchmarks.
  81  * @li @ref Eina_Convert_Group faster conversion from strings to integers, double, etc.
  82  * @li @ref Eina_Counter_Group measures number of calls and their time.
  83  * @li @ref Eina_Error_Group error identifiers.
  84  * @li @ref Eina_File_Group simple file list and path split.
  85  * @li @ref Eina_Lalloc_Group simple lazy allocator.
  86  * @li @ref Eina_Log_Group full-featured logging system.
  87  * @li @ref Eina_Magic_Group provides runtime type checking.
  88  * @li @ref Eina_Memory_Pool_Group abstraction for various memory allocators.
  89  * @li @ref Eina_Module_Group lists, loads and share modules using Eina_Module standard.
  90  * @li @ref Eina_Rectangle_Group rectangle structure and standard manipulation methods.
  91  * @li @ref Eina_Safety_Checks_Group extra checks that will report unexpected conditions and can be disabled at compile time.
  92  * @li @ref Eina_String_Group a set of functions that manages C strings.
  93  *
  94  * Please see the @ref authors page for contact details.
  95  *
  96  * @defgroup Eina_Data_Types_Group Data Types
  97  *
  98  * Eina provide easy to use and optimized data types and structures.
  99  *
 100  *
 101  * @defgroup Eina_Containers_Group Containers
 102  *
 103  * Containers are data types that hold data and allow iteration over
 104  * their elements with an @ref Eina_Iterator_Group, or eventually an
 105  * @ref Eina_Accessor_Group.
 106  *
 107  * The containers in eina are designed with performance in mind, one consequence
 108  * of this is that they @b don't check the validity of data structures given to
 109  * them(@ref Eina_Magic_Group).
 110  *
 111  * The choice of which container to use in each situation is very important in
 112  * achieving good performance and readable code. The most common container types
 113  * to be used are:
 114  * @li List
 115  * @li Inline list
 116  * @li Array
 117  * @li Inline array
 118  * @li Hash
 119  *
 120  * All types have virtues and vices. The following considerations are good
 121  * starting point in deciding which container to use:
 122  * @li Hashes are appropriate for datasets which will be searched often;
 123  * @li arrays are good when accessing members by position;
 124  * @li lists provide good versatility for adding elements in any position with
 125  * minimal overhead;
 126  * @li inline arrays use very little memory and don't cause fragmentation and
 127  * therefore are a good option in memory constrained systems;
 128  * @li inline lists are the appropriate type to use when the flexibility of a
 129  * list is required but the overhead of pointer indirection is not acceptable.
 130  * @warning These are general considerations, every situation is different,
 131  * don't follow these recommendations blindly.
 132  *
 133  * @defgroup Eina_Tools_Group Tools
 134  *
 135  * Eina tools aims to help application development, providing ways to
 136  * make it safer, log errors, manage memory more efficiently and more.
 137  *
 138  */
 139
 140 /**
 141  *
 142  * @page authors Authors
 143  *
 144  * @author Albin "Lutin" Tonnerre <albin.tonnerre@@gmail.com>
 145  * @author Alexandre "diaxen" Becoulet <diaxen@@free.fr>
 146  * @author Andre Dieb <andre.dieb@@gmail.com>
 147  * @author Arnaud de Turckheim "quarium" <quarium@@gmail.com>
 148  * @author Carsten Haitzler <raster@@rasterman.com>
 149  * @author Cedric Bail <cedric.bail@@free.fr>
 150  * @author Corey "atmos" Donohoe <atmos@@atmos.org>
 151  * @author Vincent "caro" Torri  <vtorri at univ-evry dot fr>
 152  * @author Fabiano Fidêncio <fidencio@@profusion.mobi>
 153  * @author Gustavo Chaves <glima@@profusion.mobi>
 154  * @author Gustavo Sverzut Barbieri <barbieri@@profusion.mobi>
 155  * @author Jorge Luis "turran" Zapata <jorgeluis.zapata@@gmail.com>
 156  * @author Tilman Sauerbeck <tilman@@code-monkey.de>
 157  * @author Peter "pfritz" Wehrfritz <peter.wehrfritz@@web.de>
 158  * @author Raphael Kubo da Costa <kubo@@profusion.mobi>
 159  * @author Tom Hacohen <tom@@stosb.com>
 160  * @author Brett Nash <nash@@nash.id.au>
 161  * @author Sebastian Dransfeld <sd@@tango.flipp.net>
 162  * @author Myungjae Lee <mjae.lee@@samsung.com>
 163  * @author Youness Alaoui <kakaroto@@kakaroto.homelinux.net>
 164  * @author Boris "billiob" Faure <billiob@@gmail.com>
 165  * @author Sung W. Park <sungwoo@@gmail.com>
 166  * @author Guillaume Friloux <guillaume.friloux@@asp64.com>
 167  *
 168  * Please contact <enlightenment-devel@lists.sourceforge.net> to get in
 169  * contact with the developers and maintainers.
 170  *
 171  */
 172
 173 #ifdef _WIN32
 174 # include <Evil.h>
 175 #endif
 176
 177 #ifdef __cplusplus
 178 extern "C" {
 179 #endif
 180
 181 #include "eina_config.h"
 182 #include "eina_types.h"
 183 #include "eina_main.h"
 184 #include "eina_fp.h"
 185 #include "eina_rectangle.h"
 186 #include "eina_clist.h"
 187 #include "eina_inlist.h"
 188 #include "eina_file.h"
 189 #include "eina_list.h"
 190 #include "eina_hash.h"
 191 #include "eina_trash.h"
 192 #include "eina_lalloc.h"
 193 #include "eina_module.h"
 194 #include "eina_mempool.h"
 195 #include "eina_error.h"
 196 #include "eina_log.h"
 197 #include "eina_inarray.h"
 198 #include "eina_array.h"
 199 #include "eina_binshare.h"
 200 #include "eina_stringshare.h"
 201 #include "eina_ustringshare.h"
 202 #include "eina_magic.h"
 203 #include "eina_counter.h"
 204 #include "eina_rbtree.h"
 205 #include "eina_accessor.h"
 206 #include "eina_iterator.h"
 207 #include "eina_benchmark.h"
 208 #include "eina_convert.h"
 209 #include "eina_cpu.h"
 210 #include "eina_sched.h"
 211 #include "eina_tiler.h"
 212 #include "eina_hamster.h"
 213 #include "eina_matrixsparse.h"
 214 #include "eina_str.h"
 215 #include "eina_strbuf.h"
 216 #include "eina_binbuf.h"
 217 #include "eina_ustrbuf.h"
 218 #include "eina_unicode.h"
 219 #include "eina_quadtree.h"
 220 #include "eina_simple_xml_parser.h"
 221 #include "eina_lock.h"
 222 #include "eina_prefix.h"
 223 #include "eina_refcount.h"
 224 #include "eina_mmap.h"
 225 #include "eina_xattr.h"
 226 #include "eina_value.h"
 227
 228 #ifdef __cplusplus
 229 }
 230 #endif
 231
 232 #endif /* EINA_H */