summaryrefslogtreecommitdiffstats
path: root/src/arrow/ruby/red-arrow/lib/arrow/dense-union-data-type.rb
blob: 6d2bf5e70478d45984e30541179c5bed2bfbded9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
# Licensed to the Apache Software Foundation (ASF) under one
# or more contributor license agreements.  See the NOTICE file
# distributed with this work for additional information
# regarding copyright ownership.  The ASF licenses this file
# to you under the Apache License, Version 2.0 (the
# "License"); you may not use this file except in compliance
# with the License.  You may obtain a copy of the License at
#
#   http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing,
# software distributed under the License is distributed on an
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
# KIND, either express or implied.  See the License for the
# specific language governing permissions and limitations
# under the License.

module Arrow
  class DenseUnionDataType
    alias_method :initialize_raw, :initialize
    private :initialize_raw

    # Creates a new {Arrow::DenseUnionDataType}.
    #
    # @overload initialize(fields, type_codes)
    #
    #   @param fields [::Array<Arrow::Field, Hash>] The fields of the
    #     dense union data type. You can mix {Arrow::Field} and field
    #     description in the fields.
    #
    #     See {Arrow::Field.new} how to specify field description.
    #
    #   @param type_codes [::Array<Integer>] The IDs that indicates
    #     corresponding fields.
    #
    #   @example Create a dense union data type for `{2: visible, 9: count}`
    #     fields = [
    #       Arrow::Field.new("visible", :boolean),
    #       {
    #         name: "count",
    #         type: :int32,
    #       },
    #     ]
    #     Arrow::DenseUnionDataType.new(fields, [2, 9])
    #
    # @overload initialize(description)
    #
    #   @param description [Hash] The description of the dense union
    #     data type. It must have `:fields` and `:type_codes` values.
    #
    #   @option description [::Array<Arrow::Field, Hash>] :fields The
    #     fields of the dense union data type. You can mix
    #     {Arrow::Field} and field description in the fields.
    #
    #     See {Arrow::Field.new} how to specify field description.
    #
    #   @option description [::Array<Integer>] :type_codes The IDs
    #     that indicates corresponding fields.
    #
    #   @example Create a dense union data type for `{2: visible, 9: count}`
    #     fields = [
    #       Arrow::Field.new("visible", :boolean),
    #       {
    #         name: "count",
    #         type: :int32,
    #       },
    #     ]
    #     Arrow::DenseUnionDataType.new(fields: fields,
    #                                   type_codes: [2, 9])
    def initialize(*args)
      n_args = args.size
      case n_args
      when 1
        description = args[0]
        fields = description[:fields]
        type_codes = description[:type_codes]
      when 2
        fields, type_codes = args
      else
        message = "wrong number of arguments (given, #{n_args}, expected 1..2)"
        raise ArgumentError, message
      end
      fields = fields.collect do |field|
        field = Field.new(field) unless field.is_a?(Field)
        field
      end
      initialize_raw(fields, type_codes)
    end
  end
end