URI support for Ruby
Akira Yamada <akira@ruby-lang.org>
Akira Yamada <akira@ruby-lang.org>, Dmitry V. Sabanin <sdmitry@lrn.ru>
Copyright © 2001 akira yamada <akira@ruby-lang.org> You can redistribute it and/or modify it under the same term as Ruby.
$Id: uri.rb 13772 2007-10-25 00:53:34Z akira $
See URI for documentation
Akira Yamada <akira@ruby-lang.org>
$Id: common.rb 22760 2009-03-04 09:21:12Z yugui $
You can redistribute it and/or modify it under the same term as Ruby.
URI::extract(str[, schemes][,&blk])
str
String to extract URIs from.
schemes
Limit URI matching to a specific schemes.
Extracts URIs from a string. If block given, iterates through all matched URIs. Returns nil if block given or array with matches.
require "uri" URI.extract("text here http://foo.example.org/bla and here mailto:test@example.com and here also.") # => ["http://foo.example.com/bla", "mailto:test@example.com"]
# File uri/common.rb, line 678 def self.extract(str, schemes = nil, &block) DEFAULT_PARSER.extract(str, schemes, &block) end
URI::join(str[, str, ...])
str
String(s) to work with
Joins URIs.
require 'uri' p URI.join("http://localhost/","main.rbx") # => #<URI::HTTP:0x2022ac02 URL:http://localhost/main.rbx>
# File uri/common.rb, line 650 def self.join(*str) DEFAULT_PARSER.join(*str) end
URI::parse(uri_str)
uri_str
String with URI.
Creates one of the URI’s subclasses instance from the string.
Raised if URI given is not a correct one.
require 'uri' uri = URI.parse("http://www.ruby-lang.org/") p uri # => #<URI::HTTP:0x202281be URL:http://www.ruby-lang.org/> p uri.scheme # => "http" p uri.host # => "www.ruby-lang.org"
# File uri/common.rb, line 625 def self.parse(uri) DEFAULT_PARSER.parse(uri) end
URI::regexp([match_schemes])
match_schemes
Array of schemes. If given, resulting regexp matches to URIs whose scheme is one of the match_schemes.
Returns a Regexp object which matches to URI-like strings. The Regexp object returned by this method includes arbitrary number of capture group (parentheses). Never rely on it’s number.
require 'uri' # extract first URI from html_string html_string.slice(URI.regexp) # remove ftp URIs html_string.sub(URI.regexp(['ftp']) # You should not rely on the number of parentheses html_string.scan(URI.regexp) do |*matches| p $& end
# File uri/common.rb, line 713 def self.regexp(schemes = nil) DEFAULT_PARSER.make_regexp(schemes) end
# File uri/common.rb, line 538 def self.scheme_list @@schemes end
URI::split(uri)
uri
String with URI.
Splits the string on following parts and returns array with result:
* Scheme * Userinfo * Host * Port * Registry * Path * Opaque * Query * Fragment
require 'uri' p URI.split("http://www.ruby-lang.org/") # => ["http", nil, "www.ruby-lang.org", nil, nil, "/", nil, nil, nil]
# File uri/common.rb, line 590 def self.split(uri) DEFAULT_PARSER.split(uri) end
Commenting is here to help enhance the documentation. For example, code samples, or clarification of the documentation.
If you have questions about Ruby or the documentation, please post to one of the Ruby mailing lists. You will get better, faster, help that way.
If you wish to post a correction of the docs, please do so, but also file bug report so that it can be corrected for the next release. Thank you.
If you want to help improve the Ruby documentation, please visit Documenting-ruby.org.