Module Random::String
In: lib/more/facets/random.rb

Methods

Classes and Modules

Module Random::String::Self

Public Class methods

[Source]

# File lib/more/facets/random.rb, line 318
    def self.included(base)
      base.extend(Self)
    end

Public Instance methods

Return a random separation of the string. Default separation is by charaacter.

  "Ruby rules".at_rand(' ')  #=> ["Ruby"]

[Source]

# File lib/more/facets/random.rb, line 366
    def at_rand( separator=// )
      #separator = self.class.patterns( separator )
      self.split(separator,-1).at_rand
    end

Return a random separation while removing it from the string. Default separation is by character.

  s = "Ruby rules"
  s = at_rand!(' ')  #=> "Ruby"
  s                  #=> "rules"

[Source]

# File lib/more/facets/random.rb, line 378
    def at_rand!( separator=// )
      #separator = self.class.patterns( separator )
      a = self.shatter( separator )
      w = []; a.each_with_index { |s,i| i % 2 == 0 ? w << s : w.last << s }
      i = Random.number(w.size)
      r = w.delete_at( i )
      self.replace( w.join('') )
      return r
    end

Return a random byte of self.

  "Ruby rules".rand_byte  #=> 121

[Source]

# File lib/more/facets/random.rb, line 392
    def rand_byte
      self[Random.number(size)]
    end

Destructive rand_byte. Delete a random byte of self and return it.

  s = "Ruby rules"
  s.rand_byte!      #=> 121
  s                 #=> "Rub rules"

[Source]

# File lib/more/facets/random.rb, line 402
    def rand_byte!
      i = Random.number(size)
      rv = self[i,1]
      self[i,1] = ''
      rv
    end

Return a random string index.

  "Ruby rules".rand_index  #=> 3

[Source]

# File lib/more/facets/random.rb, line 413
    def rand_index
      Random.number(size)
    end

Return the string with seperated sections arranged in a random order. The default seperation is by character.

  "Ruby rules".shuffle  #=> "e lybRsuur"

[Source]

# File lib/more/facets/random.rb, line 422
    def shuffle(separator=//)
      split(separator).shuffle.join('')
    end

In place version of shuffle.

[Source]

# File lib/more/facets/random.rb, line 428
    def shuffle!(separator=//)
      self.replace( shuffle(separator) )
    end

[Validate]