rltk 3.0.0 → 3.0.1

data/lib/rltk/cg/basic_block.rb

@@ -23,7 +23,7 @@ module RLTK::CG
 	# BasicBlock.new or using the {Function::BasicBlockCollection#append}
 	# method.
 	class BasicBlock < Value
-		
+
 		# Create a new BasicBlock object.  The way the block is created is
 		# determined by the *overloaded* parameter.  If it is a Function
 		# object then the new block is appended to the end of the function.
@@ -41,19 +41,19 @@ module RLTK::CG
 		# @param [Proc]		block		Block to be invoked by {#build}.
 		def initialize(overloaded, name = '', builder = nil, context = nil, *block_args, &block)
 			check_type(context, Context, 'context') if context
-			
+
 			@ptr =
 			case overloaded
 			when FFI::Pointer
 				overloaded
-				
+
 			when Function
 				if context
 					Bindings.append_basic_block_in_context(context, overloaded, name)
 				else
 					Bindings.append_basic_block(overloaded, name)
 				end
-				
+
 			when BasicBlock
 				if context
 					Bindings.insert_basic_block_in_context(context, overloaded, name)
@@ -61,10 +61,10 @@ module RLTK::CG
 					Bindings.insert_basic_block(overloaded, name)
 				end
 			end
-			
+
 			self.build(builder, *block_args, &block) if block
 		end
-		
+
 		# Used to add instructions to a BasicBlock.  The block given to this
 		# method is executed inside the context of a {Builder} object, either
 		# the one passed in the *builder* parameter or one created for this
@@ -85,7 +85,7 @@ module RLTK::CG
 		def build(builder = nil, *block_args, &block)
 			if builder then builder else Builder.new end.build(self, *block_args, &block)
 		end
-		
+
 		# Creates a new BasicBlock inserted immediately before this block.
 		#
 		# @param [String]	name		Name of this BasicBlock.
@@ -95,36 +95,36 @@ module RLTK::CG
 		def insert_before(name = '', context = nil)
 			BasicBlock.new(self, name, context)
 		end
-		
+
 		# @return [InstructionCollect] Collection of all instructions inside this BasicBlock.
 		def instructions
 			@instructions ||= InstructionCollection.new(self)
 		end
-		
+
 		# @return [BasicBlock, nil] BasicBlock that occures immediately after this block or nil.
 		def next
 			if (ptr = Bindings.get_next_basic_block(@ptr)).null? then nil else BasicBlock.new(ptr) end
 		end
-		
+
 		# @return [Function] Function object that this BasicBlock belongs to.
 		def parent
 			if (ptr = Bindings.get_basic_block_parent(@ptr)).null? then nil else Function.new(ptr) end
 		end
-		
+
 		# @return [BasicBlock, nil] BasicBlock that occures immediately before this block or nil.
 		def previous
 			if (ptr = Bindings.get_previous_basic_block(@ptr)).null? then nil else BasicBlock.new(ptr) end
 		end
-		
+
 		# This class is used to access all of the {Instruction Instructions} that have been added to a {BasicBlock}.
 		class InstructionCollection
 			include Enumerable
-			
+
 			# @param [BasicBlock] bb BasicBlock this collection belongs to.
 			def initialize(bb)
 				@bb = bb
 			end
-			
+
 			# Iterate over each {Instruction} in this collection.
 			#
 			# @yieldparam inst [Instruction]
@@ -132,22 +132,22 @@ module RLTK::CG
 			# @return [Enumerator] An Enumerator is returned if no block is given.
 			def each
 				return to_enum(:each) unless block_given?
-				
+
 				inst = self.first
-				
+
 				while inst
 					yield inst
 					inst = inst.next
 				end
-				
+
 				self
 			end
-			
+
 			# @return [Instruction] First instruction in this collection.
 			def first
 				if (ptr = Bindings.get_first_instruction(@bb)).null? then nil else Instruction.from_ptr(ptr) end
 			end
-			
+
 			# @return [Instruction] Last instruction in this collection.
 			def last
 				if (ptr = Bindings.get_last_instruction(@bb)).null? then nil else Instruction.from_ptr(ptr) end

data/lib/rltk/cg/bindings.rb

@@ -27,7 +27,7 @@ require 'rltk/cg'
 #######################
 
 module RLTK::CG
-	
+
 	# This module provides access to stored FFI::Pointer objects and allows a
 	# class to be passed directly into FFI methods.  It also provides a
 	# pointer comparison method.
@@ -35,7 +35,7 @@ module RLTK::CG
 		# @return [FFI::Pointer]
 		attr_accessor :ptr
 		alias :to_ptr :ptr
-		
+
 		# Compares one BindingClass object to another.
 		#
 		# @param [BindingClass] other Another BindingClass object to compare to.
@@ -45,23 +45,23 @@ module RLTK::CG
 			self.class == other.class and @ptr == other.ptr
 		end
 	end
-	
+
 	# This module contains FFI bindings to LLVM.
 	module Bindings
 		extend FFI::Library
 		ffi_lib("LLVM-#{RLTK::LLVM_TARGET_VERSION}")
-		
+
 		# Exception that is thrown when the LLVM target version does not
 		# match the version of LLVM present on the system.
 		class LibraryMismatch < Exception; end
-	
+
 		# Require the generated bindings files while handling errors.
 		require 'rltk/cg/generated_bindings'
-	
+
 		#############
 		# Constants #
 		#############
