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.

540 lines
17 KiB

8 years ago
  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  5. <meta name="viewport" content="width=device-width, initial-scale=1">
  6. <meta name="theme-color" content="#375EAB">
  7. <title>atom - The Go Programming Language</title>
  8. <link type="text/css" rel="stylesheet" href="../../../../../lib/godoc/style.css">
  9. <link rel="stylesheet" href="../../../../../lib/godoc/jquery.treeview.css">
  10. <script type="text/javascript">window.initFuncs = [];</script>
  11. </head>
  12. <body>
  13. <div id='lowframe' style="position: fixed; bottom: 0; left: 0; height: 0; width: 100%; border-top: thin solid grey; background-color: white; overflow: auto;">
  14. ...
  15. </div><!-- #lowframe -->
  16. <div id="topbar" class="wide"><div class="container">
  17. <div class="top-heading" id="heading-wide"><a href="http://localhost:6060/">The Go Programming Language</a></div>
  18. <div class="top-heading" id="heading-narrow"><a href="http://localhost:6060/">Go</a></div>
  19. <a href="index.html#" id="menu-button"><span id="menu-button-arrow">&#9661;</span></a>
  20. <form method="GET" action="http://localhost:6060/search">
  21. <div id="menu">
  22. <a href="http://localhost:6060/doc/">Documents</a>
  23. <a href="http://localhost:6060/pkg/">Packages</a>
  24. <a href="http://localhost:6060/project/">The Project</a>
  25. <a href="http://localhost:6060/help/">Help</a>
  26. <a href="http://localhost:6060/blog/">Blog</a>
  27. <input type="text" id="search" name="q" class="inactive" value="Search" placeholder="Search">
  28. </div>
  29. </form>
  30. </div></div>
  31. <div id="page" class="wide">
  32. <div class="container">
  33. <h1>Package atom</h1>
  34. <div id="nav"></div>
  35. <!--
  36. Copyright 2009 The Go Authors. All rights reserved.
  37. Use of this source code is governed by a BSD-style
  38. license that can be found in the LICENSE file.
  39. -->
  40. <!--
  41. Note: Static (i.e., not template-generated) href and id
  42. attributes start with "pkg-" to make it impossible for
  43. them to conflict with generated attributes (some of which
  44. correspond to Go identifiers).
  45. -->
  46. <script type='text/javascript'>
  47. document.ANALYSIS_DATA = null;
  48. document.CALLGRAPH = null;
  49. </script>
  50. <div id="short-nav">
  51. <dl>
  52. <dd><code>import "github.com/mmcdole/gofeed/atom"</code></dd>
  53. </dl>
  54. <dl>
  55. <dd><a href="index.html#pkg-overview" class="overviewLink">Overview</a></dd>
  56. <dd><a href="index.html#pkg-index" class="indexLink">Index</a></dd>
  57. </dl>
  58. </div>
  59. <!-- The package's Name is printed as title by the top-level template -->
  60. <div id="pkg-overview" class="toggleVisible">
  61. <div class="collapsed">
  62. <h2 class="toggleButton" title="Click to show Overview section">Overview ▹</h2>
  63. </div>
  64. <div class="expanded">
  65. <h2 class="toggleButton" title="Click to hide Overview section">Overview ▾</h2>
  66. </div>
  67. </div>
  68. <div id="pkg-index" class="toggleVisible">
  69. <div class="collapsed">
  70. <h2 class="toggleButton" title="Click to show Index section">Index ▹</h2>
  71. </div>
  72. <div class="expanded">
  73. <h2 class="toggleButton" title="Click to hide Index section">Index ▾</h2>
  74. <!-- Table of contents for API; must be named manual-nav to turn off auto nav. -->
  75. <div id="manual-nav">
  76. <dl>
  77. <dd><a href="index.html#Category">type Category</a></dd>
  78. <dd><a href="index.html#Content">type Content</a></dd>
  79. <dd><a href="index.html#Entry">type Entry</a></dd>
  80. <dd><a href="index.html#Feed">type Feed</a></dd>
  81. <dd>&nbsp; &nbsp; <a href="index.html#Feed.String">func (f Feed) String() string</a></dd>
  82. <dd><a href="index.html#Generator">type Generator</a></dd>
  83. <dd><a href="index.html#Link">type Link</a></dd>
  84. <dd><a href="index.html#Parser">type Parser</a></dd>
  85. <dd>&nbsp; &nbsp; <a href="index.html#Parser.Parse">func (ap *Parser) Parse(feed io.Reader) (*Feed, error)</a></dd>
  86. <dd><a href="index.html#Person">type Person</a></dd>
  87. <dd><a href="index.html#Source">type Source</a></dd>
  88. </dl>
  89. </div><!-- #manual-nav -->
  90. <h4>Package files</h4>
  91. <p>
  92. <span style="font-size:90%">
  93. <a href="http://localhost:6060/src/github.com/mmcdole/gofeed/atom/feed.go">feed.go</a>
  94. <a href="http://localhost:6060/src/github.com/mmcdole/gofeed/atom/parser.go">parser.go</a>
  95. </span>
  96. </p>
  97. </div><!-- .expanded -->
  98. </div><!-- #pkg-index -->
  99. <div id="pkg-callgraph" class="toggle" style="display: none">
  100. <div class="collapsed">
  101. <h2 class="toggleButton" title="Click to show Internal Call Graph section">Internal call graph ▹</h2>
  102. </div> <!-- .expanded -->
  103. <div class="expanded">
  104. <h2 class="toggleButton" title="Click to hide Internal Call Graph section">Internal call graph ▾</h2>
  105. <p>
  106. In the call graph viewer below, each node
  107. is a function belonging to this package
  108. and its children are the functions it
  109. calls&mdash;perhaps dynamically.
  110. </p>
  111. <p>
  112. The root nodes are the entry points of the
  113. package: functions that may be called from
  114. outside the package.
  115. There may be non-exported or anonymous
  116. functions among them if they are called
  117. dynamically from another package.
  118. </p>
  119. <p>
  120. Click a node to visit that function's source code.
  121. From there you can visit its callers by
  122. clicking its declaring <code>func</code>
  123. token.
  124. </p>
  125. <p>
  126. Functions may be omitted if they were
  127. determined to be unreachable in the
  128. particular programs or tests that were
  129. analyzed.
  130. </p>
  131. <!-- Zero means show all package entry points. -->
  132. <ul style="margin-left: 0.5in" id="callgraph-0" class="treeview"></ul>
  133. </div>
  134. </div> <!-- #pkg-callgraph -->
  135. <h2 id="Category">type <a href="http://localhost:6060/src/github.com/mmcdole/gofeed/atom/feed.go?s=2199:2343#L46">Category</a></h2>
  136. <pre>type Category struct {
  137. Term <a href="../../../../builtin/index.html#string">string</a> `json:&#34;term,omitempty&#34;`
  138. Scheme <a href="../../../../builtin/index.html#string">string</a> `json:&#34;scheme,omitempty&#34;`
  139. Label <a href="../../../../builtin/index.html#string">string</a> `json:&#34;label,omitempty&#34;`
  140. }</pre>
  141. <p>
  142. Category is category metadata for Feeds and Entries
  143. </p>
  144. <h2 id="Content">type <a href="http://localhost:6060/src/github.com/mmcdole/gofeed/atom/feed.go?s=3008:3145#L73">Content</a></h2>
  145. <pre>type Content struct {
  146. Src <a href="../../../../builtin/index.html#string">string</a> `json:&#34;src,omitempty&#34;`
  147. Type <a href="../../../../builtin/index.html#string">string</a> `json:&#34;type,omitempty&#34;`
  148. Value <a href="../../../../builtin/index.html#string">string</a> `json:&#34;value,omitempty&#34;`
  149. }</pre>
  150. <p>
  151. Content either contains or links to the content of
  152. the entry
  153. </p>
  154. <h2 id="Entry">type <a href="http://localhost:6060/src/github.com/mmcdole/gofeed/atom/feed.go?s=1220:2142#L27">Entry</a></h2>
  155. <pre>type Entry struct {
  156. Title <a href="../../../../builtin/index.html#string">string</a> `json:&#34;title,omitempty&#34;`
  157. ID <a href="../../../../builtin/index.html#string">string</a> `json:&#34;id,omitempty&#34;`
  158. Updated <a href="../../../../builtin/index.html#string">string</a> `json:&#34;updated,omitempty&#34;`
  159. UpdatedParsed *<a href="../../../../time/index.html">time</a>.<a href="../../../../time/index.html#Time">Time</a> `json:&#34;updatedParsed,omitempty&#34;`
  160. Summary <a href="../../../../builtin/index.html#string">string</a> `json:&#34;summary,omitempty&#34;`
  161. Authors []*<a href="index.html#Person">Person</a> `json:&#34;authors,omitempty&#34;`
  162. Contributors []*<a href="index.html#Person">Person</a> `json:&#34;contributors,omitempty&#34;`
  163. Categories []*<a href="index.html#Category">Category</a> `json:&#34;categories,omitempty&#34;`
  164. Links []*<a href="index.html#Link">Link</a> `json:&#34;links,omitempty&#34;`
  165. Rights <a href="../../../../builtin/index.html#string">string</a> `json:&#34;rights,omitempty&#34;`
  166. Published <a href="../../../../builtin/index.html#string">string</a> `json:&#34;published,omitempty&#34;`
  167. PublishedParsed *<a href="../../../../time/index.html">time</a>.<a href="../../../../time/index.html#Time">Time</a> `json:&#34;publishedParsed,omitempty&#34;`
  168. Source *<a href="index.html#Source">Source</a> `json:&#34;source,omitempty&#34;`
  169. Content *<a href="index.html#Content">Content</a> `json:&#34;content,omitempty&#34;`
  170. Extensions ext.<a href="index.html#Extensions">Extensions</a> `json:&#34;extensions,omitempty&#34;`
  171. }</pre>
  172. <p>
  173. Entry is an Atom Entry
  174. </p>
  175. <h2 id="Feed">type <a href="http://localhost:6060/src/github.com/mmcdole/gofeed/atom/feed.go?s=116:1090#L1">Feed</a></h2>
  176. <pre>type Feed struct {
  177. Title <a href="../../../../builtin/index.html#string">string</a> `json:&#34;title,omitempty&#34;`
  178. ID <a href="../../../../builtin/index.html#string">string</a> `json:&#34;id,omitempty&#34;`
  179. Updated <a href="../../../../builtin/index.html#string">string</a> `json:&#34;updated,omitempty&#34;`
  180. UpdatedParsed *<a href="../../../../time/index.html">time</a>.<a href="../../../../time/index.html#Time">Time</a> `json:&#34;updatedParsed,omitempty&#34;`
  181. Subtitle <a href="../../../../builtin/index.html#string">string</a> `json:&#34;subtitle,omitempty&#34;`
  182. Links []*<a href="index.html#Link">Link</a> `json:&#34;links,omitempty&#34;`
  183. Language <a href="../../../../builtin/index.html#string">string</a> `json:&#34;language,omitempty&#34;`
  184. Generator *<a href="index.html#Generator">Generator</a> `json:&#34;generator,omitempty&#34;`
  185. Icon <a href="../../../../builtin/index.html#string">string</a> `json:&#34;icon,omitempty&#34;`
  186. Logo <a href="../../../../builtin/index.html#string">string</a> `json:&#34;logo,omitempty&#34;`
  187. Rights <a href="../../../../builtin/index.html#string">string</a> `json:&#34;rights,omitempty&#34;`
  188. Contributors []*<a href="index.html#Person">Person</a> `json:&#34;contributors,omitempty&#34;`
  189. Authors []*<a href="index.html#Person">Person</a> `json:&#34;authors,omitempty&#34;`
  190. Categories []*<a href="index.html#Category">Category</a> `json:&#34;categories,omitempty&#34;`
  191. Entries []*<a href="index.html#Entry">Entry</a> `json:&#34;entries&#34;`
  192. Extensions ext.<a href="index.html#Extensions">Extensions</a> `json:&#34;extensions,omitempty&#34;`
  193. Version <a href="../../../../builtin/index.html#string">string</a> `json:&#34;version&#34;`
  194. }</pre>
  195. <p>
  196. Feed is an Atom Feed
  197. </p>
  198. <h3 id="Feed.String">func (Feed) <a href="http://localhost:6060/src/github.com/mmcdole/gofeed/atom/feed.go?s=1092:1121#L21">String</a></h3>
  199. <pre>func (f <a href="index.html#Feed">Feed</a>) String() <a href="../../../../builtin/index.html#string">string</a></pre>
  200. <h2 id="Generator">type <a href="http://localhost:6060/src/github.com/mmcdole/gofeed/atom/feed.go?s=3243:3391#L81">Generator</a></h2>
  201. <pre>type Generator struct {
  202. Value <a href="../../../../builtin/index.html#string">string</a> `json:&#34;value,omitempty&#34;`
  203. URI <a href="../../../../builtin/index.html#string">string</a> `json:&#34;uri,omitempty&#34;`
  204. Version <a href="../../../../builtin/index.html#string">string</a> `json:&#34;version,omitempty&#34;`
  205. }</pre>
  206. <p>
  207. Generator identifies the agent used to generate a
  208. feed, for debugging and other purposes.
  209. </p>
  210. <h2 id="Link">type <a href="http://localhost:6060/src/github.com/mmcdole/gofeed/atom/feed.go?s=2667:2939#L62">Link</a></h2>
  211. <pre>type Link struct {
  212. Href <a href="../../../../builtin/index.html#string">string</a> `json:&#34;href,omitempty&#34;`
  213. Hreflang <a href="../../../../builtin/index.html#string">string</a> `json:&#34;hreflang,omitempty&#34;`
  214. Rel <a href="../../../../builtin/index.html#string">string</a> `json:&#34;rel,omitempty&#34;`
  215. Type <a href="../../../../builtin/index.html#string">string</a> `json:&#34;type,omitempty&#34;`
  216. Title <a href="../../../../builtin/index.html#string">string</a> `json:&#34;title,omitempty&#34;`
  217. Length <a href="../../../../builtin/index.html#string">string</a> `json:&#34;length,omitempty&#34;`
  218. }</pre>
  219. <p>
  220. Link is an Atom link that defines a reference
  221. from an entry or feed to a Web resource
  222. </p>
  223. <h2 id="Parser">type <a href="http://localhost:6060/src/github.com/mmcdole/gofeed/atom/parser.go?s=238:258#L5">Parser</a></h2>
  224. <pre>type Parser struct{}</pre>
  225. <p>
  226. Parser is an Atom Parser
  227. </p>
  228. <h3 id="Parser.Parse">func (*Parser) <a href="http://localhost:6060/src/github.com/mmcdole/gofeed/atom/parser.go?s=306:360#L8">Parse</a></h3>
  229. <pre>func (ap *<a href="index.html#Parser">Parser</a>) Parse(feed <a href="../../../../io/index.html">io</a>.<a href="../../../../io/index.html#Reader">Reader</a>) (*<a href="index.html#Feed">Feed</a>, <a href="../../../../builtin/index.html#error">error</a>)</pre>
  230. <p>
  231. Parse parses an xml feed into an atom.Feed
  232. </p>
  233. <h2 id="Person">type <a href="http://localhost:6060/src/github.com/mmcdole/gofeed/atom/feed.go?s=2437:2573#L54">Person</a></h2>
  234. <pre>type Person struct {
  235. Name <a href="../../../../builtin/index.html#string">string</a> `json:&#34;name,omitempty&#34;`
  236. Email <a href="../../../../builtin/index.html#string">string</a> `json:&#34;email,omitempty&#34;`
  237. URI <a href="../../../../builtin/index.html#string">string</a> `json:&#34;uri,omitempty&#34;`
  238. }</pre>
  239. <p>
  240. Person represents a person in an Atom feed
  241. for things like Authors, Contributors, etc
  242. </p>
  243. <h2 id="Source">type <a href="http://localhost:6060/src/github.com/mmcdole/gofeed/atom/feed.go?s=3491:4315#L89">Source</a></h2>
  244. <pre>type Source struct {
  245. Title <a href="../../../../builtin/index.html#string">string</a> `json:&#34;title,omitempty&#34;`
  246. ID <a href="../../../../builtin/index.html#string">string</a> `json:&#34;id,omitempty&#34;`
  247. Updated <a href="../../../../builtin/index.html#string">string</a> `json:&#34;updated,omitempty&#34;`
  248. UpdatedParsed *<a href="../../../../time/index.html">time</a>.<a href="../../../../time/index.html#Time">Time</a> `json:&#34;updatedParsed,omitempty&#34;`
  249. Subtitle <a href="../../../../builtin/index.html#string">string</a> `json:&#34;subtitle,omitempty&#34;`
  250. Links []*<a href="index.html#Link">Link</a> `json:&#34;links,omitempty&#34;`
  251. Generator *<a href="index.html#Generator">Generator</a> `json:&#34;generator,omitempty&#34;`
  252. Icon <a href="../../../../builtin/index.html#string">string</a> `json:&#34;icon,omitempty&#34;`
  253. Logo <a href="../../../../builtin/index.html#string">string</a> `json:&#34;logo,omitempty&#34;`
  254. Rights <a href="../../../../builtin/index.html#string">string</a> `json:&#34;rights,omitempty&#34;`
  255. Contributors []*<a href="index.html#Person">Person</a> `json:&#34;contributors,omitempty&#34;`
  256. Authors []*<a href="index.html#Person">Person</a> `json:&#34;authors,omitempty&#34;`
  257. Categories []*<a href="index.html#Category">Category</a> `json:&#34;categories,omitempty&#34;`
  258. Extensions ext.<a href="index.html#Extensions">Extensions</a> `json:&#34;extensions,omitempty&#34;`
  259. }</pre>
  260. <p>
  261. Source contains the feed information for another
  262. feed if a given entry came from that feed.
  263. </p>
  264. <div id="footer">
  265. Build version go1.6.<br>
  266. Except as <a href="https://developers.google.com/site-policies#restrictions">noted</a>,
  267. the content of this page is licensed under the
  268. Creative Commons Attribution 3.0 License,
  269. and code is licensed under a <a href="http://localhost:6060/LICENSE">BSD license</a>.<br>
  270. <a href="http://localhost:6060/doc/tos.html">Terms of Service</a> |
  271. <a href="http://www.google.com/intl/en/policies/privacy/">Privacy Policy</a>
  272. </div>
  273. </div><!-- .container -->
  274. </div><!-- #page -->
  275. <!-- TODO(adonovan): load these from <head> using "defer" attribute? -->
  276. <script type="text/javascript" src="../../../../../lib/godoc/jquery.js"></script>
  277. <script type="text/javascript" src="../../../../../lib/godoc/jquery.treeview.js"></script>
  278. <script type="text/javascript" src="../../../../../lib/godoc/jquery.treeview.edit.js"></script>
  279. <script type="text/javascript" src="../../../../../lib/godoc/godocs.js"></script>
  280. </body>
  281. </html>