File: C:/Ruby27-x64/share/doc/ruby/html/WEBrick/HTTPUtils.html
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>module WEBrick::HTTPUtils - RDoc Documentation</title>
<script type="text/javascript">
var rdoc_rel_prefix = "../";
var index_rel_prefix = "../";
</script>
<script src="../js/navigation.js" defer></script>
<script src="../js/search.js" defer></script>
<script src="../js/search_index.js" defer></script>
<script src="../js/searcher.js" defer></script>
<script src="../js/darkfish.js" defer></script>
<link href="../css/fonts.css" rel="stylesheet">
<link href="../css/rdoc.css" rel="stylesheet">
<body id="top" role="document" class="module">
<nav role="navigation">
<div id="project-navigation">
<div id="home-section" role="region" title="Quick navigation" class="nav-section">
<h2>
<a href="../index.html" rel="home">Home</a>
</h2>
<div id="table-of-contents-navigation">
<a href="../table_of_contents.html#pages">Pages</a>
<a href="../table_of_contents.html#classes">Classes</a>
<a href="../table_of_contents.html#methods">Methods</a>
</div>
</div>
<div id="search-section" role="search" class="project-section initially-hidden">
<form action="#" method="get" accept-charset="utf-8">
<div id="search-field-wrapper">
<input id="search-field" role="combobox" aria-label="Search"
aria-autocomplete="list" aria-controls="search-results"
type="text" name="search" placeholder="Search" spellcheck="false"
title="Type to search, Up and Down to navigate, Enter to load">
</div>
<ul id="search-results" aria-label="Search Results"
aria-busy="false" aria-expanded="false"
aria-atomic="false" class="initially-hidden"></ul>
</form>
</div>
</div>
<div id="class-metadata">
<!-- Method Quickref -->
<div id="method-list-section" class="nav-section">
<h3>Methods</h3>
<ul class="link-list" role="directory">
<li ><a href="#method-c-dequote">::dequote</a>
<li ><a href="#method-c-load_mime_types">::load_mime_types</a>
<li ><a href="#method-c-mime_type">::mime_type</a>
<li ><a href="#method-c-normalize_path">::normalize_path</a>
<li ><a href="#method-c-parse_form_data">::parse_form_data</a>
<li ><a href="#method-c-parse_header">::parse_header</a>
<li ><a href="#method-c-parse_query">::parse_query</a>
<li ><a href="#method-c-parse_qvalues">::parse_qvalues</a>
<li ><a href="#method-c-parse_range_header">::parse_range_header</a>
<li ><a href="#method-c-quote">::quote</a>
<li ><a href="#method-c-split_header_value">::split_header_value</a>
<li ><a href="#method-i-dequote">#dequote</a>
<li ><a href="#method-i-escape">#escape</a>
<li ><a href="#method-i-escape8bit">#escape8bit</a>
<li ><a href="#method-i-escape_form">#escape_form</a>
<li ><a href="#method-i-escape_path">#escape_path</a>
<li ><a href="#method-i-load_mime_types">#load_mime_types</a>
<li ><a href="#method-i-mime_type">#mime_type</a>
<li ><a href="#method-i-normalize_path">#normalize_path</a>
<li ><a href="#method-i-parse_form_data">#parse_form_data</a>
<li ><a href="#method-i-parse_header">#parse_header</a>
<li ><a href="#method-i-parse_query">#parse_query</a>
<li ><a href="#method-i-parse_qvalues">#parse_qvalues</a>
<li ><a href="#method-i-parse_range_header">#parse_range_header</a>
<li ><a href="#method-i-quote">#quote</a>
<li ><a href="#method-i-split_header_value">#split_header_value</a>
<li ><a href="#method-i-unescape">#unescape</a>
<li ><a href="#method-i-unescape_form">#unescape_form</a>
</ul>
</div>
</div>
</nav>
<main role="main" aria-labelledby="module-WEBrick::HTTPUtils">
<h1 id="module-WEBrick::HTTPUtils" class="module">
module WEBrick::HTTPUtils
</h1>
<section class="description">
<p><a href="HTTPUtils.html"><code>HTTPUtils</code></a> provides utility methods for working with the HTTP protocol.</p>
<p>This module is generally used internally by <a href="../WEBrick.html"><code>WEBrick</code></a></p>
</section>
<section id="5Buntitled-5D" class="documentation-section">
<section class="constants-list">
<header>
<h3>Constants</h3>
</header>
<dl>
<dt id="DefaultMimeTypes">DefaultMimeTypes
<dd><p>Default mime types</p>
</dl>
</section>
<section id="public-class-5Buntitled-5D-method-details" class="method-section">
<header>
<h3>Public Class Methods</h3>
</header>
<div id="method-c-dequote" class="method-detail ">
<div class="method-heading">
<span class="method-name">dequote</span><span
class="method-args">(str)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Removes quotes and escapes from <code>str</code></p>
<div class="method-source-code" id="dequote-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 222</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">dequote</span>(<span class="ruby-identifier">str</span>)
<span class="ruby-identifier">ret</span> = (<span class="ruby-regexp">/\A"(.*)"\Z/</span> <span class="ruby-operator">=~</span> <span class="ruby-identifier">str</span>) <span class="ruby-operator">?</span> <span class="ruby-node">$1</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">str</span>.<span class="ruby-identifier">dup</span>
<span class="ruby-identifier">ret</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp">/\\(.)/</span>, <span class="ruby-string">"\\1"</span>)
<span class="ruby-identifier">ret</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-c-load_mime_types" class="method-detail ">
<div class="method-heading">
<span class="method-name">load_mime_types</span><span
class="method-args">(file)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Loads Apache-compatible mime.types in <code>file</code>.</p>
<div class="method-source-code" id="load_mime_types-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 111</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">load_mime_types</span>(<span class="ruby-identifier">file</span>)
<span class="ruby-comment"># note: +file+ may be a "| command" for now; some people may</span>
<span class="ruby-comment"># rely on this, but currently we do not use this method by default.</span>
<span class="ruby-identifier">open</span>(<span class="ruby-identifier">file</span>){ <span class="ruby-operator">|</span><span class="ruby-identifier">io</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">hash</span> = <span class="ruby-constant">Hash</span>.<span class="ruby-identifier">new</span>
<span class="ruby-identifier">io</span>.<span class="ruby-identifier">each</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">line</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">next</span> <span class="ruby-keyword">if</span> <span class="ruby-regexp">/^#/</span> <span class="ruby-operator">=~</span> <span class="ruby-identifier">line</span>
<span class="ruby-identifier">line</span>.<span class="ruby-identifier">chomp!</span>
<span class="ruby-identifier">mimetype</span>, <span class="ruby-identifier">ext0</span> = <span class="ruby-identifier">line</span>.<span class="ruby-identifier">split</span>(<span class="ruby-regexp">/\s+/</span>, <span class="ruby-value">2</span>)
<span class="ruby-keyword">next</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">ext0</span>
<span class="ruby-keyword">next</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">ext0</span>.<span class="ruby-identifier">empty?</span>
<span class="ruby-identifier">ext0</span>.<span class="ruby-identifier">split</span>(<span class="ruby-regexp">/\s+/</span>).<span class="ruby-identifier">each</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">ext</span><span class="ruby-operator">|</span> <span class="ruby-identifier">hash</span>[<span class="ruby-identifier">ext</span>] = <span class="ruby-identifier">mimetype</span> }
}
<span class="ruby-identifier">hash</span>
}
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-c-mime_type" class="method-detail ">
<div class="method-heading">
<span class="method-name">mime_type</span><span
class="method-args">(filename, mime_tab)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Returns the mime type of <code>filename</code> from the list in <code>mime_tab</code>. If no mime type was found application/octet-stream is returned.</p>
<div class="method-source-code" id="mime_type-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 133</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">mime_type</span>(<span class="ruby-identifier">filename</span>, <span class="ruby-identifier">mime_tab</span>)
<span class="ruby-identifier">suffix1</span> = (<span class="ruby-regexp">/\.(\w+)$/</span> <span class="ruby-operator">=~</span> <span class="ruby-identifier">filename</span> <span class="ruby-operator">&&</span> <span class="ruby-node">$1</span>.<span class="ruby-identifier">downcase</span>)
<span class="ruby-identifier">suffix2</span> = (<span class="ruby-regexp">/\.(\w+)\.[\w\-]+$/</span> <span class="ruby-operator">=~</span> <span class="ruby-identifier">filename</span> <span class="ruby-operator">&&</span> <span class="ruby-node">$1</span>.<span class="ruby-identifier">downcase</span>)
<span class="ruby-identifier">mime_tab</span>[<span class="ruby-identifier">suffix1</span>] <span class="ruby-operator">||</span> <span class="ruby-identifier">mime_tab</span>[<span class="ruby-identifier">suffix2</span>] <span class="ruby-operator">||</span> <span class="ruby-string">"application/octet-stream"</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-c-normalize_path" class="method-detail ">
<div class="method-heading">
<span class="method-name">normalize_path</span><span
class="method-args">(path)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Normalizes a request path. Raises an exception if the path cannot be normalized.</p>
<div class="method-source-code" id="normalize_path-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 31</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">normalize_path</span>(<span class="ruby-identifier">path</span>)
<span class="ruby-identifier">raise</span> <span class="ruby-node">"abnormal path `#{path}'"</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">path</span>[<span class="ruby-value">0</span>] <span class="ruby-operator">!=</span> <span class="ruby-value">?/</span>
<span class="ruby-identifier">ret</span> = <span class="ruby-identifier">path</span>.<span class="ruby-identifier">dup</span>
<span class="ruby-identifier">ret</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp">%r{/+}o</span>, <span class="ruby-string">'/'</span>) <span class="ruby-comment"># // => /</span>
<span class="ruby-keyword">while</span> <span class="ruby-identifier">ret</span>.<span class="ruby-identifier">sub!</span>(<span class="ruby-regexp">%r'/\.(?:/|\Z)'</span>, <span class="ruby-string">'/'</span>); <span class="ruby-keyword">end</span> <span class="ruby-comment"># /. => /</span>
<span class="ruby-keyword">while</span> <span class="ruby-identifier">ret</span>.<span class="ruby-identifier">sub!</span>(<span class="ruby-regexp">%r'/(?!\.\./)[^/]+/\.\.(?:/|\Z)'</span>, <span class="ruby-string">'/'</span>); <span class="ruby-keyword">end</span> <span class="ruby-comment"># /foo/.. => /foo</span>
<span class="ruby-identifier">raise</span> <span class="ruby-node">"abnormal path `#{path}'"</span> <span class="ruby-keyword">if</span> <span class="ruby-regexp">%r{/\.\.(/|\Z)}</span> <span class="ruby-operator">=~</span> <span class="ruby-identifier">ret</span>
<span class="ruby-identifier">ret</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-c-parse_form_data" class="method-detail ">
<div class="method-heading">
<span class="method-name">parse_form_data</span><span
class="method-args">(io, boundary)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Parses form data in <code>io</code> with the given <code>boundary</code></p>
<div class="method-source-code" id="parse_form_data-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 394</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">parse_form_data</span>(<span class="ruby-identifier">io</span>, <span class="ruby-identifier">boundary</span>)
<span class="ruby-identifier">boundary_regexp</span> = <span class="ruby-regexp">/\A--#{Regexp.quote(boundary)}(--)?#{CRLF}\z/</span>
<span class="ruby-identifier">form_data</span> = <span class="ruby-constant">Hash</span>.<span class="ruby-identifier">new</span>
<span class="ruby-keyword">return</span> <span class="ruby-identifier">form_data</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">io</span>
<span class="ruby-identifier">data</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">io</span>.<span class="ruby-identifier">each_line</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">line</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">boundary_regexp</span> <span class="ruby-operator">=~</span> <span class="ruby-identifier">line</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">data</span>
<span class="ruby-identifier">data</span>.<span class="ruby-identifier">chop!</span>
<span class="ruby-identifier">key</span> = <span class="ruby-identifier">data</span>.<span class="ruby-identifier">name</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">form_data</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">key</span>)
<span class="ruby-identifier">form_data</span>[<span class="ruby-identifier">key</span>].<span class="ruby-identifier">append_data</span>(<span class="ruby-identifier">data</span>)
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">form_data</span>[<span class="ruby-identifier">key</span>] = <span class="ruby-identifier">data</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">data</span> = <span class="ruby-constant">FormData</span>.<span class="ruby-identifier">new</span>
<span class="ruby-keyword">next</span>
<span class="ruby-keyword">else</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">data</span>
<span class="ruby-identifier">data</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">line</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
}
<span class="ruby-keyword">return</span> <span class="ruby-identifier">form_data</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-c-parse_header" class="method-detail ">
<div class="method-heading">
<span class="method-name">parse_header</span><span
class="method-args">(raw)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Parses an HTTP header <code>raw</code> into a hash of header fields with an <a href="../Array.html"><code>Array</code></a> of values.</p>
<div class="method-source-code" id="parse_header-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 144</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">parse_header</span>(<span class="ruby-identifier">raw</span>)
<span class="ruby-identifier">header</span> = <span class="ruby-constant">Hash</span>.<span class="ruby-identifier">new</span>([].<span class="ruby-identifier">freeze</span>)
<span class="ruby-identifier">field</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">raw</span>.<span class="ruby-identifier">each_line</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">line</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">case</span> <span class="ruby-identifier">line</span>
<span class="ruby-keyword">when</span> <span class="ruby-regexp">/^([A-Za-z0-9!\#$%&'*+\-.^_`|~]+):\s*(.*?)\s*\z/om</span>
<span class="ruby-identifier">field</span>, <span class="ruby-identifier">value</span> = <span class="ruby-node">$1</span>, <span class="ruby-node">$2</span>
<span class="ruby-identifier">field</span>.<span class="ruby-identifier">downcase!</span>
<span class="ruby-identifier">header</span>[<span class="ruby-identifier">field</span>] = [] <span class="ruby-keyword">unless</span> <span class="ruby-identifier">header</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">field</span>)
<span class="ruby-identifier">header</span>[<span class="ruby-identifier">field</span>] <span class="ruby-operator"><<</span> <span class="ruby-identifier">value</span>
<span class="ruby-keyword">when</span> <span class="ruby-regexp">/^\s+(.*?)\s*\z/om</span>
<span class="ruby-identifier">value</span> = <span class="ruby-node">$1</span>
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">field</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">HTTPStatus</span><span class="ruby-operator">::</span><span class="ruby-constant">BadRequest</span>, <span class="ruby-node">"bad header '#{line}'."</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">header</span>[<span class="ruby-identifier">field</span>][<span class="ruby-value">-1</span>] <span class="ruby-operator"><<</span> <span class="ruby-string">" "</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">value</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">HTTPStatus</span><span class="ruby-operator">::</span><span class="ruby-constant">BadRequest</span>, <span class="ruby-node">"bad header '#{line}'."</span>
<span class="ruby-keyword">end</span>
}
<span class="ruby-identifier">header</span>.<span class="ruby-identifier">each</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">key</span>, <span class="ruby-identifier">values</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">values</span>.<span class="ruby-identifier">each</span>(<span class="ruby-operator">&</span><span class="ruby-value">:strip!</span>)
}
<span class="ruby-identifier">header</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-c-parse_query" class="method-detail ">
<div class="method-heading">
<span class="method-name">parse_query</span><span
class="method-args">(str)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Parses the query component of a <a href="../URI.html"><code>URI</code></a> in <code>str</code></p>
<div class="method-source-code" id="parse_query-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 370</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">parse_query</span>(<span class="ruby-identifier">str</span>)
<span class="ruby-identifier">query</span> = <span class="ruby-constant">Hash</span>.<span class="ruby-identifier">new</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">str</span>
<span class="ruby-identifier">str</span>.<span class="ruby-identifier">split</span>(<span class="ruby-regexp">/[&;]/</span>).<span class="ruby-identifier">each</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">x</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">next</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">x</span>.<span class="ruby-identifier">empty?</span>
<span class="ruby-identifier">key</span>, <span class="ruby-identifier">val</span> = <span class="ruby-identifier">x</span>.<span class="ruby-identifier">split</span>(<span class="ruby-regexp">/=/</span>,<span class="ruby-value">2</span>)
<span class="ruby-identifier">key</span> = <span class="ruby-identifier">unescape_form</span>(<span class="ruby-identifier">key</span>)
<span class="ruby-identifier">val</span> = <span class="ruby-identifier">unescape_form</span>(<span class="ruby-identifier">val</span>.<span class="ruby-identifier">to_s</span>)
<span class="ruby-identifier">val</span> = <span class="ruby-constant">FormData</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">val</span>)
<span class="ruby-identifier">val</span>.<span class="ruby-identifier">name</span> = <span class="ruby-identifier">key</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">query</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">key</span>)
<span class="ruby-identifier">query</span>[<span class="ruby-identifier">key</span>].<span class="ruby-identifier">append_data</span>(<span class="ruby-identifier">val</span>)
<span class="ruby-keyword">next</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">query</span>[<span class="ruby-identifier">key</span>] = <span class="ruby-identifier">val</span>
}
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">query</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-c-parse_qvalues" class="method-detail ">
<div class="method-heading">
<span class="method-name">parse_qvalues</span><span
class="method-args">(value)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Parses q values in <code>value</code> as used in Accept headers.</p>
<div class="method-source-code" id="parse_qvalues-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 201</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">parse_qvalues</span>(<span class="ruby-identifier">value</span>)
<span class="ruby-identifier">tmp</span> = []
<span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span>
<span class="ruby-identifier">parts</span> = <span class="ruby-identifier">value</span>.<span class="ruby-identifier">split</span>(<span class="ruby-regexp">/,\s*/</span>)
<span class="ruby-identifier">parts</span>.<span class="ruby-identifier">each</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">part</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">m</span> = <span class="ruby-regexp">%r{^([^\s,]+?)(?:;\s*q=(\d+(?:\.\d+)?))?$}</span>.<span class="ruby-identifier">match</span>(<span class="ruby-identifier">part</span>)
<span class="ruby-identifier">val</span> = <span class="ruby-identifier">m</span>[<span class="ruby-value">1</span>]
<span class="ruby-identifier">q</span> = (<span class="ruby-identifier">m</span>[<span class="ruby-value">2</span>] <span class="ruby-keyword">or</span> <span class="ruby-value">1</span>).<span class="ruby-identifier">to_f</span>
<span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">push</span>([<span class="ruby-identifier">val</span>, <span class="ruby-identifier">q</span>])
<span class="ruby-keyword">end</span>
}
<span class="ruby-identifier">tmp</span> = <span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">sort_by</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">val</span>, <span class="ruby-identifier">q</span><span class="ruby-operator">|</span> <span class="ruby-operator">-</span><span class="ruby-identifier">q</span>}
<span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">collect!</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">val</span>, <span class="ruby-identifier">q</span><span class="ruby-operator">|</span> <span class="ruby-identifier">val</span>}
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">return</span> <span class="ruby-identifier">tmp</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-c-parse_range_header" class="method-detail ">
<div class="method-heading">
<span class="method-name">parse_range_header</span><span
class="method-args">(ranges_specifier)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Parses a <a href="../Range.html"><code>Range</code></a> header value <code>ranges_specifier</code></p>
<div class="method-source-code" id="parse_range_header-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 183</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">parse_range_header</span>(<span class="ruby-identifier">ranges_specifier</span>)
<span class="ruby-keyword">if</span> <span class="ruby-regexp">/^bytes=(.*)/</span> <span class="ruby-operator">=~</span> <span class="ruby-identifier">ranges_specifier</span>
<span class="ruby-identifier">byte_range_set</span> = <span class="ruby-identifier">split_header_value</span>(<span class="ruby-node">$1</span>)
<span class="ruby-identifier">byte_range_set</span>.<span class="ruby-identifier">collect</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">range_spec</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">case</span> <span class="ruby-identifier">range_spec</span>
<span class="ruby-keyword">when</span> <span class="ruby-regexp">/^(\d+)-(\d+)/</span> <span class="ruby-keyword">then</span> <span class="ruby-node">$1</span>.<span class="ruby-identifier">to_i</span> <span class="ruby-operator">..</span> <span class="ruby-node">$2</span>.<span class="ruby-identifier">to_i</span>
<span class="ruby-keyword">when</span> <span class="ruby-regexp">/^(\d+)-/</span> <span class="ruby-keyword">then</span> <span class="ruby-node">$1</span>.<span class="ruby-identifier">to_i</span> <span class="ruby-operator">..</span> <span class="ruby-value">-1</span>
<span class="ruby-keyword">when</span> <span class="ruby-regexp">/^-(\d+)/</span> <span class="ruby-keyword">then</span> <span class="ruby-operator">-</span>(<span class="ruby-node">$1</span>.<span class="ruby-identifier">to_i</span>) <span class="ruby-operator">..</span> <span class="ruby-value">-1</span>
<span class="ruby-keyword">else</span> <span class="ruby-keyword">return</span> <span class="ruby-keyword">nil</span>
<span class="ruby-keyword">end</span>
}
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-c-quote" class="method-detail ">
<div class="method-heading">
<span class="method-name">quote</span><span
class="method-args">(str)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Quotes and escapes quotes in <code>str</code></p>
<div class="method-source-code" id="quote-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 232</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">quote</span>(<span class="ruby-identifier">str</span>)
<span class="ruby-string">'"'</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">str</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp">/[\\\"]/o</span>, <span class="ruby-string">"\\\1"</span>) <span class="ruby-operator"><<</span> <span class="ruby-string">'"'</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-c-split_header_value" class="method-detail ">
<div class="method-heading">
<span class="method-name">split_header_value</span><span
class="method-args">(str)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Splits a header value <code>str</code> according to HTTP specification.</p>
<div class="method-source-code" id="split_header_value-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 174</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">split_header_value</span>(<span class="ruby-identifier">str</span>)
<span class="ruby-identifier">str</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-regexp">%r'\G((?:"(?:\\.|[^"])+?"|[^",]+)+)
(?:,\s*|\Z)'xn</span>).<span class="ruby-identifier">flatten</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
</section>
<section id="public-instance-5Buntitled-5D-method-details" class="method-section">
<header>
<h3>Public Instance Methods</h3>
</header>
<div id="method-i-escape" class="method-detail ">
<div class="method-heading">
<span class="method-name">escape</span><span
class="method-args">(str)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Escapes HTTP reserved and unwise characters in <code>str</code></p>
<div class="method-source-code" id="escape-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 466</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">escape</span>(<span class="ruby-identifier">str</span>)
<span class="ruby-identifier">_escape</span>(<span class="ruby-identifier">str</span>, <span class="ruby-constant">UNESCAPED</span>)
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-escape8bit" class="method-detail ">
<div class="method-heading">
<span class="method-name">escape8bit</span><span
class="method-args">(str)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Escapes 8 bit characters in <code>str</code></p>
<div class="method-source-code" id="escape8bit-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 507</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">escape8bit</span>(<span class="ruby-identifier">str</span>)
<span class="ruby-identifier">_escape</span>(<span class="ruby-identifier">str</span>, <span class="ruby-constant">NONASCII</span>)
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-escape_form" class="method-detail ">
<div class="method-heading">
<span class="method-name">escape_form</span><span
class="method-args">(str)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Escapes form reserved characters in <code>str</code></p>
<div class="method-source-code" id="escape_form-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 480</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">escape_form</span>(<span class="ruby-identifier">str</span>)
<span class="ruby-identifier">ret</span> = <span class="ruby-identifier">_escape</span>(<span class="ruby-identifier">str</span>, <span class="ruby-constant">UNESCAPED_FORM</span>)
<span class="ruby-identifier">ret</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp">/ /</span>, <span class="ruby-string">"+"</span>)
<span class="ruby-identifier">ret</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-escape_path" class="method-detail ">
<div class="method-heading">
<span class="method-name">escape_path</span><span
class="method-args">(str)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Escapes path <code>str</code></p>
<div class="method-source-code" id="escape_path-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 496</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">escape_path</span>(<span class="ruby-identifier">str</span>)
<span class="ruby-identifier">result</span> = <span class="ruby-string">""</span>
<span class="ruby-identifier">str</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-regexp">%r{/([^/]*)}</span>).<span class="ruby-identifier">each</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">i</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">result</span> <span class="ruby-operator"><<</span> <span class="ruby-string">"/"</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">_escape</span>(<span class="ruby-identifier">i</span>[<span class="ruby-value">0</span>], <span class="ruby-constant">UNESCAPED_PCHAR</span>)
}
<span class="ruby-keyword">return</span> <span class="ruby-identifier">result</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-unescape" class="method-detail ">
<div class="method-heading">
<span class="method-name">unescape</span><span
class="method-args">(str)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Unescapes HTTP reserved and unwise characters in <code>str</code></p>
<div class="method-source-code" id="unescape-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 473</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">unescape</span>(<span class="ruby-identifier">str</span>)
<span class="ruby-identifier">_unescape</span>(<span class="ruby-identifier">str</span>, <span class="ruby-constant">ESCAPED</span>)
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-unescape_form" class="method-detail ">
<div class="method-heading">
<span class="method-name">unescape_form</span><span
class="method-args">(str)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Unescapes form reserved characters in <code>str</code></p>
<div class="method-source-code" id="unescape_form-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 489</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">unescape_form</span>(<span class="ruby-identifier">str</span>)
<span class="ruby-identifier">_unescape</span>(<span class="ruby-identifier">str</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp">/\+/</span>, <span class="ruby-string">" "</span>), <span class="ruby-constant">ESCAPED</span>)
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
</section>
<section id="private-instance-5Buntitled-5D-method-details" class="method-section">
<header>
<h3>Private Instance Methods</h3>
</header>
<div id="method-i-dequote" class="method-detail ">
<div class="method-heading">
<span class="method-name">dequote</span><span
class="method-args">(str)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Removes quotes and escapes from <code>str</code></p>
<div class="method-source-code" id="dequote-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 222</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">dequote</span>(<span class="ruby-identifier">str</span>)
<span class="ruby-identifier">ret</span> = (<span class="ruby-regexp">/\A"(.*)"\Z/</span> <span class="ruby-operator">=~</span> <span class="ruby-identifier">str</span>) <span class="ruby-operator">?</span> <span class="ruby-node">$1</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">str</span>.<span class="ruby-identifier">dup</span>
<span class="ruby-identifier">ret</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp">/\\(.)/</span>, <span class="ruby-string">"\\1"</span>)
<span class="ruby-identifier">ret</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-load_mime_types" class="method-detail ">
<div class="method-heading">
<span class="method-name">load_mime_types</span><span
class="method-args">(file)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Loads Apache-compatible mime.types in <code>file</code>.</p>
<div class="method-source-code" id="load_mime_types-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 111</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">load_mime_types</span>(<span class="ruby-identifier">file</span>)
<span class="ruby-comment"># note: +file+ may be a "| command" for now; some people may</span>
<span class="ruby-comment"># rely on this, but currently we do not use this method by default.</span>
<span class="ruby-identifier">open</span>(<span class="ruby-identifier">file</span>){ <span class="ruby-operator">|</span><span class="ruby-identifier">io</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">hash</span> = <span class="ruby-constant">Hash</span>.<span class="ruby-identifier">new</span>
<span class="ruby-identifier">io</span>.<span class="ruby-identifier">each</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">line</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">next</span> <span class="ruby-keyword">if</span> <span class="ruby-regexp">/^#/</span> <span class="ruby-operator">=~</span> <span class="ruby-identifier">line</span>
<span class="ruby-identifier">line</span>.<span class="ruby-identifier">chomp!</span>
<span class="ruby-identifier">mimetype</span>, <span class="ruby-identifier">ext0</span> = <span class="ruby-identifier">line</span>.<span class="ruby-identifier">split</span>(<span class="ruby-regexp">/\s+/</span>, <span class="ruby-value">2</span>)
<span class="ruby-keyword">next</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">ext0</span>
<span class="ruby-keyword">next</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">ext0</span>.<span class="ruby-identifier">empty?</span>
<span class="ruby-identifier">ext0</span>.<span class="ruby-identifier">split</span>(<span class="ruby-regexp">/\s+/</span>).<span class="ruby-identifier">each</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">ext</span><span class="ruby-operator">|</span> <span class="ruby-identifier">hash</span>[<span class="ruby-identifier">ext</span>] = <span class="ruby-identifier">mimetype</span> }
}
<span class="ruby-identifier">hash</span>
}
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-mime_type" class="method-detail ">
<div class="method-heading">
<span class="method-name">mime_type</span><span
class="method-args">(filename, mime_tab)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Returns the mime type of <code>filename</code> from the list in <code>mime_tab</code>. If no mime type was found application/octet-stream is returned.</p>
<div class="method-source-code" id="mime_type-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 133</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">mime_type</span>(<span class="ruby-identifier">filename</span>, <span class="ruby-identifier">mime_tab</span>)
<span class="ruby-identifier">suffix1</span> = (<span class="ruby-regexp">/\.(\w+)$/</span> <span class="ruby-operator">=~</span> <span class="ruby-identifier">filename</span> <span class="ruby-operator">&&</span> <span class="ruby-node">$1</span>.<span class="ruby-identifier">downcase</span>)
<span class="ruby-identifier">suffix2</span> = (<span class="ruby-regexp">/\.(\w+)\.[\w\-]+$/</span> <span class="ruby-operator">=~</span> <span class="ruby-identifier">filename</span> <span class="ruby-operator">&&</span> <span class="ruby-node">$1</span>.<span class="ruby-identifier">downcase</span>)
<span class="ruby-identifier">mime_tab</span>[<span class="ruby-identifier">suffix1</span>] <span class="ruby-operator">||</span> <span class="ruby-identifier">mime_tab</span>[<span class="ruby-identifier">suffix2</span>] <span class="ruby-operator">||</span> <span class="ruby-string">"application/octet-stream"</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-normalize_path" class="method-detail ">
<div class="method-heading">
<span class="method-name">normalize_path</span><span
class="method-args">(path)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Normalizes a request path. Raises an exception if the path cannot be normalized.</p>
<div class="method-source-code" id="normalize_path-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 31</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">normalize_path</span>(<span class="ruby-identifier">path</span>)
<span class="ruby-identifier">raise</span> <span class="ruby-node">"abnormal path `#{path}'"</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">path</span>[<span class="ruby-value">0</span>] <span class="ruby-operator">!=</span> <span class="ruby-value">?/</span>
<span class="ruby-identifier">ret</span> = <span class="ruby-identifier">path</span>.<span class="ruby-identifier">dup</span>
<span class="ruby-identifier">ret</span>.<span class="ruby-identifier">gsub!</span>(<span class="ruby-regexp">%r{/+}o</span>, <span class="ruby-string">'/'</span>) <span class="ruby-comment"># // => /</span>
<span class="ruby-keyword">while</span> <span class="ruby-identifier">ret</span>.<span class="ruby-identifier">sub!</span>(<span class="ruby-regexp">%r'/\.(?:/|\Z)'</span>, <span class="ruby-string">'/'</span>); <span class="ruby-keyword">end</span> <span class="ruby-comment"># /. => /</span>
<span class="ruby-keyword">while</span> <span class="ruby-identifier">ret</span>.<span class="ruby-identifier">sub!</span>(<span class="ruby-regexp">%r'/(?!\.\./)[^/]+/\.\.(?:/|\Z)'</span>, <span class="ruby-string">'/'</span>); <span class="ruby-keyword">end</span> <span class="ruby-comment"># /foo/.. => /foo</span>
<span class="ruby-identifier">raise</span> <span class="ruby-node">"abnormal path `#{path}'"</span> <span class="ruby-keyword">if</span> <span class="ruby-regexp">%r{/\.\.(/|\Z)}</span> <span class="ruby-operator">=~</span> <span class="ruby-identifier">ret</span>
<span class="ruby-identifier">ret</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-parse_form_data" class="method-detail ">
<div class="method-heading">
<span class="method-name">parse_form_data</span><span
class="method-args">(io, boundary)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Parses form data in <code>io</code> with the given <code>boundary</code></p>
<div class="method-source-code" id="parse_form_data-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 394</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">parse_form_data</span>(<span class="ruby-identifier">io</span>, <span class="ruby-identifier">boundary</span>)
<span class="ruby-identifier">boundary_regexp</span> = <span class="ruby-regexp">/\A--#{Regexp.quote(boundary)}(--)?#{CRLF}\z/</span>
<span class="ruby-identifier">form_data</span> = <span class="ruby-constant">Hash</span>.<span class="ruby-identifier">new</span>
<span class="ruby-keyword">return</span> <span class="ruby-identifier">form_data</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">io</span>
<span class="ruby-identifier">data</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">io</span>.<span class="ruby-identifier">each_line</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">line</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">boundary_regexp</span> <span class="ruby-operator">=~</span> <span class="ruby-identifier">line</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">data</span>
<span class="ruby-identifier">data</span>.<span class="ruby-identifier">chop!</span>
<span class="ruby-identifier">key</span> = <span class="ruby-identifier">data</span>.<span class="ruby-identifier">name</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">form_data</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">key</span>)
<span class="ruby-identifier">form_data</span>[<span class="ruby-identifier">key</span>].<span class="ruby-identifier">append_data</span>(<span class="ruby-identifier">data</span>)
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">form_data</span>[<span class="ruby-identifier">key</span>] = <span class="ruby-identifier">data</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">data</span> = <span class="ruby-constant">FormData</span>.<span class="ruby-identifier">new</span>
<span class="ruby-keyword">next</span>
<span class="ruby-keyword">else</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">data</span>
<span class="ruby-identifier">data</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">line</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
}
<span class="ruby-keyword">return</span> <span class="ruby-identifier">form_data</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-parse_header" class="method-detail ">
<div class="method-heading">
<span class="method-name">parse_header</span><span
class="method-args">(raw)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Parses an HTTP header <code>raw</code> into a hash of header fields with an <a href="../Array.html"><code>Array</code></a> of values.</p>
<div class="method-source-code" id="parse_header-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 144</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">parse_header</span>(<span class="ruby-identifier">raw</span>)
<span class="ruby-identifier">header</span> = <span class="ruby-constant">Hash</span>.<span class="ruby-identifier">new</span>([].<span class="ruby-identifier">freeze</span>)
<span class="ruby-identifier">field</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">raw</span>.<span class="ruby-identifier">each_line</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">line</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">case</span> <span class="ruby-identifier">line</span>
<span class="ruby-keyword">when</span> <span class="ruby-regexp">/^([A-Za-z0-9!\#$%&'*+\-.^_`|~]+):\s*(.*?)\s*\z/om</span>
<span class="ruby-identifier">field</span>, <span class="ruby-identifier">value</span> = <span class="ruby-node">$1</span>, <span class="ruby-node">$2</span>
<span class="ruby-identifier">field</span>.<span class="ruby-identifier">downcase!</span>
<span class="ruby-identifier">header</span>[<span class="ruby-identifier">field</span>] = [] <span class="ruby-keyword">unless</span> <span class="ruby-identifier">header</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">field</span>)
<span class="ruby-identifier">header</span>[<span class="ruby-identifier">field</span>] <span class="ruby-operator"><<</span> <span class="ruby-identifier">value</span>
<span class="ruby-keyword">when</span> <span class="ruby-regexp">/^\s+(.*?)\s*\z/om</span>
<span class="ruby-identifier">value</span> = <span class="ruby-node">$1</span>
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">field</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">HTTPStatus</span><span class="ruby-operator">::</span><span class="ruby-constant">BadRequest</span>, <span class="ruby-node">"bad header '#{line}'."</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">header</span>[<span class="ruby-identifier">field</span>][<span class="ruby-value">-1</span>] <span class="ruby-operator"><<</span> <span class="ruby-string">" "</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">value</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">HTTPStatus</span><span class="ruby-operator">::</span><span class="ruby-constant">BadRequest</span>, <span class="ruby-node">"bad header '#{line}'."</span>
<span class="ruby-keyword">end</span>
}
<span class="ruby-identifier">header</span>.<span class="ruby-identifier">each</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">key</span>, <span class="ruby-identifier">values</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">values</span>.<span class="ruby-identifier">each</span>(<span class="ruby-operator">&</span><span class="ruby-value">:strip!</span>)
}
<span class="ruby-identifier">header</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-parse_query" class="method-detail ">
<div class="method-heading">
<span class="method-name">parse_query</span><span
class="method-args">(str)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Parses the query component of a <a href="../URI.html"><code>URI</code></a> in <code>str</code></p>
<div class="method-source-code" id="parse_query-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 370</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">parse_query</span>(<span class="ruby-identifier">str</span>)
<span class="ruby-identifier">query</span> = <span class="ruby-constant">Hash</span>.<span class="ruby-identifier">new</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">str</span>
<span class="ruby-identifier">str</span>.<span class="ruby-identifier">split</span>(<span class="ruby-regexp">/[&;]/</span>).<span class="ruby-identifier">each</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">x</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">next</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">x</span>.<span class="ruby-identifier">empty?</span>
<span class="ruby-identifier">key</span>, <span class="ruby-identifier">val</span> = <span class="ruby-identifier">x</span>.<span class="ruby-identifier">split</span>(<span class="ruby-regexp">/=/</span>,<span class="ruby-value">2</span>)
<span class="ruby-identifier">key</span> = <span class="ruby-identifier">unescape_form</span>(<span class="ruby-identifier">key</span>)
<span class="ruby-identifier">val</span> = <span class="ruby-identifier">unescape_form</span>(<span class="ruby-identifier">val</span>.<span class="ruby-identifier">to_s</span>)
<span class="ruby-identifier">val</span> = <span class="ruby-constant">FormData</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">val</span>)
<span class="ruby-identifier">val</span>.<span class="ruby-identifier">name</span> = <span class="ruby-identifier">key</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">query</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">key</span>)
<span class="ruby-identifier">query</span>[<span class="ruby-identifier">key</span>].<span class="ruby-identifier">append_data</span>(<span class="ruby-identifier">val</span>)
<span class="ruby-keyword">next</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">query</span>[<span class="ruby-identifier">key</span>] = <span class="ruby-identifier">val</span>
}
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">query</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-parse_qvalues" class="method-detail ">
<div class="method-heading">
<span class="method-name">parse_qvalues</span><span
class="method-args">(value)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Parses q values in <code>value</code> as used in Accept headers.</p>
<div class="method-source-code" id="parse_qvalues-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 201</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">parse_qvalues</span>(<span class="ruby-identifier">value</span>)
<span class="ruby-identifier">tmp</span> = []
<span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span>
<span class="ruby-identifier">parts</span> = <span class="ruby-identifier">value</span>.<span class="ruby-identifier">split</span>(<span class="ruby-regexp">/,\s*/</span>)
<span class="ruby-identifier">parts</span>.<span class="ruby-identifier">each</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">part</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">m</span> = <span class="ruby-regexp">%r{^([^\s,]+?)(?:;\s*q=(\d+(?:\.\d+)?))?$}</span>.<span class="ruby-identifier">match</span>(<span class="ruby-identifier">part</span>)
<span class="ruby-identifier">val</span> = <span class="ruby-identifier">m</span>[<span class="ruby-value">1</span>]
<span class="ruby-identifier">q</span> = (<span class="ruby-identifier">m</span>[<span class="ruby-value">2</span>] <span class="ruby-keyword">or</span> <span class="ruby-value">1</span>).<span class="ruby-identifier">to_f</span>
<span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">push</span>([<span class="ruby-identifier">val</span>, <span class="ruby-identifier">q</span>])
<span class="ruby-keyword">end</span>
}
<span class="ruby-identifier">tmp</span> = <span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">sort_by</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">val</span>, <span class="ruby-identifier">q</span><span class="ruby-operator">|</span> <span class="ruby-operator">-</span><span class="ruby-identifier">q</span>}
<span class="ruby-identifier">tmp</span>.<span class="ruby-identifier">collect!</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">val</span>, <span class="ruby-identifier">q</span><span class="ruby-operator">|</span> <span class="ruby-identifier">val</span>}
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">return</span> <span class="ruby-identifier">tmp</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-parse_range_header" class="method-detail ">
<div class="method-heading">
<span class="method-name">parse_range_header</span><span
class="method-args">(ranges_specifier)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Parses a <a href="../Range.html"><code>Range</code></a> header value <code>ranges_specifier</code></p>
<div class="method-source-code" id="parse_range_header-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 183</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">parse_range_header</span>(<span class="ruby-identifier">ranges_specifier</span>)
<span class="ruby-keyword">if</span> <span class="ruby-regexp">/^bytes=(.*)/</span> <span class="ruby-operator">=~</span> <span class="ruby-identifier">ranges_specifier</span>
<span class="ruby-identifier">byte_range_set</span> = <span class="ruby-identifier">split_header_value</span>(<span class="ruby-node">$1</span>)
<span class="ruby-identifier">byte_range_set</span>.<span class="ruby-identifier">collect</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">range_spec</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">case</span> <span class="ruby-identifier">range_spec</span>
<span class="ruby-keyword">when</span> <span class="ruby-regexp">/^(\d+)-(\d+)/</span> <span class="ruby-keyword">then</span> <span class="ruby-node">$1</span>.<span class="ruby-identifier">to_i</span> <span class="ruby-operator">..</span> <span class="ruby-node">$2</span>.<span class="ruby-identifier">to_i</span>
<span class="ruby-keyword">when</span> <span class="ruby-regexp">/^(\d+)-/</span> <span class="ruby-keyword">then</span> <span class="ruby-node">$1</span>.<span class="ruby-identifier">to_i</span> <span class="ruby-operator">..</span> <span class="ruby-value">-1</span>
<span class="ruby-keyword">when</span> <span class="ruby-regexp">/^-(\d+)/</span> <span class="ruby-keyword">then</span> <span class="ruby-operator">-</span>(<span class="ruby-node">$1</span>.<span class="ruby-identifier">to_i</span>) <span class="ruby-operator">..</span> <span class="ruby-value">-1</span>
<span class="ruby-keyword">else</span> <span class="ruby-keyword">return</span> <span class="ruby-keyword">nil</span>
<span class="ruby-keyword">end</span>
}
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-quote" class="method-detail ">
<div class="method-heading">
<span class="method-name">quote</span><span
class="method-args">(str)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Quotes and escapes quotes in <code>str</code></p>
<div class="method-source-code" id="quote-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 232</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">quote</span>(<span class="ruby-identifier">str</span>)
<span class="ruby-string">'"'</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">str</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-regexp">/[\\\"]/o</span>, <span class="ruby-string">"\\\1"</span>) <span class="ruby-operator"><<</span> <span class="ruby-string">'"'</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-split_header_value" class="method-detail ">
<div class="method-heading">
<span class="method-name">split_header_value</span><span
class="method-args">(str)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Splits a header value <code>str</code> according to HTTP specification.</p>
<div class="method-source-code" id="split_header_value-source">
<pre><span class="ruby-comment"># File lib/webrick/httputils.rb, line 174</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">split_header_value</span>(<span class="ruby-identifier">str</span>)
<span class="ruby-identifier">str</span>.<span class="ruby-identifier">scan</span>(<span class="ruby-regexp">%r'\G((?:"(?:\\.|[^"])+?"|[^",]+)+)
(?:,\s*|\Z)'xn</span>).<span class="ruby-identifier">flatten</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
</section>
</section>
</main>
<footer id="validator-badges" role="contentinfo">
<p><a href="https://validator.w3.org/check/referer">Validate</a>
<p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.2.1.1.
<p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
</footer>