-		
+
 		# List of architectures supported by LLVM.
 		ARCHS = [
 			:Alpha,
@@ -80,14 +80,14 @@ module RLTK::CG
 			:X86,
 			:XCore
 		]
-		
+
 		# List of assembly parsers.
 		ASM_PARSERS = [
 			:ARM,
 			:MBLaze,
 			:X86
 		]
-		
+
 		# List of assembly printers.
 		ASM_PRINTERS = [
 			:Alpha,
@@ -104,11 +104,11 @@ module RLTK::CG
 			:X86,
 			:XCore
 		]
-		
+
 		###########
 		# Methods #
 		###########
-		
+
 		# Converts a CamelCase string into an underscored string.
 		#
 		# @param [#to_s] name CamelCase string.
@@ -120,7 +120,7 @@ module RLTK::CG
 				gsub(/([a-z\d])([A-Z])/,'\1_\2').
 				downcase.to_sym
 		end
-		
+
 		# A wrapper class for FFI::Library.attach_function
 		#
 		# @param [Symbol]		func		Function name.
@@ -129,21 +129,21 @@ module RLTK::CG
 		def self.add_binding(func, args, returns)
 			attach_function(get_bname(func.to_s[4..-1]), func, args, returns)
 		end
-		
+
 		####################
 		# Missing Bindings #
 		####################
-		
+
 		ARCHS.each do |arch|
 			add_binding("LLVMInitialize#{arch}Target", [], :void)
 			add_binding("LLVMInitialize#{arch}TargetInfo", [], :void)
 			add_binding("LLVMInitialize#{arch}TargetMC", [], :void)
 		end
-		
+
 		ASM_PARSERS.each do |asm|
 			add_binding("LLVMInitialize#{asm}AsmParser", [], :void)
 		end
-		
+
 		ASM_PRINTERS.each do |asm|
 			add_binding("LLVMInitialize#{asm}AsmPrinter", [], :void)
 		end

data/lib/rltk/cg/builder.rb

@@ -16,36 +16,36 @@ require 'rltk/cg/instruction'
 #######################
 
 module RLTK::CG
-	
+
 	# This class is responsible for adding {Instruction Instructions} to {BasicBlock BasicBlocks}.
 	class Builder
 		include BindingClass
-		
+
 		# The Proc object called by the garbage collector to free resources used by LLVM.
 		CLASS_FINALIZER = Proc.new { |id| Bindings.dispose_builder(ptr) if ptr = ObjectSpace._id2ref(id).ptr }
-		
+
 		# @return [Builder] A global Builder object.
 		def self.global
 			@@global_builder ||= Builder.new
 		end
-		
+
 		# Creates a new Builder object, optionally positioning it at the end
 		# of *block*.  If a block is given it will be executed as if it was
 		# passed to the #build method.
 		#
 		# @param [BasicBlock, nil]	bb			BasicBlock used to position the Builder.
 		# @param [Array<Object>]		block_args	Arguments to be passed to *block*.
-		# @param [Proc, nil]		block		Block to execute in the context of this Builder. 
+		# @param [Proc, nil]		block		Block to execute in the context of this Builder.
 		def initialize(bb = nil, *block_args, &block)
 			@ptr = Bindings.create_builder
-			
+
 			# Define a finalizer to free the memory used by LLVM for this
 			# builder.
 			ObjectSpace.define_finalizer(self, CLASS_FINALIZER)
-			
+
 			if block then self.build(bb, *block_args, &block) elsif bb then position_at_end(bb) end
 		end
-		
+
 		# Executes a given block inside the context of this builder.  If the
 		# *bb* parameter isn't nill, the Builder will be positioned at the
 		# end of the specified BasicBlock.
@@ -59,7 +59,7 @@ module RLTK::CG
 			self.position_at_end(bb) if bb
 			self.instance_exec(*block_args, &block)
 		end
-		
+
 		# Build an instruction.
 		#
 		# @param [Symbol]		inst Name of instruction building method.
@@ -70,7 +70,7 @@ module RLTK::CG
 			self.send(inst, *args)
 		end
 		alias :'<<' :build_inst
-		
+
 		# Position the Builder after the given instruction.
 		#
 		# @param [BasicBlock]	bb
@@ -81,7 +81,7 @@ module RLTK::CG
 			Bindings.position_builder(@ptr, bb, instruction) if check_type(bb, BasicBlock, 'bb')
 			self
 		end
-		
+
 		# Position the Builder at the end of the given BasicBlock.
 		#
 		# @param [BasicBlock] bb
@@ -93,7 +93,7 @@ module RLTK::CG
 		end
 		alias :pae :position_at_end
 		alias :target :position_at_end
-		
+
 		# Position the Builder before the given Instruction.
 		#
 		# @param [Instruction] instruction
@@ -103,21 +103,21 @@ module RLTK::CG
 			Bindings.position_builder_before(@ptr, instruction)
 			self
 		end
-		
+
 		################################
 		# Instruction Building Methods #
 		################################
-		
+
 		#################
 		# Miscellaneous #
 		#################
-		
+
 		# @return [BasicBlock] BasicBlock the Builder is currently positioned on.
 		def current_block
 			BasicBlock.new(Bindings.get_insert_block(@ptr))
 		end
 		alias :insertion_block :current_block
-		
+
 		# Generates an instruction with no defined semantics. Can be used to
 		# provide hints to the optimizer.
 		#
