summaryrefslogtreecommitdiff
path: root/doc/string/getbyte.rdoc
blob: 1d0ed2a5a488adf53b449c3a9d1dac74e8689136 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
Returns the byte at zero-based +index+ as an integer:

  s = 'foo'
  s.getbyte(0)    # => 102
  s.getbyte(1)    # => 111
  s.getbyte(2)    # => 111

Counts backward from the end if +index+ is negative:

  s.getbyte(-3) # => 102

Returns +nil+ if +index+ is out of range:

  s.getbyte(3)  # => nil
  s.getbyte(-4) # => nil

More examples:

  s = 'こんにちは'
  s.bytes      # => [227, 129, 147, 227, 130, 147, 227, 129, 171, 227, 129, 161, 227, 129, 175]
  s.getbyte(2) # => 147

Related: see {Converting to Non-String}[rdoc-ref:String@Converting+to+Non--5CString].