class Tilia::VObject::Property::Uri

URI property.

This object encodes URI values. vCard 2.1 calls these URL.

Attributes

delimiter[RW]

In case this is a multi-value property. This string will be used as a delimiter.

@return [String, nil]

Public Class Methods

new(*args) click to toggle source
Calls superclass method Tilia::VObject::Property::Text::new
# File lib/tilia/v_object/property/uri.rb, line 90
def initialize(*args)
  super(*args)
  @delimiter = nil
end

Public Instance Methods

parameters() click to toggle source

Returns an iterable list of children.

@return [array]

Calls superclass method
# File lib/tilia/v_object/property/uri.rb, line 27
def parameters
  parameters = super
  if !parameters.key?('VALUE') && ['URL', 'PHOTO'].include?(@name)
    # If we are encoding a URI value, and this URI value has no
    # VALUE=URI parameter, we add it anyway.
    #
    # This is not required by any spec, but both Apple iCal and Apple
    # AddressBook (at least in version 10.8) will trip over this if
    # this is not set, and so it improves compatibility.
    #
    # See Issue #227 and #235
    parameters['VALUE'] = Parameter.new(@root, 'VALUE', 'URI')
  end
  parameters
end
raw_mime_dir_value() click to toggle source

Returns a raw mime-dir representation of the value.

@return [String]

# File lib/tilia/v_object/property/uri.rb, line 80
def raw_mime_dir_value
  if @value.is_a?(Array)
    value = @value[0]
  else
    value = @value
  end

  value.gsub(',', '\\,')
end
raw_mime_dir_value=(val) click to toggle source

Sets a raw value coming from a mimedir (iCalendar/vCard) file.

This has been 'unfolded', so only 1 line will be passed. Unescaping is not yet done, but parameters are not included.

@param [String] val

@return [void]

# File lib/tilia/v_object/property/uri.rb, line 51
def raw_mime_dir_value=(val)
  # Normally we don't need to do any type of unescaping for these
  # properties, however.. we've noticed that Google Contacts
  # specifically escapes the colon (:) with a blackslash. While I have
  # no clue why they thought that was a good idea, I'm unescaping it
  # anyway.
  #
  # Good thing backslashes are not allowed in urls. Makes it easy to
  # assume that a backslash is always intended as an escape character.
  if name == 'URL'
    new_val = ''
    val.split(/  (?: (\\\\ (?: \\\\ | : ) ) ) /x).each do |match|
      case match
      when '\\:'
        new_val += ':'
      else
        new_val << match
      end
    end

    @value = new_val
  else
    @value = val.gsub('\\,', ',')
  end
end
value_type() click to toggle source

Returns the type of value.

This corresponds to the VALUE= parameter. Every property also has a 'default' valueType.

@return [String]

# File lib/tilia/v_object/property/uri.rb, line 20
def value_type
  'URI'
end