reorder 1.1.1

data/lib/reorder.rb

@@ -0,0 +1,100 @@
+class Array
+
+	def reorder(from, to)
+		if ((from < 0 - self.length or from > self.length - 1) and (to < 0 - self.length or to > self.length - 1))
+			# 'from' and 'to' indexes are out of range (indexes can be negative)
+			raise "From and to indexes are out of range."
+		elsif from < 0 - self.length or from > self.length - 1
+			# 'from' index is out of range (indexes can be negative)
+			raise "From index is out of range."
+		elsif to < 0 - self.length or to > self.length - 1
+			# 'to' index is out of range (indexes can be negative)
+			raise "To index is out of range."
+		elsif to == from
+			# 'from' and 'to' indexes are the same so do nothing, return self
+			self
+		else
+			# copy and return reordered array
+			self.clone.reorder!(from, to)
+		end
+	end
+
+	def reorder!(from, to)
+		# flag for debug output
+		debug = false
+		
+		# if debug show arguments passed to function
+		puts "reorder(#{from}, #{to})" if debug
+
+		if ((from < 0 - self.length or from > self.length - 1) and (to < 0 - self.length or to > self.length - 1))
+			# 'from' and 'to' indexes are out of range (indexes can be negative)
+			raise "From and to indexes are out of range."
+		elsif from < 0 - self.length or from > self.length - 1
+			# 'from' index is out of range (indexes can be negative)
+			raise "From index is out of range."
+		elsif to < 0 - self.length or to > self.length - 1
+			# 'to' index is out of range (indexes can be negative)
+			raise "To index is out of range."
+		elsif to == from
+			# 'from' and 'to' indexes are the same so do nothing, return nil
+			nil
+		else
+			# reorder array
+
+			# save 'to' element for last iteration of loop below
+			temp = self[to]
+			# if debug show statement saving 'to' element 
+			puts "temp = self[#{to}]" if debug
+
+			if from < to
+				# 'from' index is less than 'to' index so loop over increasing values
+
+				# loop through increasing array indexes
+				(from..to).each_with_index do |index|
+					if index == from
+						# first iteration move 'from' element to 'to' element
+						self[to] = self[from]
+						# if debug show statement moving 'from' element to 'to' element
+						puts "first iteration self[#{to}] = self[#{from}]" if debug
+					elsif index == to
+						# last iteration move saved 'to' element next to where it originated
+						self[index - 1] = temp
+						# if debug show statement moving saved 'to' element
+						puts "last iteration self[#{index - 1}] = temp" if debug
+					else
+						# intermediate iterations move index element one element to the left
+						self[index - 1] = self[index]
+						# if debug show statement moving index element one element to the left
+						puts "intermediate iteration self[#{index - 1}] = self[#{index}]" if debug
+					end
+				end
+			else
+				# 'to' index is less than 'from' index so loop over decreasing values
+
+				# loop through decreasing array indexes
+				index = from
+				from.downto(to) do
+					if index == from
+						# first iteration move 'from' element to 'to' element
+						self[to] = self[from]
+						# if debug show statement moving 'from' element to 'to' element
+						puts "first self[#{to}] = self[#{from}]" if debug
+					elsif index == to
+						# last iteration move saved 'to' element next to where it originated
+						self[index + 1] = temp
+						# if debug show statement moving saved 'to' element
+						puts "last self[#{index + 1}] = temp" if debug
+					else
+						# intermediate iterations move index element one element to the right
+						self[index + 1] = self[index]
+						# if debug show statement moving index element one element to the right
+						puts "intermediate self[#{index + 1}] = self[#{index}]" if debug
+					end
+					index -= 1
+				end
+			end
+			# return reordered array
+			self
+		end
+	end
+end

metadata

@@ -0,0 +1,46 @@
+--- !ruby/object:Gem::Specification
+name: reorder
+version: !ruby/object:Gem::Version
+  version: 1.1.1
+  prerelease: 
+platform: ruby
+authors:
+- Chris Tsongas
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-12-21 00:00:00.000000000 Z
+dependencies: []
+description: Reorder the elements in an array by moving an element from one index
+  to another and adjusting the other elements accordingly.
+email: chris.tsongas@bitmojo.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/reorder.rb
+homepage: http://rubygems.org/gems/reorder
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Reorder Array
+test_files: []