@@ -125,37 +125,37 @@ module RLTK::CG
 		def unreachable
 			UnreachableInst.new(Bindings.build_unreachable(@ptr))
 		end
-		
+
 		###########
 		# Returns #
 		###########
-		
+
 		# @param [Value] val The Value to return.
 		#
 		# @return [ReturnInst]
 		def ret(val)
 			ReturnInst.new(Bindings.build_ret(@ptr, val))
 		end
-		
+
 		# @return [RetVoidInst]
 		def ret_void
 			ReturnVoidInst.new(Bindings.build_ret_void(@ptr))
 		end
-		
+
 		# @return [RetAggregateInst]
 		def ret_aggregate(*vals)
 			vals = vals.first if vals.length == 1 and vals.first.instance_of?(::Array)
-			
+
 			vals_ptr = FFI::MemoryPointer.new(:pointer, vals.length)
 			vals_ptr.write_array_of_pointer(vals)
-			
+
 			ReturnAggregateInst.new(Bindings.build_aggregate_ret(@ptr, vals_ptr, vals.length))
 		end
-		
+
 		################
 		# Control Flow #
 		################
-		
+
 		# Unconditional branching.
 		#
 		# @param [BasicBlock] block Where to jump.
@@ -165,7 +165,7 @@ module RLTK::CG
 			BranchInst.new(Bindings.build_br(@ptr, block))
 		end
 		alias :br :branch
-		
+
 		# Build an instruction that performs a function call.
 		#
 		# @param [Function]		fun	Function to call.
@@ -174,13 +174,13 @@ module RLTK::CG
 		# @return [CallInst]
 		def call(fun, *args)
 			name = if args.last.is_a?(String) then args.pop else '' end
-			
+
 			args_ptr = FFI::MemoryPointer.new(:pointer, args.length)
 			args_ptr.write_array_of_pointer(args)
-			
+
 			CallInst.new(Bindings.build_call(@ptr, fun, args_ptr, args.length, name))
 		end
-		
+
 		# Conditional branching.
 		#
 		# @param [Value]		val		Condition value.
@@ -192,7 +192,7 @@ module RLTK::CG
 			CondBranchInst.new(Bindings.build_cond_br(@ptr, val, iftrue, iffalse))
 		end
 		alias :cond :cond_branch
-		
+
 		# Extract an element from a vector.
 		#
 		# @param [Value]	vector	Vector from which to extract a value.
@@ -203,7 +203,7 @@ module RLTK::CG
 		def extract_element(vector, index, name = '')
 			ExtractElementInst.new(Bindings.build_extract_element(@ptr, vector, index, name))
 		end
-		
+
 		# Extract the value of a member field from an aggregate value.
 		#
 		# @param [Value]	aggregate	An aggregate value.
@@ -214,7 +214,7 @@ module RLTK::CG
 		def extract_value(aggregate, index, name = '')
 			ExtractValueInst.new(Bindings.build_extract_value(@ptr, aggregate, index, name))
 		end
-		
+
 		# Insert an element into a vector.
 		#
 		# @param [Value]	vector	Vector into which to insert the element.
@@ -226,7 +226,7 @@ module RLTK::CG
 		def insert_element(vector, element, index, name = '')
 			InsertElementInst.new(Bindings.build_insert_element(@ptr, vector, element, index, name))
 		end
-		
+
 		# Insert a value into an aggregate value's member field.
 		#
 		# @param [Value]	aggregate	An aggregate value.
@@ -238,7 +238,7 @@ module RLTK::CG
 		def insert_value(aggregate, val, index, name = '')
 			InsertValueInst.new(Bindings.build_insert_value(@ptr, aggregate, val, index, name))
 		end
-		
+
 		# Invoke a function which may potentially unwind.
 		#
 		# @param [Function]		fun 		Function to invoke.
@@ -251,7 +251,7 @@ module RLTK::CG
 		def invoke(fun, args, normal, exception, name = '')
 			InvokeInst.new(Bindings.build_invoke(@ptr, fun, args, args.length, normal, exception, name))
 		end
-		
+
 		# Build a Phi node of the given type with the given incoming
 		# branches.
 		#
@@ -267,7 +267,7 @@ module RLTK::CG
 				phi.incoming.add(incoming)
 			end
 		end
-		
+
 		# Return a value based on a condition. This differs from *cond* in
 		# that its operands are values rather than basic blocks. As a
 		# consequence, both arguments must be evaluated.
@@ -282,7 +282,7 @@ module RLTK::CG
 		def select(if_val, then_val, else_val, name = '')
 			SelectInst.new(Bindings.build_select(@ptr, if_val, then_val, else_val, name))
 		end
-		
+
 		# Shuffle two vectors according to a given mask.
 		#
 		# @param [Value]	vec1 Vector
@@ -294,7 +294,7 @@ module RLTK::CG
 		def shuffle_vector(vec1, vec2, mask, name = '')
 			ShuffleVectorInst.new(Bindings.build_shuffle_vector(@ptr, vec1, vec2, mask, name))
 		end
-		
+
 		# Select a value based on an incoming value.
 		# @param [Value]					val		Value to switch on.
 		# @param [BasicBlock]				default	Default case.
@@ -308,13 +308,13 @@ module RLTK::CG
 				cases.each { |val, block| inst.add_case(val, block) }
 			end
 		end
-		
+
 		########
 		# Math #
 		########
-		
+
 		# Addition
