build

Description

Creates a new URI::MailTo object from components, with syntax checking.

Components can be provided as an Array or Hash. If an Array is used, the components must be supplied as [to, headers].

If a Hash is used, the keys are the component names preceded by colons.

The headers can be supplied as a pre-encoded string, such as âsubject=subscribe&cc=addressâ, or as an Array of Arrays like

['subject', 'subscribe'], ['cc', 'address']

Examples:

1 2 3 4 5 6 7 8 9 10

require 'uri'   m1 = URI::MailTo.build(['joe@example.com', 'subject=Ruby']) puts m1.to_s  ->  mailto:joe@example.com?subject=Ruby   m2 = URI::MailTo.build(['john@example.com', [['Subject', 'Ruby'], ['Cc', 'jack@example.com']]]) puts m2.to_s  ->  mailto:john@example.com?Subject=Ruby&Cc=jack@example.com   m3 = URI::MailTo.build({:to => 'listman@example.com', :headers => [['subject', 'subscribe']]}) puts m3.to_s  ->  mailto:listman@example.com?subject=subscribe