You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 

281 lines
9.6 KiB

<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="theme-color" content="#375EAB">
<title>charset - The Go Programming Language</title>
<link type="text/css" rel="stylesheet" href="../../../../../../lib/godoc/style.css">
<link rel="stylesheet" href="../../../../../../lib/godoc/jquery.treeview.css">
<script type="text/javascript">window.initFuncs = [];</script>
</head>
<body>
<div id='lowframe' style="position: fixed; bottom: 0; left: 0; height: 0; width: 100%; border-top: thin solid grey; background-color: white; overflow: auto;">
...
</div><!-- #lowframe -->
<div id="topbar" class="wide"><div class="container">
<div class="top-heading" id="heading-wide"><a href="http://localhost:6060/">The Go Programming Language</a></div>
<div class="top-heading" id="heading-narrow"><a href="http://localhost:6060/">Go</a></div>
<a href="index.html#" id="menu-button"><span id="menu-button-arrow">&#9661;</span></a>
<form method="GET" action="http://localhost:6060/search">
<div id="menu">
<a href="http://localhost:6060/doc/">Documents</a>
<a href="http://localhost:6060/pkg/">Packages</a>
<a href="http://localhost:6060/project/">The Project</a>
<a href="http://localhost:6060/help/">Help</a>
<a href="http://localhost:6060/blog/">Blog</a>
<input type="text" id="search" name="q" class="inactive" value="Search" placeholder="Search">
</div>
</form>
</div></div>
<div id="page" class="wide">
<div class="container">
<h1>Package charset</h1>
<div id="nav"></div>
<!--
Copyright 2009 The Go Authors. All rights reserved.
Use of this source code is governed by a BSD-style
license that can be found in the LICENSE file.
-->
<!--
Note: Static (i.e., not template-generated) href and id
attributes start with "pkg-" to make it impossible for
them to conflict with generated attributes (some of which
correspond to Go identifiers).
-->
<script type='text/javascript'>
document.ANALYSIS_DATA = null;
document.CALLGRAPH = null;
</script>
<div id="short-nav">
<dl>
<dd><code>import "golang.org/x/net/html/charset"</code></dd>
</dl>
<dl>
<dd><a href="index.html#pkg-overview" class="overviewLink">Overview</a></dd>
<dd><a href="index.html#pkg-index" class="indexLink">Index</a></dd>
</dl>
</div>
<!-- The package's Name is printed as title by the top-level template -->
<div id="pkg-overview" class="toggleVisible">
<div class="collapsed">
<h2 class="toggleButton" title="Click to show Overview section">Overview ▹</h2>
</div>
<div class="expanded">
<h2 class="toggleButton" title="Click to hide Overview section">Overview ▾</h2>
<p>
Package charset provides common text encodings for HTML documents.
</p>
<p>
The mapping from encoding labels to encodings is defined at
<a href="https://encoding.spec.whatwg.org/">https://encoding.spec.whatwg.org/</a>.
</p>
</div>
</div>
<div id="pkg-index" class="toggleVisible">
<div class="collapsed">
<h2 class="toggleButton" title="Click to show Index section">Index ▹</h2>
</div>
<div class="expanded">
<h2 class="toggleButton" title="Click to hide Index section">Index ▾</h2>
<!-- Table of contents for API; must be named manual-nav to turn off auto nav. -->
<div id="manual-nav">
<dl>
<dd><a href="index.html#DetermineEncoding">func DetermineEncoding(content []byte, contentType string) (e encoding.Encoding, name string, certain bool)</a></dd>
<dd><a href="index.html#Lookup">func Lookup(label string) (e encoding.Encoding, name string)</a></dd>
<dd><a href="index.html#NewReader">func NewReader(r io.Reader, contentType string) (io.Reader, error)</a></dd>
<dd><a href="index.html#NewReaderLabel">func NewReaderLabel(label string, input io.Reader) (io.Reader, error)</a></dd>
</dl>
</div><!-- #manual-nav -->
<h4>Package files</h4>
<p>
<span style="font-size:90%">
<a href="http://localhost:6060/src/golang.org/x/net/html/charset/charset.go">charset.go</a>
</span>
</p>
</div><!-- .expanded -->
</div><!-- #pkg-index -->
<div id="pkg-callgraph" class="toggle" style="display: none">
<div class="collapsed">
<h2 class="toggleButton" title="Click to show Internal Call Graph section">Internal call graph ▹</h2>
</div> <!-- .expanded -->
<div class="expanded">
<h2 class="toggleButton" title="Click to hide Internal Call Graph section">Internal call graph ▾</h2>
<p>
In the call graph viewer below, each node
is a function belonging to this package
and its children are the functions it
calls&mdash;perhaps dynamically.
</p>
<p>
The root nodes are the entry points of the
package: functions that may be called from
outside the package.
There may be non-exported or anonymous
functions among them if they are called
dynamically from another package.
</p>
<p>
Click a node to visit that function's source code.
From there you can visit its callers by
clicking its declaring <code>func</code>
token.
</p>
<p>
Functions may be omitted if they were
determined to be unreachable in the
particular programs or tests that were
analyzed.
</p>
<!-- Zero means show all package entry points. -->
<ul style="margin-left: 0.5in" id="callgraph-0" class="treeview"></ul>
</div>
</div> <!-- #pkg-callgraph -->
<h2 id="DetermineEncoding">func <a href="http://localhost:6060/src/golang.org/x/net/html/charset/charset.go?s=1729:1836#L42">DetermineEncoding</a></h2>
<pre>func DetermineEncoding(content []<a href="../../../../../builtin/index.html#byte">byte</a>, contentType <a href="../../../../../builtin/index.html#string">string</a>) (e <a href="../../../text/encoding/index.html">encoding</a>.<a href="../../../text/encoding/index.html#Encoding">Encoding</a>, name <a href="../../../../../builtin/index.html#string">string</a>, certain <a href="../../../../../builtin/index.html#bool">bool</a>)</pre>
<p>
DetermineEncoding determines the encoding of an HTML document by examining
up to the first 1024 bytes of content and the declared Content-Type.
</p>
<p>
See <a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/parsing.html#determining-the-character-encoding">http://www.whatwg.org/specs/web-apps/current-work/multipage/parsing.html#determining-the-character-encoding</a>
</p>
<h2 id="Lookup">func <a href="http://localhost:6060/src/golang.org/x/net/html/charset/charset.go?s=981:1041#L21">Lookup</a></h2>
<pre>func Lookup(label <a href="../../../../../builtin/index.html#string">string</a>) (e <a href="../../../text/encoding/index.html">encoding</a>.<a href="../../../text/encoding/index.html#Encoding">Encoding</a>, name <a href="../../../../../builtin/index.html#string">string</a>)</pre>
<p>
Lookup returns the encoding with the specified label, and its canonical
name. It returns nil and the empty string if label is not one of the
standard encodings for HTML. Matching is case-insensitive and ignores
leading and trailing whitespace. Encoders will use HTML escape sequences for
runes that are not supported by the character set.
</p>
<h2 id="NewReader">func <a href="http://localhost:6060/src/golang.org/x/net/html/charset/charset.go?s=2989:3055#L98">NewReader</a></h2>
<pre>func NewReader(r <a href="../../../../../io/index.html">io</a>.<a href="../../../../../io/index.html#Reader">Reader</a>, contentType <a href="../../../../../builtin/index.html#string">string</a>) (<a href="../../../../../io/index.html">io</a>.<a href="../../../../../io/index.html#Reader">Reader</a>, <a href="../../../../../builtin/index.html#error">error</a>)</pre>
<p>
NewReader returns an io.Reader that converts the content of r to UTF-8.
It calls DetermineEncoding to find out what r&#39;s encoding is.
</p>
<h2 id="NewReaderLabel">func <a href="http://localhost:6060/src/golang.org/x/net/html/charset/charset.go?s=3740:3809#L121">NewReaderLabel</a></h2>
<pre>func NewReaderLabel(label <a href="../../../../../builtin/index.html#string">string</a>, input <a href="../../../../../io/index.html">io</a>.<a href="../../../../../io/index.html#Reader">Reader</a>) (<a href="../../../../../io/index.html">io</a>.<a href="../../../../../io/index.html#Reader">Reader</a>, <a href="../../../../../builtin/index.html#error">error</a>)</pre>
<p>
NewReaderLabel returns a reader that converts from the specified charset to
UTF-8. It uses Lookup to find the encoding that corresponds to label, and
returns an error if Lookup returns nil. It is suitable for use as
encoding/xml.Decoder&#39;s CharsetReader function.
</p>
<div id="footer">
Build version go1.6.<br>
Except as <a href="https://developers.google.com/site-policies#restrictions">noted</a>,
the content of this page is licensed under the
Creative Commons Attribution 3.0 License,
and code is licensed under a <a href="http://localhost:6060/LICENSE">BSD license</a>.<br>
<a href="http://localhost:6060/doc/tos.html">Terms of Service</a> |
<a href="http://www.google.com/intl/en/policies/privacy/">Privacy Policy</a>
</div>
</div><!-- .container -->
</div><!-- #page -->
<!-- TODO(adonovan): load these from <head> using "defer" attribute? -->
<script type="text/javascript" src="../../../../../../lib/godoc/jquery.js"></script>
<script type="text/javascript" src="../../../../../../lib/godoc/jquery.treeview.js"></script>
<script type="text/javascript" src="../../../../../../lib/godoc/jquery.treeview.edit.js"></script>
<script type="text/javascript" src="../../../../../../lib/godoc/godocs.js"></script>
</body>
</html>