-		
+
 		# @param [Value]	lhs	Integer or vector of integers.
 		# @param [Value]	rhs	Integer or vector of integers.
 		# @param [String]	name	Name of the result in LLVM IR.
@@ -323,7 +323,7 @@ module RLTK::CG
 		def add(lhs, rhs, name = '')
 			AddInst.new(Bindings.build_add(@ptr, lhs, rhs, name))
 		end
-		
+
 		# @param [Value]	lhs	Floating point or vector of floating points.
 		# @param [Value]	rhs	Floating point or vector of floating points.
 		# @param [String]	name	Name of the result in LLVM IR.
@@ -332,7 +332,7 @@ module RLTK::CG
 		def fadd(lhs, rhs, name = '')
 			FAddInst.new(Bindings.build_f_add(@ptr, lhs, rhs, name))
 		end
-		
+
 		# No signed wrap addition.
 		#
 		# @param [Value]	lhs	Integer or vector of integers.
@@ -343,7 +343,7 @@ module RLTK::CG
 		def nsw_add(lhs, rhs, name = '')
 			NSWAddInst.new(Bindings.build_nsw_add(@ptr, lhs, rhs, name))
 		end
-		
+
 		# No unsigned wrap addition.
 		#
 		# @param [Value]	lhs	Integer or vector of integers.
@@ -354,9 +354,9 @@ module RLTK::CG
 		def nuw_add(lhs, rhs, name = '')
 			NUWAddInst.new(Bindings.build_nuw_add(@ptr, lhs, rhs, name))
 		end
-		
+
 		# Subtraction
-		
+
 		# @param [Value]	lhs	Integer or vector of integers.
 		# @param [Value]	rhs	Integer or vector of integers.
 		# @param [String]	name	Name of the result in LLVM IR.
@@ -365,7 +365,7 @@ module RLTK::CG
 		def sub(lhs, rhs, name = '')
 			SubInst.new(Bindings.build_sub(@ptr, lhs, rhs, name))
 		end
-		
+
 		# @param [Value]	lhs	Floating point or vector of floating points.
 		# @param [Value]	rhs	Floating point or vector of floating points.
 		# @param [String]	name	Name of the result in LLVM IR.
@@ -374,7 +374,7 @@ module RLTK::CG
 		def fsub(lhs, rhs, name = '')
 			FSubInst.new(Bindings.build_f_sub(@ptr, lhs, rhs, name))
 		end
-		
+
 		# No signed wrap subtraction.
 		#
 		# @param [Value]	lhs	Integer or vector of integers.
@@ -385,7 +385,7 @@ module RLTK::CG
 		def nsw_sub(lhs, rhs, name = '')
 			NSWSubInst.new(Bindings.build_nsw_sub(@ptr, lhs, rhs, name))
 		end
-		
+
 		# No unsigned wrap subtraction.
 		#
 		# @param [Value]	lhs	Integer or vector of integers.
@@ -396,9 +396,9 @@ module RLTK::CG
 		def nuw_sub(lhs, rhs, name = '')
 			NUWSubInst.new(Bindings.build_nuw_sub(@ptr, lhs, rhs, name))
 		end
-		
+
 		# Multiplication
-		
+
 		# @param [Value]	lhs	Integer or vector of integers.
 		# @param [Value]	rhs	Integer or vector of integers.
 		# @param [String]	name	Name of the result in LLVM IR.
@@ -407,7 +407,7 @@ module RLTK::CG
 		def mul(lhs, rhs, name = '')
 			MulInst.new(Bindings.build_mul(@ptr, lhs, rhs, name))
 		end
-		
+
 		# @param [Value]	lhs	Floating point or vector of floating points.
 		# @param [Value]	rhs	Floating point or vector of floating points.
 		# @param [String]	name	Name of the result in LLVM IR.
@@ -416,7 +416,7 @@ module RLTK::CG
 		def fmul(lhs, rhs, name = '')
 			FMulInst.new(Bindings.build_f_mul(@ptr, lhs, rhs, name))
 		end
-		
+
 		# No signed wrap multiplication.
 		#
 		# @param [Value]	lhs	Integer or vector of integers.
@@ -427,7 +427,7 @@ module RLTK::CG
 		def nsw_mul(lhs, rhs, name = '')
 			NSWMulInst.new(Bindings.build_nsw_mul(@ptr, lhs, rhs, name))
 		end
-		
+
 		# No unsigned wrap multiplication.
 		#
 		# @param [Value]	lhs	Integer or vector of integers.
@@ -438,9 +438,9 @@ module RLTK::CG
 		def nuw_mul(lhs, rhs, name = '')
 			NUWMulInst.new(Bindings.build_nuw_mul(@ptr, lhs, rhs, name))
 		end
-		
+
 		# Division
-		
+
 		# @param [Value]	lhs	Floating point or vector of floating points.
 		# @param [Value]	rhs	Floating point or vector of floating points.
 		# @param [String]	name	Name of the result in LLVM IR.
@@ -449,7 +449,7 @@ module RLTK::CG
 		def fdiv(lhs, rhs, name = '')
 			FDivInst.new(Bindings.build_f_div(@ptr, lhs, rhs, name))
 		end
-		
+
 		# Signed integer division.
 		#
 		# @param [Value]	lhs	Integer or vector of integers.
@@ -460,7 +460,7 @@ module RLTK::CG
 		def sdiv(lhs, rhs, name = '')
 			SDivInst.new(Bindings.build_s_div(@ptr, lhs, rhs, name))
 		end
