Module: Net::BER::Extensions::String

Included in:
String
Defined in:
lib/net/ber/core_ext/string.rb

Overview

BER extensions to the String class.

Instance Method Summary collapse

Instance Method Details

#read_ber(syntax = nil) ⇒ Object

Nondestructively reads a BER object from this string.



62
63
64
 
# File 'lib/net/ber/core_ext/string.rb', line 62

def read_ber(syntax = nil)
  StringIO.new(self).read_ber(syntax)
end

#read_ber!(syntax = nil) ⇒ Object

Destructively reads a BER object from the string.



68
69
70
71
72
73
74
75
 
# File 'lib/net/ber/core_ext/string.rb', line 68

def read_ber!(syntax = nil)
  io = StringIO.new(self)

  result = io.read_ber(syntax)
  self.slice!(0...io.pos)

  return result
end

#reject_empty_ber_arrays ⇒ Object 



77
78
79
 
# File 'lib/net/ber/core_ext/string.rb', line 77

def reject_empty_ber_arrays
  self.gsub(/0\000/n, '')
end

#to_ber(code = 0x04) ⇒ Object

Converts a string to a BER string. Universal octet-strings are tagged with 0x04, but other values are possible depending on the context, so we let the caller give us one.

User code should call either #to_ber_application_string or #to_ber_contextspecific.



14
15
16
17
 
# File 'lib/net/ber/core_ext/string.rb', line 14

def to_ber(code = 0x04)
  raw_string = raw_utf8_encoded
  [code].pack('C') + raw_string.length.to_ber_length_encoding + raw_string
end

#to_ber_application_string(code) ⇒ Object

Creates an application-specific BER string encoded value with the provided syntax code value.



49
50
51
 
# File 'lib/net/ber/core_ext/string.rb', line 49

def to_ber_application_string(code)
  to_ber(0x40 + code)
end

#to_ber_bin(code = 0x04) ⇒ Object

Converts a string to a BER string but does not encode to UTF-8 first. This is required for proper representation of binary data for Microsoft Active Directory



23
24
25
 
# File 'lib/net/ber/core_ext/string.rb', line 23

def to_ber_bin(code = 0x04)
  [code].pack('C') + length.to_ber_length_encoding + self
end

#to_ber_contextspecific(code) ⇒ Object

Creates a context-specific BER string encoded value with the provided syntax code value.



56
57
58
 
# File 'lib/net/ber/core_ext/string.rb', line 56

def to_ber_contextspecific(code)
  to_ber(0x80 + code)
end