require_relative '../../spec_helper' describe "String#force_encoding" do it "accepts a String as the name of an Encoding" do "abc".force_encoding('shift_jis').encoding.should == Encoding::Shift_JIS end describe "with a special encoding name" do before :each do @original_encoding = Encoding.default_internal end after :each do Encoding.default_internal = @original_encoding end it "accepts valid special encoding names" do Encoding.default_internal = "US-ASCII" "abc".force_encoding("internal").encoding.should == Encoding::US_ASCII end it "defaults to BINARY if special encoding name is not set" do Encoding.default_internal = nil "abc".force_encoding("internal").encoding.should == Encoding::BINARY end end it "accepts an Encoding instance" do "abc".force_encoding(Encoding::SHIFT_JIS).encoding.should == Encoding::Shift_JIS end it "calls #to_str to convert an object to an encoding name" do obj = mock("force_encoding") obj.should_receive(:to_str).and_return("utf-8") "abc".force_encoding(obj).encoding.should == Encoding::UTF_8 end it "raises a TypeError if #to_str does not return a String" do obj = mock("force_encoding") obj.should_receive(:to_str).and_return(1) -> { "abc".force_encoding(obj) }.should raise_error(TypeError) end it "raises a TypeError if passed nil" do -> { "abc".force_encoding(nil) }.should raise_error(TypeError) end it "returns self" do str = "abc" str.force_encoding('utf-8').should equal(str) end it "sets the encoding even if the String contents are invalid in that encoding" do str = "\u{9765}" str.force_encoding('euc-jp') str.encoding.should == Encoding::EUC_JP str.valid_encoding?.should be_false end it "does not transcode self" do str = "\u{8612}" str.dup.force_encoding('utf-16le').should_not == str.encode('utf-16le') end it "raises a FrozenError if self is frozen" do str = "abcd".freeze -> { str.force_encoding(str.encoding) }.should raise_error(FrozenError) end end