src/monkey/gnunet_monkey_edb.h

   1 /*
   2       This file is part of GNUnet
   3       (C) 2009, 2010 Christian Grothoff (and other contributing authors)
   4
   5       GNUnet is free software; you can redistribute it and/or modify
   6       it under the terms of the GNU General Public License as published
   7       by the Free Software Foundation; either version 3, or (at your
   8       option) any later version.
   9
  10       GNUnet is distributed in the hope that it will be useful, but
  11       WITHOUT ANY WARRANTY; without even the implied warranty of
  12       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13       General Public License for more details.
  14
  15       You should have received a copy of the GNU General Public License
  16       along with GNUnet; see the file COPYING.  If not, write to the
  17       Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  18       Boston, MA 02111-1307, USA.
  19  */
  20
  21 /**
  22  * @file monkey/gnunet_monkey_edb.h
  23  * @brief Monkey API for accessing the Expression Database (edb)
  24  */
  25
  26 #ifndef GNUNET_MONKEY_EDB_H
  27 #define GNUNET_MONKEY_EDB_H
  28
  29 #ifdef __cplusplus
  30 extern "C"
  31 {
  32 #if 0                           /* keep Emacsens' auto-indent happy */
  33 }
  34 #endif
  35 #endif
  36
  37
  38 struct GNUNET_MONKEY_EDB_Context;
  39
  40 /**
  41  * Establish a connection to the Expression Database
  42  *
  43  * @param db_file_name path the Expression Database file
  44  * @return context to use for Accessing the Expression Database, NULL on error
  45  */
  46 struct GNUNET_MONKEY_EDB_Context *GNUNET_MONKEY_EDB_connect (const char
  47                                                              *db_file_name);
  48
  49
  50 /**
  51  * Disconnect from Database, and cleanup resources
  52  *
  53  * @param context context
  54  * @return GNUNET_OK on success, GNUNET_NO on failure
  55  */
  56 int GNUNET_MONKEY_EDB_disconnect (struct GNUNET_MONKEY_EDB_Context *cntxt);
  57
  58
  59 typedef int (*GNUNET_MONKEY_ExpressionIterator) (void *, int, char **,
  60                                                  char **);
  61
  62
  63 /**
  64  * Run an SQLite query to retrieve those expressions that are previous to
  65  * given expression and are in the same scope of the given expression
  66  * For example, consider the following code snippet:
  67  *
  68  * {
  69  *   struct Something whole; // line no.1
  70  *   struct SomethingElse part; // line no.2
  71  *   whole.part = &part; // line no.3
  72  *   whole.part->member = 1; // line no.4
  73  * }
  74  *
  75  * If the expression supplied to the function is that of line no.4 "whole.part->member = 1;"
  76  * The returned list of expressions will be: whole.part (line no.4), whole.part->member (line no.4),
  77  * whole (line no.3), whole.part (line no.3), &part (line no.3), whole.part = &part (line no.3)
  78  *
  79  * @param cntxt context containing the Expression Database handle.
  80  * @param file_name path to the file in which the expression in question exists
  81  * @param start_line_no expression beginning line
  82  * @param end_line_no line number for the expression's scope end
  83  * @param iter callback function, iterator for expressions returned from the Database
  84  * @param iter_cls closure for the expression iterator
  85  * @return GNUNET_OK success, GNUNET_NO failure
  86  */
  87 int
  88 GNUNET_MONKEY_EDB_get_expressions (struct GNUNET_MONKEY_EDB_Context *cntxt,
  89                                    const char *file_name, int start_line_no,
  90                                    int end_line_no,
  91                                    GNUNET_MONKEY_ExpressionIterator iter,
  92                                    void *iter_cls);
  93
  94
  95
  96 #if 0                           /* keep Emacsens' auto-indent happy */
  97 {
  98 #endif
  99 #ifdef __cplusplus
 100 }
 101 #endif
 102
 103 #endif