More on pos

Author: BurdetteLamar

doc/stringio/putc.rdoc

@@ -1,27 +1,34 @@
 Replaces one or more bytes at position +pos+
 with bytes of the given argument;
+advances the position by the count of bytes written;
 returns the argument.
 
 \StringIO object for 1-byte characters.
 
   strio = StringIO.new('foo')
+  strio.pos # => 0
 
 With 1-byte argument, replaces one byte:
 
   strio.putc('b')
   strio.string    # => "boo"
+  strio.pos       # => 1
   strio.putc('a') # => "a"
   strio.string    # => "bao"
+  strio.pos       # => 2
   strio.putc('r') # => "r"
   strio.string    # => "bar"
+  strio.pos       # => 3
   strio.putc('n') # => "n"
   strio.string    # => "barn"
+  strio.pos       # => 4
 
 Fills with null characters if necessary:
 
   strio.pos = 6
   strio.putc('x') # => "x"
   strio.string    # => "barn\u0000\u0000x"
+  strio.pos       # => 7
 
 With integer argument, replaces one byte with the low-order byte of the integer:
 
@@ -46,13 +53,15 @@ With integer argument, replaces one byte with the low-order byte of the integer:
 With 1-byte argument, replaces one byte of the string:
 
   strio.putc(' ')       # 1-byte ascii space.
+  strio.pos             # => 1
   strio.string          # => " \xB1βγδε"
   strio.string.b        # => " \xB1\xCE\xB2\xCE\xB3\xCE\xB4\xCE\xB5"
   strio.string.bytesize # => 10
   strio.string.chars    # => [" ", "\xB1", "β", "γ", "δ", "ε"]
   strio.string.size     # => 6
 
   strio.putc(' ')
+  strio.pos             # => 2
   strio.string          # => "  βγδε"
   strio.string.b        # => "  \xCE\xB2\xCE\xB3\xCE\xB4\xCE\xB5"
   strio.string.bytesize # => 10
@@ -63,6 +72,7 @@ With 2-byte argument, replaces two bytes of the string:
 
   strio.rewind
   strio.putc('α')
+  strio.pos             # => 2
   strio.string          # => "αβγδε"
   strio.string.b        # => "\xCE\xB1\xCE\xB2\xCE\xB3\xCE\xB4\xCE\xB5"
   strio.string.bytesize # => 10