SWAMPy

✎ CARVE FLESH

EDITING: buffer.rb

require 'bindata/base'
require 'bindata/dsl'

module BinData
  # A Buffer is conceptually a substream within a data stream.  It has a
  # defined size and it will always read or write the exact number of bytes to
  # fill the buffer.  Short reads will skip over unused bytes and short writes
  # will pad the substream with "\0" bytes.
  #
  #   require 'bindata'
  #
  #   obj = BinData::Buffer.new(length: 5, type: [:string, {value: "abc"}])
  #   obj.to_binary_s #=> "abc\000\000"
  #
  #
  #   class MyBuffer < BinData::Buffer
  #     default_parameter length: 8
  #
  #     endian :little
  #
  #     uint16 :num1
  #     uint16 :num2
  #     # padding occurs here
  #   end
  #
  #   obj = MyBuffer.read("\001\000\002\000\000\000\000\000")
  #   obj.num1 #=> 1
  #   obj.num1 #=> 2
  #   obj.raw_num_bytes #=> 4
  #   obj.num_bytes #=> 8
  #
  #
  #   class StringTable < BinData::Record
  #     endian :little
  #
  #     uint16 :table_size_in_bytes
  #     buffer :strings, length: :table_size_in_bytes do
  #       array read_until: :eof do
  #         uint8 :len
  #         string :str, length: :len
  #       end
  #     end
  #   end
  #     
  #
  # == Parameters
  #
  # Parameters may be provided at initialisation to control the behaviour of
  # an object.  These params are:
  #
  # <tt>:length</tt>::   The number of bytes in the buffer.
  # <tt>:type</tt>::     The single type inside the buffer.  Use a struct if
  #                      multiple fields are required.
  class Buffer < BinData::Base
    extend DSLMixin

dsl_parser    :buffer
    arg_processor :buffer

mandatory_parameters :length, :type

def initialize_instance
      @type = get_parameter(:type).instantiate(nil, self)
    end

# The number of bytes used, ignoring the padding imposed by the buffer.
    def raw_num_bytes
      @type.num_bytes
    end

def clear?
      @type.clear?
    end

def assign(val)
      @type.assign(val)
    end

def snapshot
      @type.snapshot
    end

def respond_to?(symbol, include_private = false) #:nodoc:
      @type.respond_to?(symbol, include_private) || super
    end

def method_missing(symbol, *args, &block) #:nodoc:
      @type.__send__(symbol, *args, &block)
    end

def do_read(io) #:nodoc:
      io.with_buffer(eval_parameter(:length)) do
        @type.do_read(io)
      end
    end

def do_write(io) #:nodoc:
      io.with_buffer(eval_parameter(:length)) do
        @type.do_write(io)
      end
    end

def do_num_bytes #:nodoc:
      eval_parameter(:length)
    end
  end

class BufferArgProcessor < BaseArgProcessor
    include MultiFieldArgSeparator

def sanitize_parameters!(obj_class, params)
      params.merge!(obj_class.dsl_params)
      params.must_be_integer(:length)
      params.sanitize_object_prototype(:type)
    end
  end
end

CANCEL

Name	Type	Size	Modified	Actions
↩ ..	DIR	—	—
📄 alignment.rb	RB	1.6 KB	2023-09-24 03:47	EDIT
📄 array.rb	RB	8.7 KB	2023-09-24 03:47	EDIT
📄 base.rb	RB	8.6 KB	2023-09-24 03:47	EDIT
📄 base_primitive.rb	RB	6.7 KB	2023-09-24 03:47	EDIT
📄 bits.rb	RB	4.5 KB	2023-09-24 03:47	EDIT
📄 buffer.rb	RB	2.8 KB	2023-09-24 03:47	EDIT
📄 choice.rb	RB	5.5 KB	2023-09-24 03:47	EDIT
📄 count_bytes_remaining.rb	RB	733 B	2023-09-24 03:47	EDIT
📄 delayed_io.rb	RB	5.1 KB	2023-09-24 03:47	EDIT
📄 dsl.rb	RB	13.4 KB	2023-09-24 03:47	EDIT
📄 float.rb	RB	2.1 KB	2023-09-24 03:47	EDIT
📄 framework.rb	RB	2.3 KB	2023-09-24 03:47	EDIT
📄 int.rb	RB	5.8 KB	2023-09-24 03:47	EDIT
📄 io.rb	RB	11.9 KB	2023-09-24 03:47	EDIT
📄 lazy.rb	RB	2.9 KB	2023-09-24 03:47	EDIT
📄 name.rb	RB	889 B	2023-09-24 03:47	EDIT
📄 offset.rb	RB	3 KB	2023-09-24 03:47	EDIT
📄 params.rb	RB	3.7 KB	2023-09-24 03:47	EDIT
📄 primitive.rb	RB	3.4 KB	2023-09-24 03:47	EDIT
📄 record.rb	RB	495 B	2023-09-24 03:47	EDIT
📄 registry.rb	RB	3.4 KB	2023-09-24 03:47	EDIT
📄 rest.rb	RB	669 B	2023-09-24 03:47	EDIT
📄 sanitize.rb	RB	9.3 KB	2023-09-24 03:47	EDIT
📄 skip.rb	RB	3.6 KB	2023-09-24 03:47	EDIT
📄 string.rb	RB	4.4 KB	2023-09-24 03:47	EDIT
📄 stringz.rb	RB	2.2 KB	2023-09-24 03:47	EDIT
📄 struct.rb	RB	11.6 KB	2023-09-24 03:47	EDIT
📄 trace.rb	RB	2.1 KB	2023-09-24 03:47	EDIT
📄 uint8_array.rb	RB	1.8 KB	2023-09-24 03:47	EDIT
📄 version.rb	RB	40 B	2023-09-24 03:47	EDIT
📄 virtual.rb	RB	1.2 KB	2023-09-24 03:47	EDIT
📄 warnings.rb	RB	1.2 KB	2023-09-24 03:47	EDIT