class StringValues < ValuesBase

  BASE_STRING = 'x'
  # Return a string of the given +length+,
  # built by trimming or extending the given +base_string+.
  # @param length [Integer] the length of the string to be returned.
  # @param base_string [String] the base string to be trimmed or extended.
  # @return [String] a string of the given length.
  # @raise [TypeError] if +length+ is not an +Integer+.
  # @raise [TypeError] if +base_string+ is not a +String+.
  # @raise [RangeError] if +length+ is negative.
  def self.string_of_length(length, base_string=BASE_STRING)
    self.verify_class('length', Integer, length)
    self.verify_class('base_string', String, base_string)
    self.verify_integer_size('length', (0..Float::INFINITY), length)
    return '' if length == 0
    s = base_string
    while s.length < length
      s = s * 2
    end
    return s[0..length-1]
  end

  # Return a hash of strings of minimum and maximum length
  # for the given +range+.
  # @param range [Range] specifies the minimum and maximum string lengths.
  # @param base_string [String] specifies the +base_string+
  # @see string_of_length string_of_length for exceptions raised.
  # @return [Hash] +Symbol+/+String+ pairs
  #    with keys +:min_length+ and +:max_length+.
  def self.strings_in_length_range(range, base_string=BASE_STRING)
    self.verify_class('range', Range, range)
    {
        :min_length => self.string_of_length(range.first, base_string),
        :max_length => self.string_of_length(range.last, base_string),
    }
  end

  # Return a hash of strings not within minimum and maximum length
  # for the given +range+.
  # @param range [Range] specifies the minimum and maximum string lengths.
  # @param base_string [String] specifies the +base_string+
  # @see string_of_length string_of_length for exceptions raised.
  # @return [Hash] +Symbol+/+String+ pairs
  #    with keys +:too_short+ and +:too_long+.
  def self.strings_not_in_length_range(range, base_string=BASE_STRING)
    self.verify_class('range', Range, range)
    {
        :too_short => self.string_of_length(range.first - 1, base_string),
        :too_long => self.string_of_length(range.last + 1, base_string),
    }
  end

end