Type:
Module
Constants:
DEFAULT_PARSER : Parser.new

URI::Parser.new

TBLENCWWWCOMP_ : {}
TBLDECWWWCOMP_ : {}
HTML5ASCIIINCOMPAT : [Encoding::UTF_7, Encoding::UTF_16BE, Encoding::UTF_16LE, Encoding::UTF_32BE, Encoding::UTF_32LE]
WFKV_ : '(?:[^%#=;&]*(?:%\h\h[^%#=;&]*)*)'

URI is a module providing classes to handle Uniform Resource Identifiers (RFC2396)

Features

  • Uniform handling of handling URIs

  • Flexibility to introduce custom URI schemes

  • Flexibility to have an alternate URI::Parser (or just different patterns and regexp's)

Basic example

require 'uri'

uri = URI("http://foo.com/posts?id=30&limit=5#time=1305298413")
#=> #<URI::HTTP:0x00000000b14880
      URL:http://foo.com/posts?id=30&limit=5#time=1305298413>
uri.scheme
#=> "http"
uri.host
#=> "foo.com"
uri.path
#=> "/posts"
uri.query
#=> "id=30&limit=5"
uri.fragment
#=> "time=1305298413"

uri.to_s
#=> "http://foo.com/posts?id=30&limit=5#time=1305298413"

Adding custom URIs

module URI
  class RSYNC < Generic
    DEFAULT_PORT = 873
  end
  @@schemes['RSYNC'] = RSYNC
end
#=> URI::RSYNC

URI.scheme_list
#=> {"FTP"=>URI::FTP, "HTTP"=>URI::HTTP, "HTTPS"=>URI::HTTPS,
     "LDAP"=>URI::LDAP, "LDAPS"=>URI::LDAPS, "MAILTO"=>URI::MailTo,
     "RSYNC"=>URI::RSYNC}

uri = URI("rsync://rsync.foo.com")
#=> #<URI::RSYNC:0x00000000f648c8 URL:rsync://rsync.foo.com>

RFC References

A good place to view an RFC spec is www.ietf.org/rfc.html

Here is a list of all related RFC's.

Class tree

Copyright Info

Author

Akira Yamada <akira@ruby-lang.org>

Documentation

Akira Yamada <akira@ruby-lang.org> Dmitry V. Sabanin <sdmitry@lrn.ru> Vincent Batts <vbatts@hashbangbash.com>

License

Copyright © 2001 akira yamada <akira@ruby-lang.org> You can redistribute it and/or modify it under the same term as Ruby.

Revision

$Id$

set_scope
  • References/Ruby on Rails/Ruby/Classes/URI/URI::LDAP

set_scope(val) Instance Protected methods private setter for scope val

2025-01-10 15:47:30
filter=
  • References/Ruby on Rails/Ruby/Classes/URI/URI::LDAP

filter=(val) Instance Public methods setter for filter val

2025-01-10 15:47:30
headers=
  • References/Ruby on Rails/Ruby/Classes/URI/URI::MailTo

headers=(v) Instance Public methods setter for headers v

2025-01-10 15:47:30
scheme_list
  • References/Ruby on Rails/Ruby/Classes/URI

scheme_list() Class Public methods Returns a

2025-01-10 15:47:30
==
  • References/Ruby on Rails/Ruby/Classes/URI/URI::Generic

==(oth) Instance Public methods Compares to URI's

2025-01-10 15:47:30
build
  • References/Ruby on Rails/Ruby/Classes/URI/URI::FTP

build(args) Class Public methods Description Creates

2025-01-10 15:47:30
host=
  • References/Ruby on Rails/Ruby/Classes/URI/URI::Generic

host=(v) Instance Public methods Args v

2025-01-10 15:47:30
escape
  • References/Ruby on Rails/Ruby/Classes/URI/URI::Escape

escape(*arg) Instance Public methods Synopsis

2025-01-10 15:47:30
build2
  • References/Ruby on Rails/Ruby/Classes/URI/URI::Generic

build2(args) Class Public methods Synopsis See

2025-01-10 15:47:30
hash
  • References/Ruby on Rails/Ruby/Classes/URI/URI::Generic

hash() Instance Public methods

2025-01-10 15:47:30