Class: String

Inherits:

Object

• Object
• String

show all

Defined in:

lib/ruby/to_d.rb,
lib/ruby/blank.rb,
lib/ruby/string.rb,
lib/ruby/to_time.rb,
lib/ruby/to_date.rb

Constant Summary

BIGDECIMAL =

/\A[+-]?            (?# optional leading sign            )
 (?:
   (?:\d+\.?\d*)  | (?# whole with optional decimal or ..)
   (?:\d*?\.?\d+) ) (?# optional whole with decimal      )
 (?:E[+-]?\d+)?     (?# optional exponent                )
\Z/ix

Instance Method Summary (collapse)

• - (String) at(n)

  Return the one-character string at the given index.

• - (Boolean) blank?

  True if the string is empty? or contains all whitespace.

• - (Boolean) defined_at?(n)

  True if the string is long enough such that #at is defined for the given n.

• - (String) drop(n)

  Return the string with n characters removed from the front.

• - position

  To make String compatible with the Stupidedi::Reader::Input interface, we have to define #position...

• - (Boolean) present?
• - (Array(String, String)) split_at(n)

  Split the string in two at the given position.

• - (String) take(n)

  Return the first n characters from the front.

• - (BigDecimal) to_d

  Converts the string to a BigDecimal after validating the format.

• - to_date
• - to_time

"abc".at(0)   #=> "a"
"abc".at(2)   #=> "c"

12
13
14
15

# File 'lib/ruby/string.rb', line 12

def at(n)
  raise ArgumentError, "n must be positive" if n < 0
  self[n, 1] unless n >= length
end

"abc".blank?    #=> false
"   ".blank?    #=> true
"".blank?       #=> true

10
11
12

# File 'lib/ruby/blank.rb', line 10

def blank?
  self !~ /\S/
end

"abc".defined_at?(0)  #=> true
"abc".defined_at?(3)  #=> false

64
65
66

# File 'lib/ruby/string.rb', line 64

def defined_at?(n)
  n < length
end

"abc".drop(0)   #=> "abc"
"abc".drop(2)   #=> "c"

26
27
28
29

# File 'lib/ruby/string.rb', line 26

def drop(n)
  raise ArgumentError, "n must be positive" if n < 0
  (length >= n) ? self[n..-1] : ""
end

70
71
72

# File 'lib/ruby/string.rb', line 70

def position
  nil
end

14
15
16

# File 'lib/ruby/blank.rb', line 14

def present?
  self =~ /\S/
end

"abc".split_at(0)   #=> ["", "abc"]
"abc".split_at(2)   #=> ["ab", "c"]

54
55
56

# File 'lib/ruby/string.rb', line 54

def split_at(n)
  [take(n), drop(n)]
end

"abc".take(0)   #=> ""
"abc".take(2)   #=> "ab"

40
41
42
43

# File 'lib/ruby/string.rb', line 40

def take(n)
  raise ArgumentError, "n must be positive" if n < 0
  self[0, n]
end

"1.0".to_d  #=> BigDecimal("1.0")

28
29
30
31
32
33
34

# File 'lib/ruby/to_d.rb', line 28

def to_d
  if BIGDECIMAL =~ self
    BigDecimal(to_s)
  else
    raise ArgumentError, "#{inspect} is not a valid number"
  end
end

13
14
15

# File 'lib/ruby/to_date.rb', line 13

def to_date
  Date.parse(self)
end

18
19
20

# File 'lib/ruby/to_time.rb', line 18

def to_time
  Time.parse(self)
end