class BinData::String

def sanitize_parameters!(sanitizer, params)

Ensures that +params+ is of the form expected by #initialize.
def sanitize_parameters!(sanitizer, params)
  # warn about deprecated param - remove before releasing 1.0
  if params[:initial_length]
    warn ":initial_length is deprecated. Replacing with :read_length"
    params[:read_length] = params.delete(:initial_length)
  end
  # set :pad_char to be a single length character string
  if params.has_key?(:pad_char)
    ch = params[:pad_char]
    ch = ch.respond_to?(:chr) ? ch.chr : ch.to_s
    if ch.length > 1
      raise ArgumentError, ":pad_char must not contain more than 1 char"
    end
    params[:pad_char] = ch
  end
  super(sanitizer, params)
end