Class: GObjectIntrospection::IBaseInfo

Inherits:
Object
  • Object
show all
Defined in:
lib/ffi-gobject_introspection/i_base_info.rb

Overview

Wraps GIBaseInfo struct, the base type for all info types. Decendant types will be implemented as needed.

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(ptr, lib = Lib) ⇒ IBaseInfo

Returns a new instance of IBaseInfo.

Raises:

  • (ArgumentError) 


6
7
8
9
10
11
12
13
 
# File 'lib/ffi-gobject_introspection/i_base_info.rb', line 6

def initialize(ptr, lib = Lib)
  raise ArgumentError, 'ptr must not be null' if ptr.null?

  ObjectSpace.define_finalizer self, self.class.make_finalizer(lib, ptr)

  @gobj = ptr
  @lib = lib
end

Class Method Details

.build_array_method(method, single = nil) ⇒ Object

This is a helper method to construct a method returning an array, out of the methods returning their number and the individual elements.

For example, given the methods n_foos and foo(i), this method will create an additional method foos returning all foos.

Provide the second parameter if the plural is not trivially constructed by adding s to the singular.

Examples:

build_array_method :fields
build_array_mehtod :properties, :property
build_array_method :get_methods



38
39
40
41
42
43
44
45
46
47
48
49
 
# File 'lib/ffi-gobject_introspection/i_base_info.rb', line 38

def self.build_array_method(method, single = nil)
  method = method.to_s
  single ||= method.to_s[0..-2]
  count = method.sub(/^(get_)?/, '\\1n_')
  class_eval <<-CODE
    def #{method}
      (0..(#{count} - 1)).map do |i|
        #{single} i
      end
    end
  CODE
end

.build_finder_method(method, counter = nil, fetcher = nil) ⇒ Object

This is a helper method to construct a method for finding an element, out of the methods returning their number and the individual elements.

For example, given the methods n_foos and foo(i), this method will create an additional method find_foo returning the foo with the matching name.

Optionally provide counter and fetcher methods if they cannot be trivially derived from the finder method.

Examples:

build_finder_method :find_field
build_finder_method :find_property, :n_properties
build_finder_method :find_method, :get_n_methods, :get_method



67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
 
# File 'lib/ffi-gobject_introspection/i_base_info.rb', line 67

def self.build_finder_method(method, counter = nil, fetcher = nil)
  method = method.to_s
  single = method.sub(/^find_/, '')
  counter ||= "n_#{single}s"
  fetcher ||= single
  class_eval <<-CODE
    def #{method}(name)
      name = name.to_s
      #{counter}.times do |i|
        it = #{fetcher}(i)
        return it if it.name == name
      end
      nil
    end
  CODE
end

.make_finalizer(lib, ptr) ⇒ Object 



15
16
17
 
# File 'lib/ffi-gobject_introspection/i_base_info.rb', line 15

def self.make_finalizer(lib, ptr)
  proc { lib.g_base_info_unref ptr }
end

.wrap(ptr) ⇒ Object 



114
115
116
 
# File 'lib/ffi-gobject_introspection/i_base_info.rb', line 114

def self.wrap(ptr)
  new ptr unless ptr.null?
end

Instance Method Details

#==(other) ⇒ Object 



118
119
120
 
# File 'lib/ffi-gobject_introspection/i_base_info.rb', line 118

def ==(other)
  other.is_a?(IBaseInfo) && Lib.g_base_info_equal(@gobj, other)
end

#attribute(name) ⇒ Object 



110
111
112
 
# File 'lib/ffi-gobject_introspection/i_base_info.rb', line 110

def attribute(name)
  Lib.g_base_info_get_attribute @gobj, name
end

#container ⇒ Object 



100
101
102
103
104
 
# File 'lib/ffi-gobject_introspection/i_base_info.rb', line 100

def container
  ptr = Lib.g_base_info_get_container @gobj
  Lib.g_base_info_ref ptr
  IRepository.wrap_ibaseinfo_pointer ptr
end

#deprecated? ⇒ Boolean

Returns:

  • (Boolean) 


106
107
108
 
# File 'lib/ffi-gobject_introspection/i_base_info.rb', line 106

def deprecated?
  Lib.g_base_info_is_deprecated @gobj
end

#info_type ⇒ Object 



88
89
90
 
# File 'lib/ffi-gobject_introspection/i_base_info.rb', line 88

def info_type
  Lib.g_base_info_get_type @gobj
end

#name ⇒ Object 



84
85
86
 
# File 'lib/ffi-gobject_introspection/i_base_info.rb', line 84

def name
  Lib.g_base_info_get_name @gobj
end

#namespace ⇒ Object 



92
93
94
 
# File 'lib/ffi-gobject_introspection/i_base_info.rb', line 92

def namespace
  Lib.g_base_info_get_namespace @gobj
end

#safe_namespace ⇒ Object 



96
97
98
 
# File 'lib/ffi-gobject_introspection/i_base_info.rb', line 96

def safe_namespace
  namespace.gsub(/^./, &:upcase)
end

#to_ptr ⇒ Object 



19
20
21
 
# File 'lib/ffi-gobject_introspection/i_base_info.rb', line 19

def to_ptr
  @gobj
end