spec/ruby/core/string/unpack1_spec.rb


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

require_relative '../../spec_helper'

describe "String#unpack1" do
  it "returns the first value of #unpack" do
    "ABCD".unpack1('x3C').should == "ABCD".unpack('x3C')[0]
    "\u{3042 3044 3046}".unpack1("U*").should == 0x3042
    "aG9nZWZ1Z2E=".unpack1("m").should == "hogefuga"
    "A".unpack1("B*").should == "01000001"
  end

  it "starts unpacking from the given offset" do
    "ZZABCD".unpack1('x3C', offset: 2).should == "ABCD".unpack('x3C')[0]
    "ZZZZaG9nZWZ1Z2E=".unpack1("m", offset: 4).should == "hogefuga"
    "ZA".unpack1("B*", offset: 1).should == "01000001"
  end

  it "traits offset as a bytes offset" do
    "؈".unpack("CC").should == [216, 136]
    "؈".unpack1("C").should == 216
    "؈".unpack1("C", offset: 1).should == 136
  end

  it "raises an ArgumentError when the offset is negative" do
    -> { "a".unpack1("C", offset: -1) }.should raise_error(ArgumentError, "offset can't be negative")
  end

  it "returns nil if the offset is at the end of the string" do
    "a".unpack1("C", offset: 1).should == nil
  end

  it "raises an ArgumentError when the offset is larger than the string bytesize" do
    -> { "a".unpack1("C", offset: 2) }.should raise_error(ArgumentError, "offset outside of string")
  end

  context "with format 'm0'" do
    # unpack1("m0") takes a special code path that calls Pack.unpackBase46Strict instead of Pack.unpack_m,
    # which is why we repeat the tests for unpack("m0") here.

    it "decodes base64" do
      "dGVzdA==".unpack1("m0").should == "test"
    end

    it "raises an ArgumentError for an invalid base64 character" do
      -> { "dGV%zdA==".unpack1("m0") }.should raise_error(ArgumentError)
    end
  end
end