-		
+
 		# Signed exact integer division.
 		#
 		# @param [Value]	lhs	Integer or vector of integers.
@@ -471,7 +471,7 @@ module RLTK::CG
 		def exact_sdiv(lhs, rhs, name = '')
 			ExactSDivInst.new(Bindings.build_exact_s_div(@ptr, lhs, rhs, name))
 		end
-		
+
 		# Unsigned integer division.
 		#
 		# @param [Value]	lhs	Integer or vector of integers.
@@ -482,9 +482,9 @@ module RLTK::CG
 		def udiv(lhs, rhs, name = '')
 			UDivInst.new(Bindings.build_u_div(@ptr, lhs, rhs, name))
 		end
-		
+
 		# Remainder
-		
+
 		# @param [Value]	lhs	Floating point or vector of floating points.
 		# @param [Value]	rhs	Floating point or vector of floating points.
 		# @param [String]	name	Name of the result in LLVM IR.
@@ -493,7 +493,7 @@ module RLTK::CG
 		def frem(lhs, rhs, name = '')
 			FRemInst.new(Bindings.build_f_rem(@ptr, lhs, rhs, name))
 		end
-		
+
 		# Signed remainder.
 		#
 		# @param [Value]	lhs	Integer or vector of integers.
@@ -504,7 +504,7 @@ module RLTK::CG
 		def srem(lhs, rhs, name = '')
 			SRemInst.new(Bindings.build_s_rem(@ptr, lhs, rhs, name))
 		end
-		
+
 		# Unsigned remainder.
 		#
 		# @param [Value]	lhs	Integer or vector of integers.
@@ -515,9 +515,9 @@ module RLTK::CG
 		def urem(lhs, rhs, name = '')
 			URemInst.new(Bindings.build_u_rem(@ptr, lhs, rhs, name))
 		end
-		
+
 		# Negation
-		
+
 		# Integer negation. Implemented as a shortcut to the equivalent sub
 		# instruction.
 		#
@@ -528,7 +528,7 @@ module RLTK::CG
 		def neg(val, name = '')
 			NegInst.new(Bindings.build_neg(@ptr, val, name))
 		end
-		
+
 		# Floating point negation. Implemented as a shortcut to the
 		# equivalent sub instruction.
 		#
@@ -539,7 +539,7 @@ module RLTK::CG
 		def fneg(val, name = '')
 			FNegInst.new(Bindings.build_f_neg(@ptr, val, name))
 		end
-		
+
 		# No signed wrap integer negation. Implemented as a shortcut to the
 		# equivalent sub instruction.
 		#
@@ -550,7 +550,7 @@ module RLTK::CG
 		def nsw_neg(val, name = '')
 			NSWNegInst.new(Bindings.build_nsw_neg(@ptr, val, name))
 		end
-		
+
 		# No unsigned wrap integer negation. Implemented as a shortcut to the
 		# equivalent sub instruction.
 		#
@@ -561,11 +561,11 @@ module RLTK::CG
 		def nuw_neg(val, name = '')
 			NUWNegInst.new(Bindings.build_nuw_neg(@ptr, val, name))
 		end
-		
+
 		######################
 		# Bitwise Operations #
 		######################
-		
+
 		# A wrapper method around the {#shift_left} and {#shift_right}
 		# methods.
 		#
@@ -582,7 +582,7 @@ module RLTK::CG
 			when :right	then shift_right(lhs, rhs, mode, name)
 			end
 		end
-		
+
 		# @param [Value]	lhs	Integer or vector of integers
 		# @param [Value]	rhs	Integer or vector of integers
 		# @param [String]	name	Name of the result in LLVM IR
@@ -592,7 +592,7 @@ module RLTK::CG
 			LeftShiftInst.new(Bindings.build_shl(@ptr, lhs, rhs, name))
 		end
 		alias :shl :shift_left
-		
+
 		# A wrapper function around {#ashr} and {#lshr}.
 		#
 		# @param [Value]				lhs	Integer or vector of integers
@@ -605,9 +605,9 @@ module RLTK::CG
 			case mode
 			when :arithmetic	then ashr(lhs, rhs, name)
 			when :logical		then lshr(lhs, rhs, name)
-			end 
+			end
 		end
-		
+
 		# Arithmetic (sign extended) shift right.
 		#
 		# @param [Value]	lhs	Integer or vector of integers.
@@ -618,7 +618,7 @@ module RLTK::CG
 		def ashr(lhs, rhs, name = '')
 			ARightShiftInst.new(Bindings.build_a_shr(@ptr, lhs, rhs, name))
 		end
-		
+
 		# Logical (zero fill) shift right.
 		#
 		# @param [Value]	lhs	Integer or vector of integers.
@@ -629,7 +629,7 @@ module RLTK::CG
 		def lshr(lhs, rhs, name = '')
 			LRightShiftInst.new(Bindings.build_l_shr(@ptr, lhs, rhs, name))
 		end
-		
+
 		# @param [Value]	lhs	Integer or vector of integers.
 		# @param [Value]	rhs	Integer or vector of integers.
 		# @param [String]	name	Name of the result in LLVM IR.
@@ -638,7 +638,7 @@ module RLTK::CG
 		def and(lhs, rhs, name = '')
 			AndInst.new(Bindings.build_and(@ptr, lhs, rhs, name))
 		end
-		
+
 		# @param [Value]	lhs	Integer or vector of integers.
 		# @param [Value]	rhs	Integer or vector of integers.
 		# @param [String]	name	Name of the result in LLVM IR.
