rroonga 0.9.2-x86-mingw32

data/ext/groonga/rb-grn.h

@@ -0,0 +1,698 @@
+/* -*- c-file-style: "ruby" -*- */
+/*
+  Copyright (C) 2009-2010  Kouhei Sutou <kou@clear-code.com>
+
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License version 2.1 as published by the Free Software Foundation.
+
+  This library 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
+  Lesser General Public License for more details.
+
+  You should have received a copy of the GNU Lesser General Public
+  License along with this library; if not, write to the Free Software
+  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+*/
+
+#ifndef __RB_GRN_H__
+#define __RB_GRN_H__
+
+#include <ruby.h>
+
+#ifdef HAVE_RUBY_ENCODING_H
+#  include <ruby/encoding.h>
+#endif
+
+#include <groonga.h>
+
+#if defined(__cplusplus)
+#  define RB_GRN_BEGIN_DECLS extern "C" {
+#  define RB_GRN_END_DECLS }
+#else
+#  define RB_GRN_BEGIN_DECLS
+#  define RB_GRN_END_DECLS
+#endif
+
+RB_GRN_BEGIN_DECLS
+
+#if __GNUC__ >= 4
+#  define RB_GRN_GNUC_NULL_TERMINATED __attribute__((__sentinel__))
+#else
+#  define RB_GRN_GNUC_NULL_TERMINATED
+#endif
+
+#if defined(RUBY_GRN_PLATFORM_WIN32) && !defined(RB_GRN_PLATFORM_WIN32)
+#  define RB_GRN_PLATFORM_WIN32 RUBY_GRN_PLATFORM_WIN32
+#endif
+
+#if defined(RUBY_GRN_STATIC_COMPILATION) && !defined(RB_GRN_STATIC_COMPILATION)
+#  define RB_GRN_STATIC_COMPILATION RUBY_GRN_STATIC_COMPILATION
+#endif
+
+#if defined(RB_GRN_PLATFORM_WIN32) && !defined(RB_GRN_STATIC_COMPILATION)
+#  ifdef RB_GRN_COMPILATION
+#    define RB_GRN_VAR __declspec(dllexport)
+#  else
+#    define RB_GRN_VAR extern __declspec(dllimport)
+#  endif
+#else
+#  define RB_GRN_VAR extern
+#endif
+
+#ifdef RB_GRN_DEBUG
+#  define debug(...) fprintf(stderr, __VA_ARGS__)
+#else
+#  define debug(...)
+#endif
+
+#define RB_GRN_MAJOR_VERSION 0
+#define RB_GRN_MINOR_VERSION 9
+#define RB_GRN_MICRO_VERSION 2
+
+typedef int rb_grn_boolean;
+#define RB_GRN_FALSE (0)
+#define RB_GRN_TRUE (!RB_GRN_FALSE)
+
+#define RB_GRN_QUERY_DEFAULT_MAX_EXPRESSIONS 32
+
+#include <stdint.h>
+
+#define RB_GRN_OBJECT(object) ((RbGrnObject *)(object))
+#define RB_GRN_NAMED_OBJECT(object) ((RbGrnNamedObject *)(object))
+#define RB_GRN_TABLE(object) ((RbGrnTable *)(object))
+#define RB_GRN_TABLE_KEY_SUPPORT(object) ((RbGrnTableKeySupport *)(object))
+#define RB_GRN_TABLE_CURSOR(object) ((RbGrnTableCursort *)(object))
+#define RB_GRN_COLUMN(object) ((RbGrnColumn *)(object))
+#define RB_GRN_INDEX_COLUMN(object) ((RbGrnIndexColumn *)(object))
+#define RB_GRN_ACCESSOR(object) ((RbGrnAccessor *)(object))
+#define RB_GRN_ACCESSOR_VIEW(object) ((RbGrnAccessor *)(object))
+#define RB_GRN_EXPRESSION(object) ((RbGrnExpression *)(object))
+#define RB_GRN_UNBIND_FUNCTION(function) ((RbGrnUnbindFunction)(function))
+
+typedef void (*RbGrnUnbindFunction) (void *object);
+
+typedef struct _RbGrnContext RbGrnContext;
+struct _RbGrnContext
+{
+    grn_ctx *context;
+    VALUE self;
+};
+
+typedef struct _RbGrnObject RbGrnObject;
+struct _RbGrnObject
+{
+    VALUE self;
+    grn_ctx *context;
+    grn_obj *object;
+    grn_obj *domain;
+    grn_id domain_id;
+    grn_obj *range;
+    grn_id range_id;
+    rb_grn_boolean need_close;
+    rb_grn_boolean have_finalizer;
+};
+
+typedef struct _RbGrnNamedObject RbGrnNamedObject;
+struct _RbGrnNamedObject
+{
+    RbGrnObject parent;
+    char *name;
+    unsigned name_size;
+};
+
+typedef struct _RbGrnTable RbGrnTable;
+struct _RbGrnTable
+{
+    RbGrnObject parent;
+    grn_obj *value;
+    VALUE columns;
+};
+
+typedef struct _RbGrnTableKeySupport RbGrnTableKeySupport;
+struct _RbGrnTableKeySupport
+{
+    RbGrnTable parent;
+    grn_obj *key;
+};
+
+typedef struct _RbGrnColumn RbGrnColumn;
+struct _RbGrnColumn
+{
+    RbGrnNamedObject parent;
+    grn_obj *value;
+};
+
+typedef struct _RbGrnIndexColumn RbGrnIndexColumn;
+struct _RbGrnIndexColumn
+{
+    RbGrnColumn parent;
+    grn_obj *old_value;
+    grn_obj *id_query;
+    grn_obj *string_query;
+};
+
+typedef struct _RbGrnAccessor RbGrnAccessor;
+struct _RbGrnAccessor
+{
+    RbGrnNamedObject parent;
+};
+
+typedef struct _RbGrnTableCursor RbGrnTableCursor;
+struct _RbGrnTableCursor
+{
+    RbGrnObject parent;
+};
+
+typedef struct _RbGrnVariable RbGrnVariable;
+struct _RbGrnVariable
+{
+    RbGrnObject parent;
+};
+
+typedef struct _RbGrnExpression RbGrnExpression;
+struct _RbGrnExpression
+{
+    RbGrnObject parent;
+    grn_obj *value;
+};
+
+RB_GRN_VAR rb_grn_boolean rb_grn_exited;
+
+RB_GRN_VAR VALUE rb_eGrnError;
+RB_GRN_VAR VALUE rb_eGrnObjectClosed;
+RB_GRN_VAR VALUE rb_eGrnNoSuchColumn;
+RB_GRN_VAR VALUE rb_eGrnInvalidArgument;
+RB_GRN_VAR VALUE rb_cGrnObject;
+RB_GRN_VAR VALUE rb_mGrnEncodingSupport;
+RB_GRN_VAR VALUE rb_cGrnDatabase;
+RB_GRN_VAR VALUE rb_cGrnTable;
+RB_GRN_VAR VALUE rb_mGrnTableKeySupport;
+RB_GRN_VAR VALUE rb_cGrnHash;
+RB_GRN_VAR VALUE rb_cGrnPatriciaTrie;
+RB_GRN_VAR VALUE rb_cGrnArray;
+RB_GRN_VAR VALUE rb_cGrnView;
+RB_GRN_VAR VALUE rb_cGrnTableCursor;
+RB_GRN_VAR VALUE rb_mGrnTableCursorKeySupport;
+RB_GRN_VAR VALUE rb_cGrnHashCursor;
+RB_GRN_VAR VALUE rb_cGrnPatriciaTrieCursor;
+RB_GRN_VAR VALUE rb_cGrnViewCursor;
+RB_GRN_VAR VALUE rb_cGrnArrayCursor;
+RB_GRN_VAR VALUE rb_cGrnType;
+RB_GRN_VAR VALUE rb_cGrnProcedure;
+RB_GRN_VAR VALUE rb_cGrnColumn;
+RB_GRN_VAR VALUE rb_cGrnFixSizeColumn;
+RB_GRN_VAR VALUE rb_cGrnVariableSizeColumn;
+RB_GRN_VAR VALUE rb_cGrnIndexColumn;
+RB_GRN_VAR VALUE rb_cGrnAccessor;
+RB_GRN_VAR VALUE rb_cGrnViewAccessor;
+RB_GRN_VAR VALUE rb_cGrnRecord;
+RB_GRN_VAR VALUE rb_cGrnViewRecord;
+RB_GRN_VAR VALUE rb_cGrnQuery;
+RB_GRN_VAR VALUE rb_cGrnLogger;
+RB_GRN_VAR VALUE rb_cGrnSnippet;
+RB_GRN_VAR VALUE rb_cGrnVariable;
+RB_GRN_VAR VALUE rb_cGrnOperation;
+RB_GRN_VAR VALUE rb_cGrnExpression;
+RB_GRN_VAR VALUE rb_cGrnRecordExpressionBuilder;
+RB_GRN_VAR VALUE rb_cGrnColumnExpressionBuilder;
+
+void           rb_grn_init_utils                    (VALUE mGrn);
+void           rb_grn_init_exception                (VALUE mGrn);
+void           rb_grn_init_encoding                 (VALUE mGrn);
+void           rb_grn_init_encoding_support         (VALUE mGrn);
+void           rb_grn_init_context                  (VALUE mGrn);
+void           rb_grn_init_object                   (VALUE mGrn);
+void           rb_grn_init_database                 (VALUE mGrn);
+void           rb_grn_init_table                    (VALUE mGrn);
+void           rb_grn_init_table_key_support        (VALUE mGrn);
+void           rb_grn_init_array                    (VALUE mGrn);
+void           rb_grn_init_hash                     (VALUE mGrn);
+void           rb_grn_init_patricia_trie            (VALUE mGrn);
+void           rb_grn_init_view                     (VALUE mGrn);
+void           rb_grn_init_table_cursor             (VALUE mGrn);
+void           rb_grn_init_table_cursor_key_support (VALUE mGrn);
+void           rb_grn_init_array_cursor             (VALUE mGrn);
+void           rb_grn_init_hash_cursor              (VALUE mGrn);
+void           rb_grn_init_patricia_trie_cursor     (VALUE mGrn);
+void           rb_grn_init_view_cursor              (VALUE mGrn);
+void           rb_grn_init_type                     (VALUE mGrn);
+void           rb_grn_init_procedure                (VALUE mGrn);
+void           rb_grn_init_column                   (VALUE mGrn);
+void           rb_grn_init_fix_size_column          (VALUE mGrn);
+void           rb_grn_init_variable_size_column     (VALUE mGrn);
+void           rb_grn_init_index_column             (VALUE mGrn);
+void           rb_grn_init_accessor                 (VALUE mGrn);
+void           rb_grn_init_view_accessor            (VALUE mGrn);
+void           rb_grn_init_record                   (VALUE mGrn);
+void           rb_grn_init_view_record              (VALUE mGrn);
+void           rb_grn_init_query                    (VALUE mGrn);
+void           rb_grn_init_variable                 (VALUE mGrn);
+void           rb_grn_init_operation                (VALUE mGrn);
+void           rb_grn_init_expression               (VALUE mGrn);
+void           rb_grn_init_expression_builder       (VALUE mGrn);
+void           rb_grn_init_logger                   (VALUE mGrn);
+void           rb_grn_init_snippet                  (VALUE mGrn);
+
+VALUE          rb_grn_rc_to_exception               (grn_rc rc);
+const char    *rb_grn_rc_to_message                 (grn_rc rc);
+void           rb_grn_rc_check                      (grn_rc rc,
+						     VALUE related_object);
+
+void           rb_grn_context_fin                   (grn_ctx *context);
+grn_ctx       *rb_grn_context_ensure                (VALUE *context);
+VALUE          rb_grn_context_get_default           (void);
+VALUE          rb_grn_context_to_exception          (grn_ctx *context,
+						     VALUE related_object);
+void           rb_grn_context_check                 (grn_ctx *context,
+						     VALUE related_object);
+grn_obj       *rb_grn_context_get_backward_compatibility
+                                                    (grn_ctx *context,
+						     const char *name,
+						     unsigned int name_size);
+
+const char    *rb_grn_inspect                       (VALUE object);
+void           rb_grn_scan_options                  (VALUE options, ...)
+                                                     RB_GRN_GNUC_NULL_TERMINATED;
+rb_grn_boolean rb_grn_equal_option                  (VALUE option,
+						     const char *key);
+
+VALUE          rb_grn_object_alloc                  (VALUE klass);
+void           rb_grn_object_bind                   (VALUE self,
+						     VALUE rb_context,
+						     RbGrnObject *rb_grn_object,
+						     grn_ctx *context,
+						     grn_obj *object);
+void           rb_grn_object_free                   (RbGrnObject *rb_grn_object);
+void           rb_grn_object_assign                 (VALUE klass,
+						     VALUE self,
+						     VALUE rb_context,
+						     grn_ctx *context,
+						     grn_obj *object);
+void           rb_grn_object_deconstruct            (RbGrnObject *rb_grn_object,
+						     grn_obj **object,
+						     grn_ctx **context,
+						     grn_id *domain_id,
+						     grn_obj **domain,
+						     grn_id *range_id,
+						     grn_obj **range);
+
+VALUE          rb_grn_object_get_id                 (VALUE object);
+VALUE          rb_grn_object_array_reference        (VALUE object,
+						     VALUE rb_id);
+VALUE          rb_grn_object_set_raw                (RbGrnObject *rb_grn_object,
+						     grn_id id,
+						     VALUE rb_value,
+						     int flags,
+						     VALUE related_object);
+VALUE          rb_grn_object_close                  (VALUE object);
+VALUE          rb_grn_object_closed_p               (VALUE object);
+VALUE          rb_grn_object_inspect_object         (VALUE inspected,
+						     grn_ctx *context,
+						     grn_obj *object);
+VALUE          rb_grn_object_inspect_object_content (VALUE inspected,
+						     grn_ctx *context,
+						     grn_obj *object);
+VALUE          rb_grn_object_inspect_header         (VALUE object,
+						     VALUE inspected);
+VALUE          rb_grn_object_inspect_content        (VALUE object,
+						     VALUE inspected);
+VALUE          rb_grn_object_inspect_footer         (VALUE object,
+						     VALUE inspected);
+
+void           rb_grn_named_object_bind             (RbGrnNamedObject *rb_grn_named_object,
+						     grn_ctx *context,
+						     grn_obj *object);
+void           rb_grn_named_object_finalizer        (grn_ctx *context,
+						     grn_obj *column,
+						     RbGrnNamedObject *rb_grn_named_object);
+void           rb_grn_named_object_set_name         (RbGrnNamedObject *rb_grn_named_object,
+						     const char *name,
+						     unsigned name_size);
+
+void           rb_grn_table_bind                    (RbGrnTable *rb_grn_table,
+						     grn_ctx *context,
+						     grn_obj *table_key_support);
+void           rb_grn_table_finalizer               (grn_ctx *context,
+						     grn_obj *grn_object,
+						     RbGrnTable *rb_grn_table);
+void           rb_grn_table_deconstruct             (RbGrnTable *rb_grn_table,
+						     grn_obj **table,
+						     grn_ctx **context,
+						     grn_id *domain_id,
+						     grn_obj **domain,
+						     grn_obj **value,
+						     grn_id *range_id,
+						     grn_obj **range,
+						     VALUE *columns);
+
+VALUE          rb_grn_table_delete                  (VALUE self,
+						     VALUE rb_id);
+VALUE          rb_grn_table_array_reference         (VALUE self,
+						     VALUE rb_id);
+VALUE          rb_grn_table_array_set               (VALUE self,
+						     VALUE rb_id,
+						     VALUE rb_value);
+VALUE          rb_grn_table_get_value               (VALUE self,
+						     VALUE rb_id);
+VALUE          rb_grn_table_set_value               (VALUE self,
+						     VALUE rb_id,
+						     VALUE rb_value);
+VALUE          rb_grn_table_get_column              (VALUE self,
+						     VALUE rb_name);
+VALUE          rb_grn_table_get_column_surely       (VALUE self,
+						     VALUE rb_name);
+VALUE          rb_grn_table_get_column_value_raw    (VALUE self,
+						     grn_id id,
+						     VALUE rb_name);
+VALUE          rb_grn_table_get_column_value        (VALUE self,
+						     VALUE rb_id,
+						     VALUE rb_name);
+VALUE          rb_grn_table_set_column_value_raw    (VALUE self,
+						     grn_id id,
+						     VALUE rb_name,
+						     VALUE rb_value);
+VALUE          rb_grn_table_set_column_value        (VALUE self,
+						     VALUE rb_id,
+						     VALUE rb_name,
+						     VALUE rb_value);
+
+grn_ctx       *rb_grn_table_cursor_ensure_context   (VALUE cursor,
+						     VALUE *rb_context);
+
+void           rb_grn_table_key_support_bind        (RbGrnTableKeySupport *rb_grn_table_key_support,
+						     grn_ctx *context,
+						     grn_obj *table_key_support);
+void           rb_grn_table_key_support_finalizer   (grn_ctx *context,
+						     grn_obj *grn_object,
+						     RbGrnTableKeySupport *rb_grn_table_key_support);
+void           rb_grn_table_key_support_deconstruct (RbGrnTableKeySupport *rb_grn_table_key_support,
+						     grn_obj **table_key_support,
+						     grn_ctx **context,
+						     grn_obj **key,
+						     grn_id *domain_id,
+						     grn_obj **domain,
+						     grn_obj **value,
+						     grn_id *range_id,
+						     grn_obj **range,
+						     VALUE *columns);
+grn_id         rb_grn_table_key_support_get         (VALUE self,
+						     VALUE rb_key);
+
+void           rb_grn_column_bind                   (RbGrnColumn *rb_grn_column,
+						     grn_ctx *context,
+						     grn_obj *column);
+void           rb_grn_column_finalizer              (grn_ctx *context,
+						     grn_obj *column,
+						     RbGrnColumn *rb_grn_column);
+void           rb_grn_column_deconstruct            (RbGrnColumn *rb_grn_column,
+						     grn_obj **column,
+						     grn_ctx **context,
+						     grn_id *domain_id,
+						     grn_obj **domain,
+						     grn_obj **value,
+						     grn_id *range_id,
+						     grn_obj **range);
+
+void           rb_grn_index_column_bind             (RbGrnIndexColumn *rb_grn_index_column,
+						     grn_ctx *context,
+						     grn_obj *object);
+void           rb_grn_index_column_finalizer        (grn_ctx *context,
+						     grn_obj *grn_object,
+						     RbGrnIndexColumn *rb_grn_index_column);
+void           rb_grn_index_column_deconstruct      (RbGrnIndexColumn *rb_grn_index_column,
+						     grn_obj **column,
+						     grn_ctx **context,
+						     grn_id *domain_id,
+						     grn_obj **domain,
+						     grn_obj **value,
+						     grn_obj **old_value,
+						     grn_id *range_id,
+						     grn_obj **range,
+						     grn_obj **id_query,
+						     grn_obj **string_query);
+
+void           rb_grn_accessor_bind                 (RbGrnAccessor *rb_grn_accessor,
+						     grn_ctx *context,
+						     grn_obj *accessor);
+void           rb_grn_accessor_finalizer            (grn_ctx *context,
+						     grn_obj *accessor,
+						     RbGrnAccessor *rb_grn_accessor);
+
+void           rb_grn_expression_bind               (RbGrnExpression *rb_grn_expression,
+						     grn_ctx *context,
+						     grn_obj *expression);
+void           rb_grn_expression_finalizer          (grn_ctx *context,
+						     grn_obj *grn_object,
+						     RbGrnExpression *rb_grn_expression);
+
+VALUE          rb_grn_record_new                    (VALUE table,
+						     grn_id id,
+						     VALUE values);
+VALUE          rb_grn_record_new_raw                (VALUE table,
+						     VALUE id,
+						     VALUE values);
+
+VALUE          rb_grn_view_record_new               (VALUE    view,
+						     grn_obj *id);
+VALUE          rb_grn_view_record_new_raw           (VALUE view,
+						     VALUE id);
+
+VALUE          rb_grn_record_expression_builder_new (VALUE table,
+						     VALUE name);
+VALUE          rb_grn_record_expression_builder_build
+                                                    (VALUE self);
+VALUE          rb_grn_column_expression_builder_new (VALUE column,
+						     VALUE name,
+						     VALUE query);
+VALUE          rb_grn_column_expression_builder_build
+                                                    (VALUE self);
+
+
+#define RB_GRN_INTERN(string)         (ID2SYM(rb_intern(string)))
+
+#define RVAL2CBOOL(object)            (RTEST(object))
+#define CBOOL2RVAL(boolean)           ((boolean) ? Qtrue : Qfalse)
+
+#define RVAL2GRNENCODING(object, context) \
+                                      (rb_grn_encoding_from_ruby_object(object, context))
+#define GRNENCODING2RVAL(encoding)    (rb_grn_encoding_to_ruby_object(encoding))
+
+#define RVAL2GRNCONTEXT(object)       (rb_grn_context_from_ruby_object(object))
+#define GRNCONTEXT2RVAL(context)      (rb_grn_context_to_ruby_object(context))
+
+#define RVAL2GRNOBJECT(rb_object, context) \
+                                      (rb_grn_object_from_ruby_object(rb_object, context))
+#define GRNOBJECT2RVAL(klass, context, object, owner) \
+    (rb_grn_object_to_ruby_object(klass, context, object, owner))
+#define GRNOBJECT2RCLASS(object)      (rb_grn_object_to_ruby_class(object))
+
+/* TODO: MORE BETTER NAME!!! PLEASE!!! */
+#define RVAL2GRNOBJ(rb_object, context, object)	\
+    (rb_grn_obj_from_ruby_object(rb_object, context, object))
+#define GRNOBJ2RVAL(klass, context, object, related_object)	\
+    (rb_grn_obj_to_ruby_object(klass, context, object, related_object))
+
+#define RVAL2GRNDB(object)            (rb_grn_database_from_ruby_object(object))
+#define GRNDB2RVAL(context, db, owner) \
+    (rb_grn_database_to_ruby_object(context, db, owner))
+
+#define RVAL2GRNTABLE(object, context)(rb_grn_table_from_ruby_object(object, context))
+#define GRNTABLE2RVAL(context, table, owner) \
+    (rb_grn_table_to_ruby_object(context, table, owner))
+
+#define RVAL2GRNTABLECURSOR(object)   (rb_grn_table_cursor_from_ruby_object(object))
+#define GRNTABLECURSOR2RVAL(klass, context, cursor) \
+    (rb_grn_table_cursor_to_ruby_object(klass, context, cursor, RB_GRN_TRUE))
+#define GRNTABLECURSOR2RCLASS(object) (rb_grn_table_cursor_to_ruby_class(object))
+
+#define RVAL2GRNCOLUMN(object, context) \
+    (rb_grn_column_from_ruby_object(object, context))
+#define GRNCOLUMN2RVAL(klass, context, column, owner) \
+    (rb_grn_column_to_ruby_object(klass, context, column, owner))
+
+#define RVAL2GRNQUERY(object)         (rb_grn_query_from_ruby_object(object))
+#define GRNQUERY2RVAL(context, column)(rb_grn_query_to_ruby_object(context, column))
+
+#define RVAL2GRNOPERATOR(object)      (rb_grn_operator_from_ruby_object(object))
+
+#define RVAL2GRNLOGGER(object)        (rb_grn_logger_from_ruby_object(object))
+
+#define RVAL2GRNBULK(object, context, bulk) \
+    (rb_grn_bulk_from_ruby_object(object, context, bulk))
+#define RVAL2GRNBULK_WITH_TYPE(object, context, bulk, type_id, type)	\
+    (rb_grn_bulk_from_ruby_object_with_type(object, context, bulk, type_id, type))
+#define GRNBULK2RVAL(context, bulk, range, related_object)	\
+    (rb_grn_bulk_to_ruby_object(context, bulk, range, related_object))
+
+#define RVAL2GRNVECTOR(object, context, vector)	\
+    (rb_grn_vector_from_ruby_object(object, context, vector))
+#define GRNVECTOR2RVAL(context, vector) \
+    (rb_grn_vector_to_ruby_object(context, vector))
+
+#define RVAL2GRNUVECTOR(object, context, uvector, related_object)	\
+    (rb_grn_uvector_from_ruby_object(object, context, uvector, related_object))
+#define GRNUVECTOR2RVAL(context, uvector) \
+    (rb_grn_uvector_to_ruby_object(context, uvector))
+
+#define GRNVALUE2RVAL(context, value, range, related_object) \
+    (rb_grn_value_to_ruby_object(context, value, range, related_object))
+
+#define RVAL2GRNID(object, context, table, related_object) \
+    (rb_grn_id_from_ruby_object(object, context, table, related_object))
+
+#define GRNKEY2RVAL(context, key, key_size, table, related_object) \
+    (rb_grn_key_to_ruby_object(context, key, key_size, table, related_object))
+#define RVAL2GRNKEY(object, context, key, domain_id, domain, related_object) \
+    (rb_grn_key_from_ruby_object(object, context, key, domain_id,	\
+				 domain, related_object))
+
+#define GRNVARIABLE2RVAL(context, variable) \
+    (rb_grn_variable_to_ruby_object(context, variable))
+#define RVAL2GRNVARIABLE(object, context) \
+    (rb_grn_variable_from_ruby_object(object, context))
+
+#define GRNSNIPPET2RVAL(context, snippet, owner)		\
+    (rb_grn_snippet_to_ruby_object(context, snippet, owner))
+#define RVAL2GRNSNIPPET(snippet) \
+    (rb_grn_snippet_from_ruby_object(snippet))
+
+
+grn_encoding   rb_grn_encoding_from_ruby_object     (VALUE object,
+						     grn_ctx *context);
+VALUE          rb_grn_encoding_to_ruby_object       (grn_encoding encoding);
+#ifdef HAVE_RUBY_ENCODING_H
+rb_encoding   *rb_grn_encoding_to_ruby_encoding     (grn_encoding encoding);
+#endif
+
+grn_ctx       *rb_grn_context_from_ruby_object      (VALUE object);
+VALUE          rb_grn_context_to_ruby_object        (grn_ctx *context);
+VALUE          rb_grn_context_rb_string_new         (grn_ctx *context,
+						     const char *string,
+						     long length);
+VALUE          rb_grn_context_rb_string_encode      (grn_ctx *context,
+						     VALUE rb_string);
+void           rb_grn_context_text_set              (grn_ctx *context,
+						     grn_obj *bulk,
+						     VALUE rb_string);
+
+grn_obj       *rb_grn_object_from_ruby_object       (VALUE object,
+						     grn_ctx **context);
+VALUE          rb_grn_object_to_ruby_object         (VALUE klass,
+						     grn_ctx *context,
+						     grn_obj *object,
+						     rb_grn_boolean owner);
+VALUE          rb_grn_object_to_ruby_class          (grn_obj *object);
+
+grn_obj       *rb_grn_database_from_ruby_object     (VALUE object);
+VALUE          rb_grn_database_to_ruby_object       (grn_ctx *context,
+						     grn_obj *db,
+						     rb_grn_boolean owner);
+
+grn_obj       *rb_grn_table_from_ruby_object        (VALUE object,
+						     grn_ctx **context);
+VALUE          rb_grn_table_to_ruby_object          (grn_ctx *context,
+						     grn_obj *table,
+						     rb_grn_boolean owner);
+
+grn_table_cursor *
+               rb_grn_table_cursor_from_ruby_object (VALUE object,
+						     grn_ctx **context);
+VALUE          rb_grn_table_cursor_to_ruby_object   (VALUE klass,
+						     grn_ctx *context,
+						     grn_table_cursor *cursor,
+						     rb_grn_boolean owner);
+VALUE          rb_grn_table_cursor_to_ruby_class    (grn_table_cursor *cursor);
+void           rb_grn_table_cursor_deconstruct      (RbGrnTableCursor *rb_grn_table_cursor,
+						     grn_table_cursor **cursor,
+						     grn_ctx **context,
+						     grn_id *domain_id,
+						     grn_obj **domain,
+						     grn_id *range_id,
+						     grn_obj **range);
+
+grn_obj       *rb_grn_column_from_ruby_object       (VALUE object,
+						     grn_ctx **context);
+VALUE          rb_grn_column_to_ruby_object         (VALUE klass,
+						     grn_ctx *context,
+						     grn_obj *column,
+						     rb_grn_boolean owner);
+
+grn_query     *rb_grn_query_from_ruby_object        (VALUE object);
+VALUE          rb_grn_query_to_ruby_object          (grn_ctx *context,
+						     grn_query *query);
+
+grn_operator   rb_grn_operator_from_ruby_object     (VALUE object);
+
+grn_logger_info *
+               rb_grn_logger_from_ruby_object       (VALUE object);
+
+grn_obj       *rb_grn_bulk_from_ruby_object         (VALUE object,
+						     grn_ctx *context,
+						     grn_obj *bulk);
+grn_obj       *rb_grn_bulk_from_ruby_object_with_type
+                                                    (VALUE object,
+						     grn_ctx *context,
+						     grn_obj *bulk,
+						     grn_id type_id,
+						     grn_obj *type);
+VALUE          rb_grn_bulk_to_ruby_object           (grn_ctx *context,
+						     grn_obj *bulk,
+						     grn_obj *range,
+						     VALUE related_object);
+grn_obj       *rb_grn_vector_from_ruby_object       (VALUE object,
+						     grn_ctx *context,
+						     grn_obj *vector);
+VALUE          rb_grn_vector_to_ruby_object         (grn_ctx *context,
+						     grn_obj *vector);
+grn_obj       *rb_grn_uvector_from_ruby_object      (VALUE object,
+						     grn_ctx *context,
+						     grn_obj *uvector,
+						     VALUE related_object);
+VALUE          rb_grn_uvector_to_ruby_object        (grn_ctx *context,
+						     grn_obj *uvector);
+
+VALUE          rb_grn_value_to_ruby_object          (grn_ctx *context,
+						     grn_obj *value,
+						     grn_obj *range,
+						     VALUE related_object);
+
+grn_id         rb_grn_id_from_ruby_object           (VALUE object,
+						     grn_ctx *context,
+						     grn_obj *table,
+						     VALUE related_object);
+
+VALUE          rb_grn_key_to_ruby_object            (grn_ctx *context,
+						     const void *key,
+						     int key_size,
+						     grn_obj *table,
+						     VALUE related_object);
+grn_obj       *rb_grn_key_from_ruby_object          (VALUE rb_key,
+						     grn_ctx *context,
+						     grn_obj *key,
+						     grn_id domain_id,
+						     grn_obj *domain,
+						     VALUE related_object);
+
+VALUE          rb_grn_variable_to_ruby_object       (grn_ctx *context,
+						     grn_obj *variable);
+grn_obj       *rb_grn_variable_from_ruby_object     (VALUE rb_variable,
+						     grn_ctx **context);
+
+grn_obj       *rb_grn_obj_from_ruby_object          (VALUE rb_object,
+						     grn_ctx *context,
+						     grn_obj **obj);
+VALUE          rb_grn_obj_to_ruby_object            (VALUE klass,
+						     grn_ctx *context,
+						     grn_obj *obj,
+						     VALUE related_object);
+
+grn_snip      *rb_grn_snippet_from_ruby_object      (VALUE rb_snippet);
+VALUE          rb_grn_snippet_to_ruby_object        (grn_ctx *context,
+						     grn_snip *snippet,
+						     rb_grn_boolean owner);
+
+RB_GRN_END_DECLS
+
+#endif