ruby--ruby/spec/ruby/library/stringio/getch_spec.rb

# -*- encoding: utf-8 -*-
require File.expand_path('../../../spec_helper', __FILE__)
require 'stringio'
require File.expand_path('../shared/getc', __FILE__)

# This method is added by io/console on require.
describe "StringIO#getch" do
  require 'io/console'

  it_behaves_like :stringio_getc, :getch

  it "returns the charactor at the current position" do
    io = StringIO.new("example")

    io.send(@method).should == ?e
    io.send(@method).should == ?x
    io.send(@method).should == ?a
  end

  with_feature :encoding do
    it "increments #pos by the byte size of the character in multibyte strings" do
      io = StringIO.new("föóbar")

      io.send(@method); io.pos.should == 1 # "f" has byte size 1
      io.send(@method); io.pos.should == 3 # "ö" has byte size 2
      io.send(@method); io.pos.should == 5 # "ó" has byte size 2
      io.send(@method); io.pos.should == 6 # "b" has byte size 1
    end
  end

  it "returns nil at the end of the string" do
    # empty string case
    io = StringIO.new("")
    io.send(@method).should == nil
    io.send(@method).should == nil

    # non-empty string case
    io = StringIO.new("a")
    io.send(@method) # skip one
    io.send(@method).should == nil
  end

  describe "StringIO#getch when self is not readable" do
    it_behaves_like :stringio_getc_not_readable, :getch
  end
end