@@ -647,7 +647,7 @@ module RLTK::CG
 		def or(lhs, rhs, name = '')
 			OrInst.new(Bindings.build_or(@ptr, lhs, rhs, name))
 		end
-		
+
 		# @param [Value]	lhs	Integer or vector of integers.
 		# @param [Value]	rhs	Integer or vector of integers.
 		# @param [String]	name	Name of the result in LLVM IR.
@@ -656,7 +656,7 @@ module RLTK::CG
 		def xor(lhs, rhs, name = '')
 			XOrInst.new(Bindings.build_xor(@ptr, lhs, rhs, name))
 		end
-		
+
 		# Boolean negation.
 		#
 		# @param [Value]	val	Integer or vector of integers.
@@ -666,11 +666,11 @@ module RLTK::CG
 		def not(val, name = '')
 			NotInst.new(Bindings.build_not(@ptr, val, name))
 		end
-		
+
 		#####################
 		# Memory Management #
 		#####################
-		
+
 		# Heap allocation.
 		#
 		# @param [Type]	type Type or value whose type should be malloced.
@@ -680,7 +680,7 @@ module RLTK::CG
 		def malloc(type, name = '')
 			MallocInst.new(Bindings.build_malloc(@ptr, check_type(type), name))
 		end
-		
+
 		# Heap array allocation.
 		#
 		# @param [Type]	type Type or value whose type will be the element type of the malloced array.
@@ -691,7 +691,7 @@ module RLTK::CG
 		def array_malloc(type, size, name = '')
 			ArrayMallocInst.new(Bindings.build_array_malloc(@ptr, check_cg_type(type), size, name))
 		end
-		
+
 		# Stack allocation.
 		#
 		# @param [Type]	type	Type or value whose type should be allocad.
@@ -701,7 +701,7 @@ module RLTK::CG
 		def alloca(type, name = '')
 			AllocaInst.new(Bindings.build_alloca(@ptr, check_cg_type(type), name))
 		end
-		
+
 		# Stack array allocation.
 		#
 		# @param [Type]	type	Type or value whose type should be allocad.
@@ -712,14 +712,14 @@ module RLTK::CG
 		def array_alloca(type, size, name = '')
 			ArrayAllocaInst.new(Bindings.build_array_alloca(@ptr, check_cg_type(type), size, name))
 		end
-		
+
 		# @param [LLVM::Value] ptr The pointer to be freed.
 		#
 		# @return [FreeInst] The result of the free instruction.
 		def free(ptr)
 			FreeInst.new(Bindings.build_free(@ptr, ptr))
 		end
-		
+
 		# Load the value of a given pointer.
 		#
 		# @param [Value]	ptr	Pointer to be loaded.
@@ -729,7 +729,7 @@ module RLTK::CG
 		def load(ptr, name = '')
 			LoadInst.new(Bindings.build_load(@ptr, ptr, name))
 		end
-		
+
 		# Store a value at a given pointer.
 		#
 		# @param [Value] val The value to be stored.
@@ -739,7 +739,7 @@ module RLTK::CG
 		def store(val, ptr)
 			StoreInst.new(Bindings.build_store(@ptr, val, ptr))
 		end
-		
+
 		# Obtain a pointer to the element at the given indices.
 		#
 		# @param [Value]		ptr		Pointer to an aggregate value
@@ -750,14 +750,14 @@ module RLTK::CG
 		# @return [GetElementPtrInst] The resulting pointer.
 		def get_element_ptr(ptr, indices, name = '')
 			check_array_type(indices, Value, 'indices')
-			
+
 			indices_ptr = FFI::MemoryPointer.new(:pointer, indices.length)
 			indices_ptr.write_array_of_pointer(indices)
-			
+
 			GetElementPtrInst.new(Bindings.build_gep(@ptr, ptr, indices_ptr, indices.length, name))
 		end
 		alias :gep :get_element_ptr
-		
+
 		# Builds a in-bounds getelementptr instruction. If the indices are
 		# outside the allocated pointer the value is undefined.
 		#
@@ -769,14 +769,14 @@ module RLTK::CG
 		# @return [InBoundsGEPInst] The resulting pointer.
 		def get_element_ptr_in_bounds(ptr, indices, name = '')
 			check_array_type(indices, Value, 'indices')
-			
+
 			indices_ptr = FFI::MemoryPointer.new(:pointer, indices.length)
 			indices_ptr.write_array_of_pointer(indices)
-			
+
 			InBoundsGEPInst.new(Bindings.build_in_bounds_gep(@ptr, ptr, indices_ptr, indices.length, name))
 		end
 		alias :inbounds_gep :get_element_ptr_in_bounds
-		
+
 		# Builds a struct getelementptr instruction.
 		#
 		# @param [Value]	ptr		Pointer to a structure.
@@ -788,7 +788,7 @@ module RLTK::CG
 			StructGEPInst.new(Bindings.build_struct_gep(@ptr, ptr, index, name))
 		end
 		alias :struct_getp :struct_get_element_ptr
-		
+
 		# Creates a global string initialized to a given value.
 		#
 		# @param [String] string	String used by the initialize.
@@ -798,7 +798,7 @@ module RLTK::CG
 		def global_string(string, name = '')
 			GlobalStringInst.new(Bindings.build_global_string(@ptr, string, name))
 		end
