Class: PacketGen::Types::IntString

Inherits:
Object
  • Object
show all
Includes:
Fieldable
Defined in:
lib/packetgen/types/int_string.rb

Overview

Provides a class for creating strings preceeded by their length as a Int. By default, a null string will have one byte length (length byte set to 0).

Author:

  • Sylvain Daubert

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Fieldable

#format_inspect, #type_name

Constructor Details

#initialize(len_type = Int8, string: '') ⇒ IntString

Returns a new instance of IntString.

Parameters:

  • len_type (Class) (defaults to: Int8) —

    should be a PacketGen::Types::Int subclass

  • string (::String) (defaults to: '') 


24
25
26
27
28
 
# File 'lib/packetgen/types/int_string.rb', line 24

def initialize(len_type=Int8, string: '')
  @string = Types::String.new.read(string)
  @length = len_type.new
  calc_length
end

Instance Attribute Details

#string ⇒ String

internal string

Returns:



20
21
22
 
# File 'lib/packetgen/types/int_string.rb', line 20

def string
  @string
end

Instance Method Details

#calc_length ⇒ Integer

Set length from internal string length

Returns:

  • (Integer) 


85
86
87
 
# File 'lib/packetgen/types/int_string.rb', line 85

def calc_length
  @length.read @string.length
end

#empty? ⇒ Boolean

Say if IntString is empty

Returns:

  • (Boolean) 


97
98
99
 
# File 'lib/packetgen/types/int_string.rb', line 97

def empty?
  length.zero?
end

#from_human(str) ⇒ self

Set from a human readable string

Parameters:

Returns:

  • (self) 


70
71
72
73
74
 
# File 'lib/packetgen/types/int_string.rb', line 70

def from_human(str)
  @string.read str
  calc_length
  self
end

#length ⇒ Integer

Returns:

  • (Integer) 


50
51
52
 
# File 'lib/packetgen/types/int_string.rb', line 50

def length
  @length.to_i
end

#length=(len) ⇒ Integer

Parameters:

  • len (Integer)

Returns:

  • (Integer) 


44
45
46
47
 
# File 'lib/packetgen/types/int_string.rb', line 44

def length=(len)
  @length.read len
  len
end

#read(str) ⇒ IntString

Returns self.

Parameters:

  • str (::String)

Returns:



32
33
34
35
36
37
38
39
40
 
# File 'lib/packetgen/types/int_string.rb', line 32

def read(str)
  unless str[0, @length.width].size == @length.width
    raise ParseError,
          "String too short for type #{@length.class.to_s.gsub(/.*::/, '')}"
  end
  @length.read str[0, @length.width]
  @string.read str[@length.width, @length.to_i]
  self
end

#sz ⇒ Integer

Give binary string length (including length field)

Returns:

  • (Integer) 


91
92
93
 
# File 'lib/packetgen/types/int_string.rb', line 91

def sz
  to_s.size
end

#to_human ⇒ ::String

Get human readable string

Returns:

  • (::String)

Since:

  • 2.2.0



79
80
81
 
# File 'lib/packetgen/types/int_string.rb', line 79

def to_human
  @string
end

#to_s ⇒ ::String

Get binary string

Returns:

  • (::String) 


63
64
65
 
# File 'lib/packetgen/types/int_string.rb', line 63

def to_s
  @length.to_s << @string.to_s
end