Class: RLTK::CG::Function::BasicBlockCollection

Inherits:
Object
  • Object
show all
Includes:
Enumerable
Defined in:
lib/rltk/cg/function.rb

Overview

This class is used to access a function’s BasicBlocks

Instance Method Summary collapse

Constructor Details

#initialize(fun) ⇒ BasicBlockCollection

Returns a new instance of BasicBlockCollection.

Parameters:

  • fun (Function) —

    Function for which this is a proxy.



117
118
119
 
# File 'lib/rltk/cg/function.rb', line 117

def initialize(fun)
	@fun = fun
end

Instance Method Details

#append(name = '', builder = nil, context = nil, *block_args, &block) ⇒ BasicBlock

Note:

The first argument to any proc passed to this function

Add a BasicBlock to the end of this function.

will be the function the block is being appended to.

Parameters:

  • name (String) (defaults to: '') —

    Name of the block in LLVM IR.

  • builder (Builder, nil) (defaults to: nil) —

    Builder to be used in evaluating block.

  • context (Context, nil) (defaults to: nil) —

    Context in which to create the block.

  • block_args (Array<Object>) —

    Arguments to be passed to block. The function the block is appended to is automatically added to the front of this list.

  • block (Proc) —

    Block to be evaluated using builder after positioning it at the end of the new block.

Returns:



133
134
135
 
# File 'lib/rltk/cg/function.rb', line 133

def append(name = '', builder = nil, context = nil, *block_args, &block)
	BasicBlock.new(@fun, name, builder, context, @fun, *block_args, &block)
end

#each {|block| ... } ⇒ Enumerator

An iterator for each block inside this collection.

Yield Parameters:

Returns:

  • (Enumerator) —

    Returns an Enumerator if no block is given.



142
143
144
145
146
147
148
149
150
151
 
# File 'lib/rltk/cg/function.rb', line 142

def each
	return to_enum :each unless block_given?
	
	ptr = Bindings.get_first_basic_block(@fun)
	
	self.size.times do |i|
		yield BasicBlock.new(ptr)
		ptr = Bindings.get_next_basic_block(ptr)
	end
end

#entry ⇒ BasicBlock?

Returns The function’s entry block if it has been added.

Returns:

  • (BasicBlock, nil) —

    The function’s entry block if it has been added.



154
155
156
 
# File 'lib/rltk/cg/function.rb', line 154

def entry
	if (ptr = Bindings.get_entry_basic_block(@fun)) then BasicBlock.new(ptr) else nil end
end

#first ⇒ BasicBlock?

Returns The function’s first block if one has been added.

Returns:

  • (BasicBlock, nil) —

    The function’s first block if one has been added.



159
160
161
 
# File 'lib/rltk/cg/function.rb', line 159

def first
	if (ptr = Bindings.get_first_basic_block(@fun)) then BasicBlock.new(ptr) else nil end
end

#last ⇒ BasicBlock?

Returns The function’s last block if one has been added.

Returns:

  • (BasicBlock, nil) —

    The function’s last block if one has been added.



164
165
166
 
# File 'lib/rltk/cg/function.rb', line 164

def last
	if (ptr = Bindings.get_last_basic_block(@fun)) then BasicBlock.new(ptr) else nil end
end

#size ⇒ Integer

Returns Number of basic blocks that comprise this function.

Returns:

  • (Integer) —

    Number of basic blocks that comprise this function.



169
170
171
 
# File 'lib/rltk/cg/function.rb', line 169

def size
	Bindings.count_basic_blocks(@fun)
end