/Code/Tools/BuildScripts/lua-lib/penlight-0.8/docs/api/modules/pl.seq.html

http://angel-engine.googlecode.com/ · HTML · 1052 lines · 539 code · 510 blank · 3 comment · 0 complexity · 649afa069a8b3d5dc897b12a3e282140 MD5 · raw file 

    

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    2. 

  2.    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
    3. 

  3. <html>
    4. 

  4. <head>
    5. 

  5.     <title>Reference</title>
    6. 

  6.     <link rel="stylesheet" href="../luadoc.css" type="text/css" />
    7. 

  7. 	<!--meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/-->
    8. 

  8. </head>
    9. 

  9. 

  10. <body>
    11. 

  11. <div id="container">
    12. 

  12. 

  13. <div id="product">
    14. 

  14. 	<div id="product_logo"></div>
    15. 

  15. 	<div id="product_name"><big><b></b></big></div>
    16. 

  16. 	<div id="product_description"></div>
    17. 

  17. </div> <!-- id="product" -->
    18. 

  18. 

  19. <div id="main">
    20. 

  20. 

  21. <div id="navigation">
    22. 

  22. 

  23. 

  24. <h1>LuaDoc</h1>
    25. 

  25. <ul>
    26. 

  26. 	
    27. 

  27. 	<li><a href="../index.html">Index</a></li>
    28. 

  28. 	
    29. 

  29. </ul>
    30. 

  30. 

  31. 

  32. <!-- Module list -->
    33. 

  33. 

  34. <h1>Modules</h1>
    35. 

  35. <ul>
    36. 

  36. 

  37. 	<li>
    38. 

  38. 		<a href="../modules/pl.app.html">pl.app</a>
    39. 

  39. 	</li>
    40. 

  40. 

  41. 	<li>
    42. 

  42. 		<a href="../modules/pl.array2d.html">pl.array2d</a>
    43. 

  43. 	</li>
    44. 

  44. 

  45. 	<li>
    46. 

  46. 		<a href="../modules/pl.class.html">pl.class</a>
    47. 

  47. 	</li>
    48. 

  48. 

  49. 	<li>
    50. 

  50. 		<a href="../modules/pl.classx.html">pl.classx</a>
    51. 

  51. 	</li>
    52. 

  52. 

  53. 	<li>
    54. 

  54. 		<a href="../modules/pl.config.html">pl.config</a>
    55. 

  55. 	</li>
    56. 

  56. 

  57. 	<li>
    58. 

  58. 		<a href="../modules/pl.data.html">pl.data</a>
    59. 

  59. 	</li>
    60. 

  60. 

  61. 	<li>
    62. 

  62. 		<a href="../modules/pl.dir.html">pl.dir</a>
    63. 

  63. 	</li>
    64. 

  64. 

  65. 	<li>
    66. 

  66. 		<a href="../modules/pl.file.html">pl.file</a>
    67. 

  67. 	</li>
    68. 

  68. 

  69. 	<li>
    70. 

  70. 		<a href="../modules/pl.func.html">pl.func</a>
    71. 

  71. 	</li>
    72. 

  72. 

  73. 	<li>
    74. 

  74. 		<a href="../modules/pl.input.html">pl.input</a>
    75. 

  75. 	</li>
    76. 

  76. 

  77. 	<li>
    78. 

  78. 		<a href="../modules/pl.lexer.html">pl.lexer</a>
    79. 

  79. 	</li>
    80. 

  80. 

  81. 	<li>
    82. 

  82. 		<a href="../modules/pl.list.html">pl.list</a>
    83. 

  83. 	</li>
    84. 

  84. 

  85. 	<li>
    86. 

  86. 		<a href="../modules/pl.operator.html">pl.operator</a>
    87. 

  87. 	</li>
    88. 

  88. 

  89. 	<li>
    90. 

  90. 		<a href="../modules/pl.path.html">pl.path</a>
    91. 

  91. 	</li>
    92. 

  92. 

  93. 	<li>
    94. 

  94. 		<a href="../modules/pl.permute.html">pl.permute</a>
    95. 

  95. 	</li>
    96. 

  96. 

  97. 	<li>
    98. 

  98. 		<a href="../modules/pl.pretty.html">pl.pretty</a>
    99. 

  99. 	</li>
    100. 

  100. 

  101. 	<li><strong>pl.seq</strong></li>
    102. 

  102. 	
    103. 

  103. 	<li>
    104. 

  104. 		<a href="../modules/pl.sip.html">pl.sip</a>
    105. 

  105. 	</li>
    106. 

  106. 

  107. 	<li>
    108. 

  108. 		<a href="../modules/pl.stringio.html">pl.stringio</a>
    109. 

  109. 	</li>
    110. 

  110. 

  111. 	<li>
    112. 

  112. 		<a href="../modules/pl.stringx.html">pl.stringx</a>
    113. 

  113. 	</li>
    114. 

  114. 

  115. 	<li>
    116. 

  116. 		<a href="../modules/pl.tablex.html">pl.tablex</a>
    117. 

  117. 	</li>
    118. 

  118. 

  119. 	<li>
    120. 

  120. 		<a href="../modules/pl.test.html">pl.test</a>
    121. 

  121. 	</li>
    122. 

  122. 

  123. 	<li>
    124. 

  124. 		<a href="../modules/pl.text.html">pl.text</a>
    125. 

  125. 	</li>
    126. 

  126. 

  127. 	<li>
    128. 

  128. 		<a href="../modules/pl.utils.html">pl.utils</a>
    129. 

  129. 	</li>
    130. 

  130. 

  131. </ul>
    132. 

  132. 

  133. 

  134. 

  135. <!-- File list -->
    136. 

  136. 

  137. 

  138. 

  139. 

  140. 

  141. 

  142. </div><!-- id="navigation" -->
    143. 

  143. 

  144. <div id="content">
    145. 

  145. 

  146. <h1>Module <code>pl.seq</code></h1>
    147. 

  147. 

  148. <p>Manipulating sequences as iterators.</p>
    149. 

  149. 

  150. 

  151. 

  152. 

  153. 

  154. <h2>Functions</h2>
    155. 

  155. <table class="function_list">
    156. 

  156. 

  157. 	<tr>
    158. 

  158. 	<td class="name" nowrap><a href="#copy">copy</a>&nbsp;(iter)</td>
    159. 

  159. 	<td class="summary">create a table from the sequence.</td>
    160. 

  160. 	</tr>
    161. 

  161. 

  162. 	<tr>
    163. 

  163. 	<td class="name" nowrap><a href="#copy2">copy2</a>&nbsp;(iter, i1, i2)</td>
    164. 

  164. 	<td class="summary">create a table of pairs from the double-valued sequence.</td>
    165. 

  165. 	</tr>
    166. 

  166. 

  167. 	<tr>
    168. 

  168. 	<td class="name" nowrap><a href="#copy_tuples">copy_tuples</a>&nbsp;(iter)</td>
    169. 

  169. 	<td class="summary">create a table of 'tuples' from a multi-valued sequence.</td>
    170. 

  170. 	</tr>
    171. 

  171. 

  172. 	<tr>
    173. 

  173. 	<td class="name" nowrap><a href="#count_map">count_map</a>&nbsp;(iter)</td>
    174. 

  174. 	<td class="summary">A table where the key/values are the values and value counts of the sequence.</td>
    175. 

  175. 	</tr>
    176. 

  176. 

  177. 	<tr>
    178. 

  178. 	<td class="name" nowrap><a href="#enum">enum</a>&nbsp;(iter)</td>
    179. 

  179. 	<td class="summary">a sequence with a sequence count and the original value.</td>
    180. 

  180. 	</tr>
    181. 

  181. 

  182. 	<tr>
    183. 

  183. 	<td class="name" nowrap><a href="#filter">filter</a>&nbsp;(iter, pred, arg)</td>
    184. 

  184. 	<td class="summary">filter a sequence using a predicate function </td>
    185. 

  185. 	</tr>
    186. 

  186. 

  187. 	<tr>
    188. 

  188. 	<td class="name" nowrap><a href="#foreach">foreach</a>&nbsp;(iter, fn)</td>
    189. 

  189. 	<td class="summary">call the function on each element of the sequence.</td>
    190. 

  190. 	</tr>
    191. 

  191. 

  192. 	<tr>
    193. 

  193. 	<td class="name" nowrap><a href="#keys">keys</a>&nbsp;(t)</td>
    194. 

  194. 	<td class="summary">return the keys of the table.</td>
    195. 

  195. 	</tr>
    196. 

  196. 

  197. 	<tr>
    198. 

  198. 	<td class="name" nowrap><a href="#last">last</a>&nbsp;(iter)</td>
    199. 

  199. 	<td class="summary">a sequence of (last,current) values from another sequence.</td>
    200. 

  200. 	</tr>
    201. 

  201. 

  202. 	<tr>
    203. 

  203. 	<td class="name" nowrap><a href="#lines">lines</a>&nbsp;(f)</td>
    204. 

  204. 	<td class="summary">create a wrapped iterator over all lines in the file.</td>
    205. 

  205. 	</tr>
    206. 

  206. 

  207. 	<tr>
    208. 

  208. 	<td class="name" nowrap><a href="#list">list</a>&nbsp;(t)</td>
    209. 

  209. 	<td class="summary">sequence adaptor for a table.</td>
    210. 

  210. 	</tr>
    211. 

  211. 

  212. 	<tr>
    213. 

  213. 	<td class="name" nowrap><a href="#map">map</a>&nbsp;(fn, iter, arg)</td>
    214. 

  214. 	<td class="summary">return a sequence where every element of a sequence has been transformed by a function.</td>
    215. 

  215. 	</tr>
    216. 

  216. 

  217. 	<tr>
    218. 

  218. 	<td class="name" nowrap><a href="#mapmethod">mapmethod</a>&nbsp;(iter, name, arg1, arg2)</td>
    219. 

  219. 	<td class="summary">map using a named method over a sequence.</td>
    220. 

  220. 	</tr>
    221. 

  221. 

  222. 	<tr>
    223. 

  223. 	<td class="name" nowrap><a href="#matching">matching</a>&nbsp;(s, a)</td>
    224. 

  224. 	<td class="summary">given a string, return a function(y) which matches y against the string.</td>
    225. 

  225. 	</tr>
    226. 

  226. 

  227. 	<tr>
    228. 

  228. 	<td class="name" nowrap><a href="#minmax">minmax</a>&nbsp;(iter)</td>
    229. 

  229. 	<td class="summary">return the minimum and the maximum value of the sequence.</td>
    230. 

  230. 	</tr>
    231. 

  231. 

  232. 	<tr>
    233. 

  233. 	<td class="name" nowrap><a href="#random">random</a>&nbsp;(n, l, u)</td>
    234. 

  234. 	<td class="summary">return an iterator of random numbers.</td>
    235. 

  235. 	</tr>
    236. 

  236. 

  237. 	<tr>
    238. 

  238. 	<td class="name" nowrap><a href="#range">range</a>&nbsp;(start, finish)</td>
    239. 

  239. 	<td class="summary">create an iterator over a numerical range.</td>
    240. 

  240. 	</tr>
    241. 

  241. 

  242. 	<tr>
    243. 

  243. 	<td class="name" nowrap><a href="#reduce">reduce</a>&nbsp;(fun, seq, oldval)</td>
    244. 

  244. 	<td class="summary">'reduce' a sequence using a binary function.</td>
    245. 

  245. 	</tr>
    246. 

  246. 

  247. 	<tr>
    248. 

  248. 	<td class="name" nowrap><a href="#skip">skip</a>&nbsp;(iter, n)</td>
    249. 

  249. 	<td class="summary">skip the first n values of a sequence </td>
    250. 

  250. 	</tr>
    251. 

  251. 

  252. 	<tr>
    253. 

  253. 	<td class="name" nowrap><a href="#sort">sort</a>&nbsp;(iter, comp)</td>
    254. 

  254. 	<td class="summary">return an iterator to the sorted elements of a sequence.</td>
    255. 

  255. 	</tr>
    256. 

  256. 

  257. 	<tr>
    258. 

  258. 	<td class="name" nowrap><a href="#sum">sum</a>&nbsp;(iter, fn)</td>
    259. 

  259. 	<td class="summary">return the sum and element count of the sequence.</td>
    260. 

  260. 	</tr>
    261. 

  261. 

  262. 	<tr>
    263. 

  263. 	<td class="name" nowrap><a href="#take">take</a>&nbsp;(iter, n)</td>
    264. 

  264. 	<td class="summary">take the first n values from the sequence.</td>
    265. 

  265. 	</tr>
    266. 

  266. 

  267. 	<tr>
    268. 

  268. 	<td class="name" nowrap><a href="#zip">zip</a>&nbsp;(iter1, iter2)</td>
    269. 

  269. 	<td class="summary">return an iterator which returns elements of two sequences.</td>
    270. 

  270. 	</tr>
    271. 

  271. 

  272. </table>
    273. 

  273. 

  274. 

  275. 

  276. 

  277. 

  278. 

  279. <br/>
    280. 

  280. <br/>
    281. 

  281. 

  282. 

  283. 

  284. <h2><a name="functions"></a>Functions</h2>
    285. 

  285. <dl class="function">
    286. 

  286. 

  287. 

  288. 

  289. <dt><a name="copy"></a><strong>copy</strong>&nbsp;(iter)</dt>
    290. 

  290. <dd>
    291. 

  291. create a table from the sequence. (This will make the result a List.)
    292. 

  292. 

  293. 

  294. <h3>Parameters</h3>
    295. 

  295. <ul>
    296. 

  296. 	
    297. 

  297. 	<li>
    298. 

  298. 	  iter: a sequence
    299. 

  299. 	</li>
    300. 

  300. 	
    301. 

  301. </ul>
    302. 

  302. 

  303. 

  304. 

  305. 

  306. <h3>Usage</h3>
    307. 

  307. <ul>
    308. 

  308. 	
    309. 

  309. 	<li>copy(list(ls)) is equal to ls
    310. 

  310. 	
    311. 

  311. 	<li>copy(list {1,2,3},List) == List{1,2,3}
    312. 

  312. 	
    313. 

  313. </ul>
    314. 

  314. 

  315. 

  316. 

  317. <h3>Return value:</h3>
    318. 

  318. a List
    319. 

  319. 

  320. 

  321. 

  322. </dd>
    323. 

  323. 

  324. 

  325. 

  326. 

  327. <dt><a name="copy2"></a><strong>copy2</strong>&nbsp;(iter, i1, i2)</dt>
    328. 

  328. <dd>
    329. 

  329. create a table of pairs from the double-valued sequence.
    330. 

  330. 

  331. 

  332. <h3>Parameters</h3>
    333. 

  333. <ul>
    334. 

  334. 	
    335. 

  335. 	<li>
    336. 

  336. 	  iter: a double-valued sequence
    337. 

  337. 	</li>
    338. 

  338. 	
    339. 

  339. 	<li>
    340. 

  340. 	  i1: 
    341. 

  341. 	</li>
    342. 

  342. 	
    343. 

  343. 	<li>
    344. 

  344. 	  i2: 
    345. 

  345. 	</li>
    346. 

  346. 	
    347. 

  347. </ul>
    348. 

  348. 

  349. 

  350. 

  351. 

  352. 

  353. 

  354. <h3>Return value:</h3>
    355. 

  355. a list-like table
    356. 

  356. 

  357. 

  358. 

  359. </dd>
    360. 

  360. 

  361. 

  362. 

  363. 

  364. <dt><a name="copy_tuples"></a><strong>copy_tuples</strong>&nbsp;(iter)</dt>
    365. 

  365. <dd>
    366. 

  366. create a table of 'tuples' from a multi-valued sequence. A generalization of copy2 above
    367. 

  367. 

  368. 

  369. <h3>Parameters</h3>
    370. 

  370. <ul>
    371. 

  371. 	
    372. 

  372. 	<li>
    373. 

  373. 	  iter: a multiple-valued sequence
    374. 

  374. 	</li>
    375. 

  375. 	
    376. 

  376. </ul>
    377. 

  377. 

  378. 

  379. 

  380. 

  381. 

  382. 

  383. <h3>Return value:</h3>
    384. 

  384. a list-like table
    385. 

  385. 

  386. 

  387. 

  388. </dd>
    389. 

  389. 

  390. 

  391. 

  392. 

  393. <dt><a name="count_map"></a><strong>count_map</strong>&nbsp;(iter)</dt>
    394. 

  394. <dd>
    395. 

  395. A table where the key/values are the values and value counts of the sequence. This version works with 'hashable' values like strings and numbers. <br> pl.tablex.count_map is more general.
    396. 

  396. 

  397. 

  398. <h3>Parameters</h3>
    399. 

  399. <ul>
    400. 

  400. 	
    401. 

  401. 	<li>
    402. 

  402. 	  iter: 
    403. 

  403. 	</li>
    404. 

  404. 	
    405. 

  405. </ul>
    406. 

  406. 

  407. 

  408. 

  409. 

  410. 

  411. 

  412. <h3>Return values:</h3>
    413. 

  413. <ol>
    414. 

  414. 	
    415. 

  415. 	<li>a map-like table
    416. 

  416. 	
    417. 

  417. 	<li>a table
    418. 

  418. 	
    419. 

  419. </ol>
    420. 

  420. 

  421. 

  422. 

  423. <h3>See also:</h3>
    424. 

  424. <ul>
    425. 

  425. 	
    426. 

  426. 	<li><a href="../modules/pl.tablex.html#count_map">
    427. 

  427. 		pl.tablex.count_map
    428. 

  428. 	</a>
    429. 

  429. 	
    430. 

  430. </ul>
    431. 

  431. 

  432. </dd>
    433. 

  433. 

  434. 

  435. 

  436. 

  437. <dt><a name="enum"></a><strong>enum</strong>&nbsp;(iter)</dt>
    438. 

  438. <dd>
    439. 

  439. a sequence with a sequence count and the original value. <br> enum(copy(ls)) is a roundabout way of saying ipairs(ls).
    440. 

  440. 

  441. 

  442. <h3>Parameters</h3>
    443. 

  443. <ul>
    444. 

  444. 	
    445. 

  445. 	<li>
    446. 

  446. 	  iter: a single or double valued sequence
    447. 

  447. 	</li>
    448. 

  448. 	
    449. 

  449. </ul>
    450. 

  450. 

  451. 

  452. 

  453. 

  454. 

  455. 

  456. <h3>Return value:</h3>
    457. 

  457. sequence of (i,v), i = 1..n and v is from iter.
    458. 

  458. 

  459. 

  460. 

  461. </dd>
    462. 

  462. 

  463. 

  464. 

  465. 

  466. <dt><a name="filter"></a><strong>filter</strong>&nbsp;(iter, pred, arg)</dt>
    467. 

  467. <dd>
    468. 

  468. filter a sequence using a predicate function
    469. 

  469. 

  470. 

  471. <h3>Parameters</h3>
    472. 

  472. <ul>
    473. 

  473. 	
    474. 

  474. 	<li>
    475. 

  475. 	  iter: a sequence of one or two values
    476. 

  476. 	</li>
    477. 

  477. 	
    478. 

  478. 	<li>
    479. 

  479. 	  pred: a boolean function; may take two arguments
    480. 

  480. 	</li>
    481. 

  481. 	
    482. 

  482. 	<li>
    483. 

  483. 	  arg: optional argument to pass to function.
    484. 

  484. 	</li>
    485. 

  485. 	
    486. 

  486. </ul>
    487. 

  487. 

  488. 

  489. 

  490. 

  491. 

  492. 

  493. 

  494. 

  495. </dd>
    496. 

  496. 

  497. 

  498. 

  499. 

  500. <dt><a name="foreach"></a><strong>foreach</strong>&nbsp;(iter, fn)</dt>
    501. 

  501. <dd>
    502. 

  502. call the function on each element of the sequence.
    503. 

  503. 

  504. 

  505. <h3>Parameters</h3>
    506. 

  506. <ul>
    507. 

  507. 	
    508. 

  508. 	<li>
    509. 

  509. 	  iter: a sequence with up to 3 values
    510. 

  510. 	</li>
    511. 

  511. 	
    512. 

  512. 	<li>
    513. 

  513. 	  fn: a function
    514. 

  514. 	</li>
    515. 

  515. 	
    516. 

  516. </ul>
    517. 

  517. 

  518. 

  519. 

  520. 

  521. 

  522. 

  523. 

  524. 

  525. </dd>
    526. 

  526. 

  527. 

  528. 

  529. 

  530. <dt><a name="keys"></a><strong>keys</strong>&nbsp;(t)</dt>
    531. 

  531. <dd>
    532. 

  532. return the keys of the table.
    533. 

  533. 

  534. 

  535. <h3>Parameters</h3>
    536. 

  536. <ul>
    537. 

  537. 	
    538. 

  538. 	<li>
    539. 

  539. 	  t: a list-like table
    540. 

  540. 	</li>
    541. 

  541. 	
    542. 

  542. </ul>
    543. 

  543. 

  544. 

  545. 

  546. 

  547. 

  548. 

  549. <h3>Return value:</h3>
    550. 

  550. iterator over keys
    551. 

  551. 

  552. 

  553. 

  554. </dd>
    555. 

  555. 

  556. 

  557. 

  558. 

  559. <dt><a name="last"></a><strong>last</strong>&nbsp;(iter)</dt>
    560. 

  560. <dd>
    561. 

  561. a sequence of (last,current) values from another sequence. This will return S(i-1),S(i) if given S(i)
    562. 

  562. 

  563. 

  564. <h3>Parameters</h3>
    565. 

  565. <ul>
    566. 

  566. 	
    567. 

  567. 	<li>
    568. 

  568. 	  iter: a sequence
    569. 

  569. 	</li>
    570. 

  570. 	
    571. 

  571. </ul>
    572. 

  572. 

  573. 

  574. 

  575. 

  576. 

  577. 

  578. 

  579. 

  580. </dd>
    581. 

  581. 

  582. 

  583. 

  584. 

  585. <dt><a name="lines"></a><strong>lines</strong>&nbsp;(f)</dt>
    586. 

  586. <dd>
    587. 

  587. create a wrapped iterator over all lines in the file.
    588. 

  588. 

  589. 

  590. <h3>Parameters</h3>
    591. 

  591. <ul>
    592. 

  592. 	
    593. 

  593. 	<li>
    594. 

  594. 	  f: either a filename or nil (for standard input)
    595. 

  595. 	</li>
    596. 

  596. 	
    597. 

  597. </ul>
    598. 

  598. 

  599. 

  600. 

  601. 

  602. 

  603. 

  604. <h3>Return value:</h3>
    605. 

  605. a sequence wrapper
    606. 

  606. 

  607. 

  608. 

  609. </dd>
    610. 

  610. 

  611. 

  612. 

  613. 

  614. <dt><a name="list"></a><strong>list</strong>&nbsp;(t)</dt>
    615. 

  615. <dd>
    616. 

  616. sequence adaptor for a table.   Note that if any generic function is passed a table, it will automatically use seq.list()
    617. 

  617. 

  618. 

  619. <h3>Parameters</h3>
    620. 

  620. <ul>
    621. 

  621. 	
    622. 

  622. 	<li>
    623. 

  623. 	  t: a list-like table
    624. 

  624. 	</li>
    625. 

  625. 	
    626. 

  626. </ul>
    627. 

  627. 

  628. 

  629. 

  630. 

  631. <h3>Usage</h3>
    632. 

  632. <ul>
    633. 

  633. 	
    634. 

  634. 	<li>sum(list(t)) is the sum of all elements of t
    635. 

  635. 	
    636. 

  636. 	<li>for x in list(t) do...end
    637. 

  637. 	
    638. 

  638. </ul>
    639. 

  639. 

  640. 

  641. 

  642. 

  643. 

  644. </dd>
    645. 

  645. 

  646. 

  647. 

  648. 

  649. <dt><a name="map"></a><strong>map</strong>&nbsp;(fn, iter, arg)</dt>
    650. 

  650. <dd>
    651. 

  651. return a sequence where every element of a sequence has been transformed by a function. If you don't supply an argument, then the function will receive both values of a double-valued sequence, otherwise behaves rather like tablex.map.
    652. 

    653. 

  653. 

  654. <h3>Parameters</h3>
    655. 

  655. <ul>
    656. 

  656. 	
    657. 

  657. 	<li>
    658. 

  658. 	  fn: a function to apply to elements; may take two arguments
    659. 

  659. 	</li>
    660. 

  660. 	
    661. 

  661. 	<li>
    662. 

  662. 	  iter: a sequence of one or two values
    663. 

  663. 	</li>
    664. 

  664. 	
    665. 

  665. 	<li>
    666. 

  666. 	  arg: optional argument to pass to function.
    667. 

  667. 	</li>
    668. 

  668. 	
    669. 

  669. </ul>
    670. 

  670. 

  671. 

  672. 

  673. 

  674. 

  675. 

  676. 

  677. 

  678. </dd>
    679. 

  679. 

  680. 

  681. 

  682. 

  683. <dt><a name="mapmethod"></a><strong>mapmethod</strong>&nbsp;(iter, name, arg1, arg2)</dt>
    684. 

  684. <dd>
    685. 

  685. map using a named method over a sequence.
    686. 

  686. 

  687. 

  688. <h3>Parameters</h3>
    689. 

  689. <ul>
    690. 

  690. 	
    691. 

  691. 	<li>
    692. 

  692. 	  iter: a sequence
    693. 

  693. 	</li>
    694. 

  694. 	
    695. 

  695. 	<li>
    696. 

  696. 	  name: the method name
    697. 

  697. 	</li>
    698. 

  698. 	
    699. 

  699. 	<li>
    700. 

  700. 	  arg1: optional second extra argument
    701. 

  701. 	</li>
    702. 

  702. 	
    703. 

  703. 	<li>
    704. 

  704. 	  arg2: 
    705. 

  705. 	</li>
    706. 

  706. 	
    707. 

  707. </ul>
    708. 

  708. 

  709. 

  710. 

  711. 

  712. 

  713. 

  714. 

  715. 

  716. </dd>
    717. 

  717. 

  718. 

  719. 

  720. 

  721. <dt><a name="matching"></a><strong>matching</strong>&nbsp;(s, a)</dt>
    722. 

  722. <dd>
    723. 

  723. given a string, return a function(y) which matches y against the string.
    724. 

  724. 

  725. 

  726. <h3>Parameters</h3>
    727. 

  727. <ul>
    728. 

  728. 	
    729. 

  729. 	<li>
    730. 

  730. 	  s: 
    731. 

  731. 	</li>
    732. 

  732. 	
    733. 

  733. 	<li>
    734. 

  734. 	  a: string
    735. 

  735. 	</li>
    736. 

  736. 	
    737. 

  737. </ul>
    738. 

  738. 

  739. 

  740. 

  741. 

  742. 

  743. 

  744. 

  745. 

  746. </dd>
    747. 

  747. 

  748. 

  749. 

  750. 

  751. <dt><a name="minmax"></a><strong>minmax</strong>&nbsp;(iter)</dt>
    752. 

  752. <dd>
    753. 

  753. return the minimum and the maximum value of the sequence.
    754. 

  754. 

  755. 

  756. <h3>Parameters</h3>
    757. 

  757. <ul>
    758. 

  758. 	
    759. 

  759. 	<li>
    760. 

  760. 	  iter: a sequence
    761. 

  761. 	</li>
    762. 

  762. 	
    763. 

  763. </ul>
    764. 

  764. 

  765. 

  766. 

  767. 

  768. 

  769. 

  770. 

  771. 

  772. </dd>
    773. 

  773. 

  774. 

  775. 

  776. 

  777. <dt><a name="random"></a><strong>random</strong>&nbsp;(n, l, u)</dt>
    778. 

  778. <dd>
    779. 

  779. return an iterator of random numbers.
    780. 

  780. 

  781. 

  782. <h3>Parameters</h3>
    783. 

  783. <ul>
    784. 

  784. 	
    785. 

  785. 	<li>
    786. 

  786. 	  n: the length of the sequence
    787. 

  787. 	</li>
    788. 

  788. 	
    789. 

  789. 	<li>
    790. 

  790. 	  l: same as the first optional argument to math.random
    791. 

  791. 	</li>
    792. 

  792. 	
    793. 

  793. 	<li>
    794. 

  794. 	  u: same as the second optional argument to math.random
    795. 

  795. 	</li>
    796. 

  796. 	
    797. 

  797. </ul>
    798. 

  798. 

  799. 

  800. 

  801. 

  802. 

  803. 

  804. <h3>Return value:</h3>
    805. 

  805. a sequnce
    806. 

  806. 

  807. 

  808. 

  809. </dd>
    810. 

  810. 

  811. 

  812. 

  813. 

  814. <dt><a name="range"></a><strong>range</strong>&nbsp;(start, finish)</dt>
    815. 

  815. <dd>
    816. 

  816. create an iterator over a numerical range. Like the standard Python function xrange.
    817. 

  817. 

  818. 

  819. <h3>Parameters</h3>
    820. 

  820. <ul>
    821. 

  821. 	
    822. 

  822. 	<li>
    823. 

  823. 	  start: a number
    824. 

  824. 	</li>
    825. 

  825. 	
    826. 

  826. 	<li>
    827. 

  827. 	  finish: a number greater than start
    828. 

  828. 	</li>
    829. 

  829. 	
    830. 

  830. </ul>
    831. 

  831. 

  832. 

  833. 

  834. 

  835. 

  836. 

  837. 

  838. 

  839. </dd>
    840. 

  840. 

  841. 

  842. 

  843. 

  844. <dt><a name="reduce"></a><strong>reduce</strong>&nbsp;(fun, seq, oldval)</dt>
    845. 

  845. <dd>
    846. 

  846. 'reduce' a sequence using a binary function.
    847. 

  847. 

  848. 

  849. <h3>Parameters</h3>
    850. 

  850. <ul>
    851. 

  851. 	
    852. 

  852. 	<li>
    853. 

  853. 	  fun: a function of two arguments
    854. 

  854. 	</li>
    855. 

  855. 	
    856. 

  856. 	<li>
    857. 

  857. 	  seq: a sequence
    858. 

  858. 	</li>
    859. 

  859. 	
    860. 

  860. 	<li>
    861. 

  861. 	  oldval: 
    862. 

  862. 	</li>
    863. 

  863. 	
    864. 

  864. </ul>
    865. 

  865. 

  866. 

  867. 

  868. 

  869. <h3>Usage:</h3>
    870. 

  870. seq.reduce(operator.add,seq.list{1,2,3,4}) == 10
    871. 

  871. 

  872. 

  873. 

  874. 

  875. 

  876. </dd>
    877. 

  877. 

  878. 

  879. 

  880. 

  881. <dt><a name="skip"></a><strong>skip</strong>&nbsp;(iter, n)</dt>
    882. 

  882. <dd>
    883. 

  883. skip the first n values of a sequence
    884. 

  884. 

  885. 

  886. <h3>Parameters</h3>
    887. 

  887. <ul>
    888. 

  888. 	
    889. 

  889. 	<li>
    890. 

  890. 	  iter: a sequence of one or more values
    891. 

  891. 	</li>
    892. 

  892. 	
    893. 

  893. 	<li>
    894. 

  894. 	  n: number of items to skip
    895. 

  895. 	</li>
    896. 

  896. 	
    897. 

  897. </ul>
    898. 

  898. 

  899. 

  900. 

  901. 

  902. 

  903. 

  904. 

  905. 

  906. </dd>
    907. 

  907. 

  908. 

  909. 

  910. 

  911. <dt><a name="sort"></a><strong>sort</strong>&nbsp;(iter, comp)</dt>
    912. 

  912. <dd>
    913. 

  913. return an iterator to the sorted elements of a sequence.
    914. 

  914. 

  915. 

  916. <h3>Parameters</h3>
    917. 

  917. <ul>
    918. 

  918. 	
    919. 

  919. 	<li>
    920. 

  920. 	  iter: a sequence
    921. 

  921. 	</li>
    922. 

  922. 	
    923. 

  923. 	<li>
    924. 

  924. 	  comp: an optional comparison function (comp(x,y) is true if x < y)
    925. 

  925. 	</li>
    926. 

  926. 	
    927. 

  927. </ul>
    928. 

  928. 

  929. 

  930. 

  931. 

  932. 

  933. 

  934. 

  935. 

  936. </dd>
    937. 

  937. 

  938. 

  939. 

  940. 

  941. <dt><a name="sum"></a><strong>sum</strong>&nbsp;(iter, fn)</dt>
    942. 

  942. <dd>
    943. 

  943. return the sum and element count of the sequence.
    944. 

  944. 

  945. 

  946. <h3>Parameters</h3>
    947. 

  947. <ul>
    948. 

  948. 	
    949. 

  949. 	<li>
    950. 

  950. 	  iter: a sequence
    951. 

  951. 	</li>
    952. 

  952. 	
    953. 

  953. 	<li>
    954. 

  954. 	  fn: an optional function to apply to the values
    955. 

  955. 	</li>
    956. 

  956. 	
    957. 

  957. </ul>
    958. 

  958. 

  959. 

  960. 

  961. 

  962. 

  963. 

  964. 

  965. 

  966. </dd>
    967. 

  967. 

  968. 

  969. 

  970. 

  971. <dt><a name="take"></a><strong>take</strong>&nbsp;(iter, n)</dt>
    972. 

  972. <dd>
    973. 

  973. take the first n values from the sequence.
    974. 

  974. 

  975. 

  976. <h3>Parameters</h3>
    977. 

  977. <ul>
    978. 

  978. 	
    979. 

  979. 	<li>
    980. 

  980. 	  iter: a sequence of one or two values
    981. 

  981. 	</li>
    982. 

  982. 	
    983. 

  983. 	<li>
    984. 

  984. 	  n: number of items to take
    985. 

  985. 	</li>
    986. 

  986. 	
    987. 

  987. </ul>
    988. 

  988. 

  989. 

  990. 

  991. 

  992. 

  993. 

  994. <h3>Return value:</h3>
    995. 

  995. a sequence of at most n items
    996. 

  996. 

  997. 

  998. 

  999. </dd>
    1000. 

  1000. 

  1001. 

  1002. 

  1003. 

  1004. <dt><a name="zip"></a><strong>zip</strong>&nbsp;(iter1, iter2)</dt>
    1005. 

  1005. <dd>
    1006. 

  1006. return an iterator which returns elements of two sequences.
    1007. 

  1007. 

  1008. 

  1009. <h3>Parameters</h3>
    1010. 

  1010. <ul>
    1011. 

  1011. 	
    1012. 

  1012. 	<li>
    1013. 

  1013. 	  iter1: a sequence
    1014. 

  1014. 	</li>
    1015. 

  1015. 	
    1016. 

  1016. 	<li>
    1017. 

  1017. 	  iter2: a sequence
    1018. 

  1018. 	</li>
    1019. 

  1019. 	
    1020. 

  1020. </ul>
    1021. 

  1021. 

  1022. 

  1023. 

  1024. 

  1025. <h3>Usage:</h3>
    1026. 

  1026. for x,y in seq.zip(ls1,ls2) do....end
    1027. 

  1027. 

  1028. 

  1029. 

  1030. 

  1031. 

  1032. </dd>
    1033. 

  1033. 

  1034. 

  1035. </dl>
    1036. 

  1036. 

  1037. 

  1038. 

  1039. 

  1040. 

  1041. 

  1042. </div> <!-- id="content" -->
    1043. 

  1043. 

  1044. </div> <!-- id="main" -->
    1045. 

  1045. 

  1046. <div id="about">
    1047. 

  1047. 	<p><a href="http://validator.w3.org/check?uri=referer"><img src="http://www.w3.org/Icons/valid-xhtml10" alt="Valid XHTML 1.0!" height="31" width="88" /></a></p>
    1048. 

  1048. </div> <!-- id="about" -->
    1049. 

  1049. 

  1050. </div> <!-- id="container" -->	
    1051. 

  1051. </body>
    1052. 

  1052. </html>
    1053.