class String::Builder

• String::Builder
• IO
• Reference
• Object

Overview

Similar to IO::Memory, but optimized for building a single string.

You should never have to deal with this class. Instead, use String.build.

Defined in:

Constructors

• .new(capacity : Int = 64)
• .new(string : String)

Class Method Summary

• .build(capacity : Int = 64, &) : String

Instance Method Summary

• #back(amount : Int)

  Moves the write pointer, and the resulting string bytesize, by the given amount.

• #buffer
• #bytesize : Int32
• #capacity : Int32
• #chomp!(byte : UInt8)

  Chomps the last byte from the string buffer.

• #empty?
• #read(slice : Bytes)

  Reads at most slice.size bytes from this IO into slice.

• #to_s : String

  Returns a string representation of this object.

• #write(slice : Bytes) : Nil

  Writes the contents of slice into this IO.

• #write_byte(byte : UInt8)

  Writes a single byte into this IO.

Constructor Detail

Class Method Detail

Instance Method Detail

io = IO::Memory.new "hello"
slice = Bytes.new(4)
io.read(slice) # => 4
slice          # => Bytes[104, 101, 108, 108]
io.read(slice) # => 1
slice          # => Bytes[111, 101, 108, 108]
io.read(slice) # => 0

io = IO::Memory.new
slice = Bytes.new(4) { |i| ('a'.ord + i).to_u8 }
io.write(slice)
io.to_s # => "abcd"

io = IO::Memory.new
io.write_byte 97_u8
io.to_s # => "a"