rroonga 2.0.4 → 2.0.5

data/ext/groonga/rb-grn-type.c

@@ -49,32 +49,25 @@ rb_grn_type_to_ruby_object (grn_ctx *context, grn_obj *type,
 }
 
 /*
- * call-seq:
- *   Groonga::Type.new(name, options={})
+ * 名前が _name_ の型を作成する。
  *
- * 名前が _name_ の型を作成する。 _options_ に指定可能な値は以下の通
- * り。
- * @param options [::Hash] The name and value
- *   pairs. Omitted names are initialized as the default value
- * @option options :type (variable) The type
- *
- *   :integer（符号付き整数）、:int（:integerの省略
- *   形）、:unsigned_integer（符号なし整
- *   数）、:uint（:unsigned_integerの省略形）、:float（浮動小
- *   数点数）、:variable（可変長文字列）のいずれかを指定する。
- *   省略した場合は:variableを指定したものと扱う。
- *
- *   :variableを指定した場合は必ず +:size+ を指定しなければいけない。
- *
- * @option options :context The context
- *
- *   型の作成時に利用するGroonga::Contextを指定する。省略すると
- *   Groonga::Context.defaultを用いる。
- *
- * @option options :size The size
- *
- *   +:option+ が:variableの場合は最大長、それ以外の場合は長さを
- *   指定する(単位:byte)。
+ * @overload new(name, options={})
+ *   @param name [String] 作成する型の名前
+ *   @param options [::Hash] The name and value
+ *     pairs. Omitted names are initialized as the default value
+ *   @option options [Symbol] :type (:variable)
+ *     :integer（符号付き整数）、:int（:integerの省略
+ *     形）、:unsigned_integer（符号なし整
+ *     数）、:uint（:unsigned_integerの省略形）、:float（浮動小数点
+ *     数）、:variable（可変長文字列）のいずれかを指定する。省略した場
+ *     合は:variableを指定したものと扱う。
+ *     :variableを指定した場合は必ず +:size+ を指定しなければいけない。
+ *   @option options [Context] :context
+ *     型の作成時に利用するGroonga::Contextを指定する。省略すると
+ *     Groonga::Context.defaultを用いる。
+ *   @option options [Integer] :size
+ *     +:option+ が:variableの場合は最大長、それ以外の場合は長さを
+ *     指定する(単位:byte)。
  */
 static VALUE
 rb_grn_type_initialize (int argc, VALUE *argv, VALUE self)

data/ext/groonga/rb-grn-utils.c

@@ -106,7 +106,13 @@ rb_grn_scan_options (VALUE options, ...)
 
     options = rb_check_convert_type(options, T_HASH, "Hash", "to_hash");
     if (NIL_P(options)) {
-        options = rb_hash_new();
+	if (NIL_P(original_options)) {
+	    options = rb_hash_new();
+	} else {
+	    rb_raise(rb_eArgError,
+		     "options must be Hash: %s",
+		     rb_grn_inspect(original_options));
+	}
     } else if (options == original_options) {
         options = rb_funcall(options, rb_intern("dup"), 0);
     }
@@ -197,6 +203,22 @@ rb_grn_bulk_to_ruby_object_by_range_id (grn_ctx *context, grn_obj *bulk,
 						 GRN_TEXT_VALUE(bulk),
 						 GRN_TEXT_LEN(bulk));
 	break;
+      case GRN_DB_TOKYO_GEO_POINT:
+	{
+	    int latitude, longitude;
+
+	    GRN_GEO_POINT_VALUE(bulk, latitude, longitude);
+	    *rb_value = rb_grn_tokyo_geo_point_new(latitude, longitude);
+	}
+	break;
+      case GRN_DB_WGS84_GEO_POINT:
+	{
+	    int latitude, longitude;
+
+	    GRN_GEO_POINT_VALUE(bulk, latitude, longitude);
+	    *rb_value = rb_grn_wgs84_geo_point_new(latitude, longitude);
+	}
+	break;
       default:
 	success = GRN_FALSE;
 	break;