-		
+
 		# Creates a pointer to a global string initialized to a given value.
 		#
 		# @param [String] string	String used by the initializer
@@ -808,11 +808,11 @@ module RLTK::CG
 		def gloabl_string_pointer(string, name = '')
 			GlobalStringPtrInst.new(Bindings.build_global_string_ptr(@ptr, string, name))
 		end
-		
+
 		#######################
 		# Atomic Instructions #
 		#######################
-		
+
 		# Create an atomic read/modify/write instruction.
 		#
 		# @see http://llvm.org/docs/LangRef.html#atomic-memory-ordering-constraints
@@ -827,11 +827,11 @@ module RLTK::CG
 		def atomic_rmw(op, addr, val, ordering, single_thread)
 			AtomicRMWInst.new(Bindings.build_atomic_rmw(@ptr, op, addr, val, ordering, single_thread.to_i))
 		end
-		
+
 		###############################
 		# Type and Value Manipulation #
 		###############################
-		
+
 		# Cast a value to a given address space.
 		#
 		# @param [Value]  val   Value to cast
@@ -842,7 +842,7 @@ module RLTK::CG
 		def addr_space_cast(val, type, name = '')
 			AddrSpaceCast.new(Bindings.addr_space_cast(@ptr, val, check_cg_type(type), name))
 		end
-		
+
 		# Cast a value to the given type without changing any bits.
 		#
 		# @param [Value]   val   Value to cast
@@ -853,7 +853,7 @@ module RLTK::CG
 		def bitcast(val, type, name = '')
 			BitCastInst.new(Bindings.build_bit_cast(@ptr, val, check_cg_type(type), name))
 		end
-		
+
 		# @param [Value]	val	Value to cast.
 		# @param [Type]	type	Target type.
 		# @param [String]	name	Name of the result in LLVM IR.
@@ -863,7 +863,7 @@ module RLTK::CG
 			FPCastInst.new(Bindings.build_fp_cast(@ptr, val, check_cg_type(type), name))
 		end
 		alias :fp_cast :floating_point_cast
-		
+
 		# Extend a floating point value.
 		#
 		# @param [Value]	val	Floating point or vector of floating point.
@@ -876,7 +876,7 @@ module RLTK::CG
 		end
 		alias :fp_ext :floating_point_extend
 		alias :fp_extend :floating_point_extend
-		
+
 		# Convert a floating point to a signed integer.
 		#
 		# @param [Value]	val	Floating point or vector of floating points to convert.
@@ -888,7 +888,7 @@ module RLTK::CG
 			FPToSIInst.new(Bindings.build_fp_to_si(@ptr, val, check_cg_type(type), name))
 		end
 		alias :fp2si :floating_point_to_signed_int
-		
+
 		# Convert a floating point to an unsigned integer.
 		#
 		# @param [Value]	val	Floating point or vector of floating points to convert.
@@ -900,7 +900,7 @@ module RLTK::CG
 			FPToUIInst.new(Bindings.build_fp_to_ui(@ptr, val, check_cg_type(type), name))
 		end
 		alias :fp2ui :floating_point_to_unsigned_int
-		
+
 		# Truncate a floating point value.
 		#
 		# @param [Value]	val	Floating point or vector of floating point.
@@ -913,7 +913,7 @@ module RLTK::CG
 		end
 		alias :fp_trunc :floating_point_truncate
 		alias :fp_truncate :floating_point_truncate
-		
+
 		# Cast an int to a pointer.
 		#
 		# @param [Value]	val	An integer value.
@@ -925,7 +925,7 @@ module RLTK::CG
 			IntToPtrInst.new(Bindings.build_int_to_ptr(@ptr, val, check_cg_type(type), name))
 		end
 		alias :int2ptr :int_to_ptr
-		
+
 		# @param [Value]	val	An integer value.
 		# @param [Type]	type Integer or vector of integer target type.
 		# @param [String]	name	Name of the result in LLVM IR.
@@ -935,7 +935,7 @@ module RLTK::CG
 			IntCastInst.new(Bindings.build_int_cast(@ptr, val, check_cg_type(type), name))
 		end
 		alias :int_cast :integer_cast
-		
+
 		# @param [Value]	val	A pointer value.
 		# @param [Type]	type A pointer target type.
 		# @param [String]	name	Name of the result in LLVM IR.
@@ -944,7 +944,7 @@ module RLTK::CG
 		def ptr_cast(val, type, name = '')
 			PtrCastInst.new(Bindings.build_pointer_cast(@ptr, val, check_cg_type(type), name))
 		end
-		
+
 		# Cast a pointer to an int. Useful for pointer arithmetic.
 		#
 		# @param [Value]	val	A pointer value.
@@ -956,32 +956,32 @@ module RLTK::CG
 			PtrToIntInst.new(Bindings.build_ptr_to_int(@ptr, val, check_cg_type(type), name))
 		end
 		alias :ptr2int :ptr_to_int
-		
+
 		# Sign extension by copying the sign bit (highest order bit) of the
 		# value until it reaches the bit size of the given type.
 		#
 		# @param [Value]	val	Integer or vector of integers to be extended.
 		# @param [Type]	type	Integer or vector of integer type of greater size than the size of val.
 		# @param [String]	name	Name of the result in LLVM IR.
-		# 
+		#
 		# @return [SignExtendInst] The extended value.
 		def sign_extend(val, type, name = '')
 			SignExtendInst.new(Bindings.build_s_ext(@ptr, val, check_cg_type(type), name))
 		end
 		alias :sext :sign_extend
