Module: Net::IMAP::NumValidator

Defined in:
lib/net/imap/data_encoding.rb

Overview

Common validators of number and nz_number types

Constant Summary collapse

NUMBER_RE =

:nodoc

/\A(?:0|[1-9]\d*)\z/

Class Method Summary collapse

Class Method Details

.coerce_mod_sequence_value(num) ⇒ Object

Like #ensure_mod_sequence_value, but usable with numeric String input.



241
242
243
244
245
246
247
248
 
# File 'lib/net/imap/data_encoding.rb', line 241

def coerce_mod_sequence_value(num)
  case num
  when Integer   then ensure_mod_sequence_value num
  when NUMBER_RE then ensure_mod_sequence_value Integer num
  else
    raise DataFormatError, "%p is not a valid mod-sequence-value" % [num]
  end
end

.coerce_mod_sequence_valzer(num) ⇒ Object

Like #ensure_mod_sequence_valzer, but usable with numeric String input.



251
252
253
254
255
256
257
258
 
# File 'lib/net/imap/data_encoding.rb', line 251

def coerce_mod_sequence_valzer(num)
  case num
  when Integer   then ensure_mod_sequence_valzer num
  when NUMBER_RE then ensure_mod_sequence_valzer Integer num
  else
    raise DataFormatError, "%p is not a valid mod-sequence-valzer" % [num]
  end
end

.coerce_number(num) ⇒ Object

Like #ensure_number, but usable with numeric String input.



221
222
223
224
225
226
227
228
 
# File 'lib/net/imap/data_encoding.rb', line 221

def coerce_number(num)
  case num
  when Integer   then ensure_number num
  when NUMBER_RE then ensure_number Integer num
  else
    raise DataFormatError, "%p is not a valid number" % [num]
  end
end

.coerce_nz_number(num) ⇒ Object

Like #ensure_nz_number, but usable with numeric String input.



231
232
233
234
235
236
237
238
 
# File 'lib/net/imap/data_encoding.rb', line 231

def coerce_nz_number(num)
  case num
  when Integer   then ensure_nz_number num
  when NUMBER_RE then ensure_nz_number Integer num
  else
    raise DataFormatError, "%p is not a valid nz-number" % [num]
  end
end

.ensure_mod_sequence_value(num) ⇒ Object

Ensure argument is ‘mod-sequence-value’ or raise DataFormatError

Raises:



207
208
209
210
211
 
# File 'lib/net/imap/data_encoding.rb', line 207

def ensure_mod_sequence_value(num)
  return num if valid_mod_sequence_value?(num)
  raise DataFormatError,
    "mod-sequence-value must be non-zero unsigned 64-bit integer: #{num}"
end

.ensure_mod_sequence_valzer(num) ⇒ Object

Ensure argument is ‘mod-sequence-valzer’ or raise DataFormatError

Raises:



214
215
216
217
218
 
# File 'lib/net/imap/data_encoding.rb', line 214

def ensure_mod_sequence_valzer(num)
  return num if valid_mod_sequence_valzer?(num)
  raise DataFormatError,
    "mod-sequence-valzer must be unsigned 64-bit integer: #{num}"
end

.ensure_number(num) ⇒ Object

Ensure argument is ‘number’ or raise DataFormatError

Raises:



193
194
195
196
197
 
# File 'lib/net/imap/data_encoding.rb', line 193

def ensure_number(num)
  return num if valid_number?(num)
  raise DataFormatError,
    "number must be unsigned 32-bit integer: #{num}"
end

.ensure_nz_number(num) ⇒ Object

Ensure argument is ‘nz-number’ or raise DataFormatError

Raises:



200
201
202
203
204
 
# File 'lib/net/imap/data_encoding.rb', line 200

def ensure_nz_number(num)
  return num if valid_nz_number?(num)
  raise DataFormatError,
    "nz-number must be non-zero unsigned 32-bit integer: #{num}"
end

.valid_mod_sequence_value?(num) ⇒ Boolean

Check if argument is a valid ‘mod-sequence-value’ according to RFC 4551

mod-sequence-value  = 1*DIGIT
                       ; Positive unsigned 64-bit integer
                       ; (mod-sequence)
                       ; (1 <= n < 18,446,744,073,709,551,615)

Returns:

  • (Boolean) 


182
183
184
 
# File 'lib/net/imap/data_encoding.rb', line 182

def valid_mod_sequence_value?(num)
  1 <= num && num < 0xffff_ffff_ffff_ffff
end

.valid_mod_sequence_valzer?(num) ⇒ Boolean

Check if argument is a valid ‘mod-sequence-valzer’ according to RFC 4551

mod-sequence-valzer = "0" / mod-sequence-value

Returns:

  • (Boolean) 


188
189
190
 
# File 'lib/net/imap/data_encoding.rb', line 188

def valid_mod_sequence_valzer?(num)
  0 <= num && num < 0xffff_ffff_ffff_ffff
end

.valid_number?(num) ⇒ Boolean

Check if argument is a valid ‘number’ according to RFC 3501

number          = 1*DIGIT
                   ; Unsigned 32-bit integer
                   ; (0 <= n < 4,294,967,296)

Returns:

  • (Boolean) 


165
166
167
 
# File 'lib/net/imap/data_encoding.rb', line 165

def valid_number?(num)
  0 <= num && num <= 0xffff_ffff
end

.valid_nz_number?(num) ⇒ Boolean

Check if argument is a valid ‘nz-number’ according to RFC 3501

nz-number       = digit-nz *DIGIT
                   ; Non-zero unsigned 32-bit integer
                   ; (0 < n < 4,294,967,296)

Returns:

  • (Boolean) 


173
174
175
 
# File 'lib/net/imap/data_encoding.rb', line 173

def valid_nz_number?(num)
  0 < num && num <= 0xffff_ffff
end