@@ -297,9 +319,9 @@ grn_obj *
 rb_grn_bulk_from_ruby_object (VALUE object, grn_ctx *context, grn_obj *bulk)
 {
     if (bulk && bulk->header.domain == GRN_DB_TIME)
-        return rb_grn_bulk_from_ruby_object_with_type(
-            object, context, bulk, bulk->header.domain,
-            grn_ctx_at(context, bulk->header.domain));
+        return RVAL2GRNBULK_WITH_TYPE(object, context, bulk,
+				      bulk->header.domain,
+				      grn_ctx_at(context, bulk->header.domain));
 
     if (!bulk) {
 	bulk = grn_obj_open(context, GRN_BULK, 0, GRN_ID_NIL);
@@ -398,6 +420,7 @@ rb_grn_bulk_from_ruby_object_with_type (VALUE object, grn_ctx *context,
     uint64_t uint64_value;
     int64_t time_value;
     double double_value;
+    grn_geo_point geo_point_value;
     grn_id record_id, range;
     VALUE rb_type_object;
     grn_obj_flags flags = 0;
@@ -406,9 +429,6 @@ rb_grn_bulk_from_ruby_object_with_type (VALUE object, grn_ctx *context,
     string_p = rb_type(object) == T_STRING;
     table_type_p = (GRN_TABLE_HASH_KEY <= type->header.type &&
 		    type->header.type <= GRN_TABLE_VIEW);
-    if (string_p && !table_type_p) {
-	return RVAL2GRNBULK(object, context, bulk);
-    }
 
     switch (type_id) {
       case GRN_DB_INT32:
@@ -483,6 +503,27 @@ rb_grn_bulk_from_ruby_object_with_type (VALUE object, grn_ctx *context,
 		     size, range);
 	flags |= GRN_OBJ_DO_SHALLOW_COPY;
 	break;
+      case GRN_DB_TOKYO_GEO_POINT:
+      case GRN_DB_WGS84_GEO_POINT:
+	{
+	    VALUE rb_geo_point;
+	    VALUE rb_latitude, rb_longitude;
+	    if (type_id == GRN_DB_TOKYO_GEO_POINT) {
+		rb_geo_point = rb_funcall(rb_cGrnTokyoGeoPoint,
+					  rb_intern("new"), 1, object);
+	    } else {
+		rb_geo_point = rb_funcall(rb_cGrnWGS84GeoPoint,
+					  rb_intern("new"), 1, object);
+	    }
+	    rb_geo_point = rb_funcall(rb_geo_point, rb_intern("to_msec"), 0);
+	    rb_latitude  = rb_funcall(rb_geo_point, rb_intern("latitude"), 0);
+	    rb_longitude = rb_funcall(rb_geo_point, rb_intern("longitude"), 0);
+	    geo_point_value.latitude = NUM2INT(rb_latitude);
+	    geo_point_value.longitude = NUM2INT(rb_longitude);
+	    string = (const char *)&geo_point_value;
+	    size = sizeof(geo_point_value);
+	}
+	break;
       case GRN_DB_VOID:
       case GRN_DB_DELIMIT:
       case GRN_DB_UNIGRAM:
@@ -785,6 +826,35 @@ rb_grn_key_from_ruby_object (VALUE rb_key, grn_ctx *context,
     return key;
 }
 
+grn_obj *
+rb_grn_value_from_ruby_object (VALUE object, grn_ctx *context,
+			       grn_obj *value, grn_id type_id, grn_obj *type)
+{
+    grn_bool string_p, table_type_p;
+
+    string_p = rb_type(object) == T_STRING;
+    table_type_p = (GRN_TABLE_HASH_KEY <= type->header.type &&
+		    type->header.type <= GRN_TABLE_VIEW);
+    if (!string_p) {
+	return RVAL2GRNBULK_WITH_TYPE(object, context, value, type_id, type);
+    }
+
+    if (table_type_p && RSTRING_LEN(object) == 0) {
+	if (value) {
+	    if (value->header.domain != type_id) {
+		grn_obj_reinit(context, value, type_id, 0);
+	    }
+	} else {
+	    value = grn_obj_open(context, GRN_BULK, 0, type_id);
+	    rb_grn_context_check(context, object);
+	}
+	GRN_RECORD_SET(context, value, GRN_ID_NIL);
+	return value;
+    }
+
+    return RVAL2GRNBULK(object, context, value);
+}
+
 grn_obj *
 rb_grn_obj_from_ruby_object (VALUE rb_object, grn_ctx *context, grn_obj **_obj)
 {

data/ext/groonga/rb-grn-variable-size-column.c

@@ -29,20 +29,14 @@ VALUE rb_cGrnVariableSizeColumn;
  */
 
 /*
- * Document-method: compressed?
- *
- * call-seq:
- *   column.compressed?        -> boolean
- *   column.compressed?(type)  -> boolean
- *
  * Returns whether the column is compressed or not. If
  * @type@ is specified, it returns whether the column is
  * compressed by @type@ or not.
- *
- * @return [Boolean] whether the column is compressed or not.
- * @param [:zlib, :lzo] type (nil) If @type@ isn't @nil@,
- *   it checks whether specified compressed type is used or
- *   not.
+ * @overload compressed?
+ *   @return [Boolean] whether the column is compressed or not.
+ * @overload compressed?(type)
+ *   @param [:zlib, :lzo] type (nil)
+ *   @return [Boolean] whether specified compressed type is used or not.
  * @since 1.3.1
  */
 static VALUE
@@ -103,18 +97,16 @@ rb_grn_variable_size_column_compressed_p (int argc, VALUE *argv, VALUE self)
 }
 
 /*
- * Document-method: defrag
- *
- * call-seq:
- *   column.defrag(options={}) -> n_segments
- *
  * Defrags the column.
  *
+ * @overload defrag(options={})
+ *   @param options [::Hash] The name and value
+ *     pairs. Omitted names are initialized as the default value.
+ *   @option options [Integer] :threshold (0) the threshold to
+ *     determine whether a segment is defraged. Available
+ *     values are -4..22. -4 means all segments are defraged.
+ *     22 means no segment is defraged.
  * @return [Integer] the number of defraged segments
- * @option options [Integer] :threshold (0) the threshold to
- *   determine whether a segment is defraged. Available
- *   values are -4..22. -4 means all segments are defraged.
- *   22 means no segment is defraged.
  * @since 1.2.6
  */
 static VALUE

data/ext/groonga/rb-grn-view.c

@@ -35,10 +35,6 @@ VALUE rb_cGrnView;
  */
 
 /*
- * call-seq:
- *   Groonga::View.create(options={})                -> Groonga::View
- *   Groonga::View.create(options={}) {|table| ... }
- *
  * 複数のテーブルを1つのテーブルとして扱う仮想的なテーブル
  * （ビュー）を生成する。ブロックを指定すると、そのブロック
  * に生成したテーブルが渡され、ブロックを抜けると自動的にテー
@@ -47,54 +43,63 @@ VALUE rb_cGrnView;
  * ビューにテーブルを追加するときはGroonga::View#add_tableを
  * 使う。
  *
- * _options_ に指定可能な値は以下の通り。
- * @param options [::Hash] The name and value
- *   pairs. Omitted names are initialized as the default value
- * @option options :context (Groonga::Context.default)
- *
- *   ビューが利用するGroonga::Context。
- *
- * @option options :name The view name
- *
- *   ビューの名前。名前をつけると、Groonga::Context#[]に名
- *   前を指定してビューを取得することができる。省略すると
- *   無名ビューになり、ビューIDでのみ取得できる。
+ * @example 無名一時ビューを生成する。
+ *   Groonga::View.create
  *
- * @option options :path The path
+ * @example 無名永続ビューを生成する。
+ *   Groonga::View.create(:path => "/tmp/view.grn")
  *
- *   ビューを保存するパス。パスを指定すると永続ビューとな
- *   り、プロセス終了後もレコードは保持される。次回起動時に
- *   Groonga::View.openで保存されたビューを利用することが
- *   できる。省略すると一時ビューになり、プロセスが終了する
- *   とビューは破棄される。
+ * @example 名前付き永続ビューを生成する。ただし、ファイル名は気にしない。
+ *   Groonga::View.create(:name => "Entries",
+ *                        :persistent => true)
  *
- * @option options :persistent The persistent
- *
- *   +true+ を指定すると永続ビューとなる。 +path+ を省略した
- *   場合は自動的にパスが付加される。 +:context+ で指定した
- *   Groonga::Contextに結びついているデータベースが一時デー
- *   タベースの場合は例外が発生する。
- *
- * @example
- *   無名一時ビューを生成する。
- *     Groonga::View.create
- *
- * @example
- *   無名永続ビューを生成する。
- *     Groonga::View.create(:path => "/tmp/view.grn")
- *
- * @example
- *   名前付き永続ビューを生成する。ただし、ファイル名は気に
- *   しない。
- *     Groonga::View.create(:name => "Entries",
- *                          :persistent => true)
- *
- * @example
- *   +Users+ テーブルと +Dogs+ テーブルを横断検索するための
- *   るビューを生成する。
+ * @example +Users+ テーブルと +Dogs+ テーブルを横断検索するためのビューを生成する。
  *   entries = Groonga::View.create(:name => "Entries")
  *   entries.add_table("Users")
  *   entries.add_table("Dogs")
+ *
+ * @overload create(options={})
+ *   @return [Groonga::View]
+ *   @param options [::Hash] The name and value
+ *     pairs. Omitted names are initialized as the default value
+ *   @option options :context (Groonga::Context.default)
+ *     ビューが利用するGroonga::Context。
+ *   @option options :name
+ *     ビューの名前。名前をつけると、Groonga::Context#[]に名
+ *     前を指定してビューを取得することができる。省略すると
+ *     無名ビューになり、ビューIDでのみ取得できる。
+ *   @option options :path
+ *     ビューを保存するパス。パスを指定すると永続ビューとな
+ *     り、プロセス終了後もレコードは保持される。次回起動時に
+ *     Groonga::View.openで保存されたビューを利用することが
+ *     できる。省略すると一時ビューになり、プロセスが終了する
+ *     とビューは破棄される。
+ *   @option options :persistent
+ *     +true+ を指定すると永続ビューとなる。 +path+ を省略した
+ *     場合は自動的にパスが付加される。 +:context+ で指定した
+ *     Groonga::Contextに結びついているデータベースが一時デー
+ *     タベースの場合は例外が発生する。
+ * @overload create(options={})
+ *   @yield [table]
+ *   @param options [::Hash] The name and value
+ *     pairs. Omitted names are initialized as the default value
+ *   @option options :context (Groonga::Context.default)
+ *     ビューが利用するGroonga::Context。
+ *   @option options :name
+ *     ビューの名前。名前をつけると、Groonga::Context#[]に名
+ *     前を指定してビューを取得することができる。省略すると
+ *     無名ビューになり、ビューIDでのみ取得できる。
+ *   @option options :path
+ *     ビューを保存するパス。パスを指定すると永続ビューとな
+ *     り、プロセス終了後もレコードは保持される。次回起動時に
+ *     Groonga::View.openで保存されたビューを利用することが
+ *     できる。省略すると一時ビューになり、プロセスが終了する
+ *     とビューは破棄される。
+ *   @option options :persistent
+ *     +true+ を指定すると永続ビューとなる。 +path+ を省略した
+ *     場合は自動的にパスが付加される。 +:context+ で指定した
+ *     Groonga::Contextに結びついているデータベースが一時デー
+ *     タベースの場合は例外が発生する。
  */
 static VALUE
 rb_grn_view_s_create (int argc, VALUE *argv, VALUE klass)
@@ -219,12 +224,12 @@ rb_grn_view_each (VALUE self)
 }
 
 /*
- * Document-method: column_value
- *
- * call-seq:
- *   view.column_value(id, name) -> 値
+ * _view_ の _id_ に対応するカラム _name_ のもつ値を返す。
  *
- * _view_ の _id_ に対応するカラム _name_ の値を返す。
+ * @overload column_value(id, name)
+ *   @param [String] id _view_ のもつ _id_
+ *   @param [String] name _id_ に対応するカラム名
+ * @return カラム _name_ のもつ値
  */
 static VALUE
 rb_grn_view_get_column_value (VALUE self, VALUE rb_id, VALUE rb_name)

data/ext/groonga/rb-grn.h

@@ -28,6 +28,10 @@
 #  include <ruby/intern.h>
 #endif
 
+#ifndef RETURN_ENUMERATOR
+#  define RETURN_ENUMERATOR(obj, argc, argv)
+#endif
+
 #include <groonga.h>
 
 #if defined(__cplusplus)
@@ -72,7 +76,7 @@ RB_GRN_BEGIN_DECLS
 
 #define RB_GRN_MAJOR_VERSION 2
 #define RB_GRN_MINOR_VERSION 0
-#define RB_GRN_MICRO_VERSION 4
+#define RB_GRN_MICRO_VERSION 5
 
 #define RB_GRN_QUERY_DEFAULT_MAX_EXPRESSIONS 32
 
@@ -235,6 +239,9 @@ RB_GRN_VAR VALUE rb_cGrnIndexColumn;
 RB_GRN_VAR VALUE rb_cGrnIndexCursor;
 RB_GRN_VAR VALUE rb_cGrnAccessor;
 RB_GRN_VAR VALUE rb_cGrnViewAccessor;
+RB_GRN_VAR VALUE rb_cGrnGeoPoint;
+RB_GRN_VAR VALUE rb_cGrnTokyoGeoPoint;
+RB_GRN_VAR VALUE rb_cGrnWGS84GeoPoint;
 RB_GRN_VAR VALUE rb_cGrnRecord;
 RB_GRN_VAR VALUE rb_cGrnViewRecord;
 RB_GRN_VAR VALUE rb_cGrnLogger;
@@ -277,6 +284,7 @@ void           rb_grn_init_index_cursor             (VALUE mGrn);
 void           rb_grn_init_posting                  (VALUE mGrn);
 void           rb_grn_init_accessor                 (VALUE mGrn);
 void           rb_grn_init_view_accessor            (VALUE mGrn);
+void           rb_grn_init_geo_point                (VALUE mGrn);
 void           rb_grn_init_record                   (VALUE mGrn);
 void           rb_grn_init_view_record              (VALUE mGrn);
 void           rb_grn_init_variable                 (VALUE mGrn);
@@ -497,6 +505,15 @@ void           rb_grn_expression_finalizer          (grn_ctx *context,
 VALUE          rb_grn_posting_new                   (grn_posting *posting,
 						     grn_id term_id);
 
+VALUE          rb_grn_tokyo_geo_point_new           (int   latitude,
+						     int   longitude);
+VALUE          rb_grn_wgs84_geo_point_new           (int   latitude,
+						     int   longitude);
+VALUE          rb_grn_tokyo_geo_point_new_raw       (VALUE latitude,
+						     VALUE longitude);
+VALUE          rb_grn_wgs84_geo_point_new_raw       (VALUE latitude,
+						     VALUE longitude);
+
 VALUE          rb_grn_record_new                    (VALUE table,
 						     grn_id id,
 						     VALUE values);
@@ -606,6 +623,9 @@ VALUE          rb_grn_column_expression_builder_build
     (rb_grn_key_from_ruby_object(object, context, key, domain_id,	\
 				 domain, related_object))
 
+#define RVAL2GRNVALUE(object, context, key, domain_id, domain) \
+    (rb_grn_value_from_ruby_object(object, context, key, domain_id, domain))
+
 #define GRNVARIABLE2RVAL(context, variable) \
     (rb_grn_variable_to_ruby_object(context, variable))
 #define RVAL2GRNVARIABLE(object, context) \
@@ -617,6 +637,8 @@ grn_encoding   rb_grn_encoding_from_ruby_object     (VALUE object,
 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);
+VALUE          rb_grn_encoding_to_ruby_encoding_object
+                                                    (grn_encoding encoding);
 #endif
 
 grn_ctx       *rb_grn_context_from_ruby_object      (VALUE object);
@@ -726,6 +748,11 @@ grn_obj       *rb_grn_key_from_ruby_object          (VALUE rb_key,
 						     grn_id domain_id,
 						     grn_obj *domain,
 						     VALUE related_object);
+grn_obj       *rb_grn_value_from_ruby_object        (VALUE rb_key,
+						     grn_ctx *context,
+						     grn_obj *value,
+						     grn_id domain_id,
+						     grn_obj *domain);
 
 VALUE          rb_grn_variable_to_ruby_object       (grn_ctx *context,
 						     grn_obj *variable);