-		
+
 		# Sign extension or bitcast.
 		#
 		# @param [Value]	val	Integer or vector of integers to be extended.
 		# @param [Type]	type	Integer or vector of integer type of greater size than the size of val.
 		# @param [String]	name	Name of the result in LLVM IR.
-		# 
+		#
 		# @return [SignExtendOrBitcastInst] The extended or cast value.
 		def sign_extend_or_bitcast(val, type, name = '')
 			SignExtendOrBitCastInst.new(Bindings.build_s_ext_or_bit_cast(@ptr, val, check_cg_type(type), name))
 		end
 		alias :sext_or_bitcast :sign_extend_or_bitcast
-		
+
 		# Convert a signed integer to a floating point.
 		#
 		# @param [Value]	val	Signed integer or vector of signed integer to convert.
@@ -993,31 +993,31 @@ module RLTK::CG
 			SIToFPInst.new(Bindings.build_si_to_fp(@ptr, val, check_cg_type(type), name))
 		end
 		alias :si2fp :signed_int_to_floating_point
-		
+
 		# Truncates its operand to the given type. The size of the value type
 		# must be greater than the size of the target type.
 		#
 		# @param [Value]	val	Integer or vector of integers to be truncated.
 		# @param [Type]	type	Integer or vector of integers of equal size to val.
 		# @param [String]	name	Name of the result in LLVM IR.
-		# 
+		#
 		# @return [TruncateInst] The truncated value.
 		def truncate(val, type, name = '')
 			TruncateInst.new(Bindings.build_trunc(@ptr, val, check_cg_type(type), name))
 		end
 		alias :trunc :truncate
-		
+
 		# Truncates or bitcast.
 		#
 		# @param [Value]	val	Integer or vector of integers to be truncated.
 		# @param [Type]	type	Integer or vector of integers of equal size to val.
 		# @param [String]	name	Name of the result in LLVM IR.
-		# 
+		#
 		# @return [TruncateInst] The truncated or cast value.
 		def truncate_or_bitcast(val, type, name = '')
 			TruncateOrBitCastInst.new(Bindings.build_trunc_or_bit_cast(@ptr, val, check_cg_type(type), name))
 		end
-		
+
 		# Convert an unsigned integer to a floating point.
 		#
 		# @param [Value]	val	Signed integer or vector of signed integer to convert.
@@ -1029,36 +1029,36 @@ module RLTK::CG
 			UIToFPInst.new(Bindings.build_ui_to_fp(@ptr, val, check_cg_type(type), name))
 		end
 		alias :ui2fp :unsigned_int_to_floating_point
-		
+
 		# Zero extends its operand to the given type. The size of the value
 		# type must be greater than the size of the target type.
 		#
 		# @param [Value]	val	Integer or vector of integers to be extended.
 		# @param [Type]	type	Integer or vector of integer type of greater size than val.
 		# @param [String]	name	Name of the result in LLVM IR.
-		# 
+		#
 		# @return [ZeroExtendInst] The extended value.
 		def zero_extend(val, type, name = '')
 			ZeroExtendInst.new(Bindings.build_z_ext(@ptr, val, check_cg_type(type), name))
 		end
 		alias :zext :zero_extend
-		
+
 		# Zero extend or bitcast.
 		#
 		# @param [Value]	val	Integer or vector of integers to be extended.
 		# @param [Type]	type	Integer or vector of integer type of greater size than val.
 		# @param [String]	name	Name of the result in LLVM IR.
-		# 
+		#
 		# @return [ZeroExtendInst] The extended or cast value.
 		def zero_extend_or_bitcast(val, type, name = '')
 			ZeroExtendOrBitCastInst.new(Bindings.build_z_ext_or_bit_cast(@ptr, val, check_cg_type(type), name))
 		end
 		alias :zext_or_bitcast :zero_extend_or_bitcast
-		
+
 		###########################
 		# Comparison Instructions #
 		###########################
-		
+
 		# Builds an icmp instruction. Compares lhs to rhs using the given
 		# symbol predicate.
 		#
@@ -1075,7 +1075,7 @@ module RLTK::CG
 			IntCmpInst.new(Bindings.build_i_cmp(@ptr, pred, lhs, rhs, name))
 		end
 		alias :icmp :int_comparison
-		
+
 		# Builds an fcmp instruction. Compares lhs to rhs as reals using the
 		# given symbol predicate.
 		#
@@ -1092,7 +1092,7 @@ module RLTK::CG
 			FCmpInst.new(Bindings.build_f_cmp(@ptr, pred, lhs, rhs, name))
 		end
 		alias :fcmp :fp_comparison
-		
+
 		# Calculate the difference between two pointers.
 		#
 		# @param [Value]	lhs	A pointer.
@@ -1103,7 +1103,7 @@ module RLTK::CG
 		def ptr_diff(lhs, rhs, name = '')
 			PtrDiffInst.new(Bindings.build_ptr_diff(lhs, rhs, name))
 		end
-		
+
 		# Check if a value is not null.
 		#
 		# @param [Value]	val	Value to check.
@@ -1113,7 +1113,7 @@ module RLTK::CG
 		def is_not_null(val, name = '')
 			IsNotNullInst.new(Builder.build_is_not_null(@ptr, val, name))
 		end
-		
+
 		# Check if a value is null.
 		#
 		# @param [Value]	val	Value to check.