Class: RLTK::CG::Value

Inherits:
Object
  • Object
show all
Includes:
BindingClass
Defined in:
lib/rltk/cg/value.rb

Overview

This class represents LLVM IR “data”, including integer and float literals, functions, and constant arrays, structs, and vectors.

Direct Known Subclasses

Argument, BasicBlock, User

Defined Under Namespace

Classes: AttrCollection

Instance Attribute Summary

Attributes included from BindingClass

#ptr

Instance Method Summary collapse

Constructor Details

#initialize(ptr) ⇒ Value

Instantiate a Value object from a pointer. This should never be done by library users, and is only used internally.

Parameters:

  • ptr (FFI::Pointer) —

    Pointer to an LLVM value.



32
33
34
 
# File 'lib/rltk/cg/value.rb', line 32

def initialize(ptr)
	@ptr = check_type(ptr, FFI::Pointer, 'ptr')
end

Instance Method Details

#==(other) ⇒ Boolean

Compare one Value to another.

Parameters:

  • other (Value) —

    Another value object.

Returns:

  • (Boolean) 


41
42
43
 
# File 'lib/rltk/cg/value.rb', line 41

def ==(other)
	other.is_a?(Value) and @ptr == other.ptr
end

#attributes ⇒ AttrCollection Also known as: attrs

Returns Proxy object for inspecing a value’s attributes.

Returns:

  • (AttrCollection) —

    Proxy object for inspecing a value’s attributes.



46
47
48
 
# File 'lib/rltk/cg/value.rb', line 46

def attributes
	@attributes ||= AttrCollection.new(@ptr)
end

#bitcast(type) ⇒ ConstantExpr

Bitcast a value to a given type.

Parameters:

  • type (Type) —

    Type to cast to.

Returns:



56
57
58
 
# File 'lib/rltk/cg/value.rb', line 56

def bitcast(type)
	ConstantExpr.new(Bindings.const_bit_cast(@ptr, check_cg_type(type)))
end

#constant? ⇒ Boolean

Returns If this value is a constant.

Returns:

  • (Boolean) —

    If this value is a constant.



61
62
63
 
# File 'lib/rltk/cg/value.rb', line 61

def constant?
	Bindings.is_constant(@ptr).to_bool
end

#dump ⇒ void

This method returns an undefined value.

Print the LLVM IR representation of this value to standard error. This function is the debugging version of the more general purpose #print method.

See Also:



72
73
74
 
# File 'lib/rltk/cg/value.rb', line 72

def dump
	Bindings.dump_value(@ptr)
end

#hash ⇒ Fixnum

Returns Hashed value of the pointer representing this value.

Returns:

  • (Fixnum) —

    Hashed value of the pointer representing this value.



77
78
79
 
# File 'lib/rltk/cg/value.rb', line 77

def hash
	@ptr.address.hash
end

#name ⇒ String

Returns Name of this value in LLVM IR.

Returns:

  • (String) —

    Name of this value in LLVM IR.



82
83
84
 
# File 'lib/rltk/cg/value.rb', line 82

def name
	Bindings.get_value_name(@ptr)
end

#name=(str) ⇒ String

Set the name of this value in LLVM IR.

Parameters:

  • str (String) —

    Name of the value in LLVM IR.

Returns:

  • (String) —

    str



91
92
93
 
# File 'lib/rltk/cg/value.rb', line 91

def name=(str)
	str.tap { Bindings.set_value_name(@ptr, check_type(str, String)) }
end

#null? ⇒ Boolean

Returns If the value is null or not.

Returns:

  • (Boolean) —

    If the value is null or not.



96
97
98
 
# File 'lib/rltk/cg/value.rb', line 96

def null?
	Bindings.is_null(@ptr).to_bool
end

#print ⇒ String

Returns LLVM IR representation of this value.

Returns:

  • (String) —

    LLVM IR representation of this value



101
102
103
 
# File 'lib/rltk/cg/value.rb', line 101

def print
	Bindings.print_value_to_string(@ptr)
end

#trunc(type) ⇒ ConstantExpr

Truncate a value to a given type.

Parameters:

  • type (Type) —

    Type to truncate to.

Returns:



110
111
112
 
# File 'lib/rltk/cg/value.rb', line 110

def trunc(type)
	ConstantExpr.new(Bindings.const_trunc(check_cg_type(type)))
end

#trunc_or_bitcast(type) ⇒ ConstantExpr

Truncate or bitcast a value to the given type as is appropriate.

Parameters:

  • type (Type) —

    Type to cast or truncate to.

Returns:



119
120
121
 
# File 'lib/rltk/cg/value.rb', line 119

def trunc_or_bitcast(type)
	ConstantExpr.new(Bindings.const_trunc_or_bit_cast(check_cg_type(type)))
end

#type ⇒ Type

Returns Type of this value.

Returns:

  • (Type) —

    Type of this value.



124
125
126
 
# File 'lib/rltk/cg/value.rb', line 124

def type
	@type ||= Type.from_ptr(Bindings.type_of(@ptr))
end

#undefined? ⇒ Boolean

Returns If the value is undefined or not.

Returns:

  • (Boolean) —

    If the value is undefined or not.



129
130
131
 
# File 'lib/rltk/cg/value.rb', line 129

def undefined?
	Bindings.is_undef(@ptr).to_bool
end

#zextend(type) ⇒ ConstantExpr

Zero extend the value to the length of type.

Parameters:

  • type (Type) —

    Type to extend the value to.

Returns:



138
139
140
 
# File 'lib/rltk/cg/value.rb', line 138

def zextend(type)
	ConstantExpr.new(Bindings.const_z_ext(check_cg_type(type)))
end

#zextend_or_bitcast(type) ⇒ ConstantExpr

Zero extend or bitcast the value to the given type as is appropriate.

Parameters:

  • type (Type) —

    Type to cast or extend to.

Returns:



147
148
149
 
# File 'lib/rltk/cg/value.rb', line 147

def zextend_or_bitcast(type)
	ConstantExpr.new(Bindings.const_z_ext_or_bit_cast(check_cg_type(type)))
end