PageRenderTime 28ms CodeModel.GetById 0ms RepoModel.GetById 0ms app.codeStats 0ms

/libstdc++-v3/doc/html/ext/pb_ds/priority_queue.html

https://bitbucket.org/pizzafactory/pf-gcc
HTML | 995 lines | 828 code | 167 blank | 0 comment | 0 complexity | 5fbd690ec1460d6f27de6b969133bd9e MD5 | raw file
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  2. "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  3. <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
  4. <head>
  5. <meta name="generator" content=
  6. "HTML Tidy for Linux/x86 (vers 12 April 2005), see www.w3.org" />
  7. <title>priority_queue Interface</title>
  8. <meta http-equiv="Content-Type" content=
  9. "text/html; charset=us-ascii" />
  10. </head>
  11. <body>
  12. <div id="page">
  13. <h1><tt>priority_queue</tt> Interface</h1>
  14. <p>Basic priority queue.</p>
  15. <p>Defined in: <a href=
  16. "http://gcc.gnu.org/viewcvs/*checkout*/trunk/libstdc%2B%2B-v3/include/ext/pb_ds/priority_queue.hpp"><tt>priority_queue.hpp</tt></a></p>
  17. <h2><a name="link1" id="link1">Template Parameters</a></h2>
  18. <table class="c1" width="100%" border="1" summary=
  19. "Template Parameters">
  20. <tr>
  21. <td width="20%" align="left"><b>Parameter</b></td>
  22. <td width="50%" align="left"><b>Description</b></td>
  23. <td width="30%" align="left"><b>Default Value</b></td>
  24. </tr>
  25. <tr>
  26. <td>
  27. <pre>
  28. <a name="Value_Type216514186" id=
  29. "Value_Type216514186"><b>typename</b> Value_Type</a>
  30. </pre>
  31. </td>
  32. <td>
  33. <p>Value type.</p>
  34. </td>
  35. <td>-</td>
  36. </tr>
  37. <tr>
  38. <td>
  39. <pre>
  40. <a name="Cmp_Fn294335" id="Cmp_Fn294335"><b>class</b> Cmp_Fn </a>
  41. </pre>
  42. </td>
  43. <td>
  44. <p>Comparison functor.</p>
  45. </td>
  46. <td>
  47. <pre>
  48. std::less&lt;<a href=
  49. "#Value_Type216514186"><tt>Value_Type</tt></a>&gt;
  50. </pre>
  51. </td>
  52. </tr>
  53. <tr>
  54. <td>
  55. <pre>
  56. <a name="Tag278938" id="Tag278938"><b>class</b> Tag </a>
  57. </pre>
  58. </td>
  59. <td>
  60. <p>Data-structure tag.</p>
  61. </td>
  62. <td><a href="pairing_heap_tag.html"><span class=
  63. "c2"><tt>pairing_heap_tag</tt></span></a></td>
  64. </tr>
  65. <tr>
  66. <td>
  67. <pre>
  68. <a name="Allocator35940069" id=
  69. "Allocator35940069"><b>class</b> Allocator </a>
  70. </pre>
  71. </td>
  72. <td>
  73. <p>Allocator type.</p>
  74. </td>
  75. <td>
  76. <pre>
  77. std::allocator&lt;<b>char</b>&gt;
  78. </pre>
  79. </td>
  80. </tr>
  81. </table>
  82. <h2><a name="link2" id="link2">Public Types and
  83. Constants</a></h2>
  84. <h3><a name="link3" id="link3">General Container
  85. Definitions</a></h3>
  86. <table class="c1" width="100%" border="1" summary="Types">
  87. <tr>
  88. <td width="30%" align="left"><b>Type</b></td>
  89. <td width="55%" align="left"><b>Definition</b></td>
  90. <td width="15%" align="left"><b>Description</b></td>
  91. </tr>
  92. <tr>
  93. <td>
  94. <pre>
  95. <a name="size_type55424436" id="size_type55424436">size_type</a>
  96. </pre>
  97. </td>
  98. <td>
  99. <pre>
  100. <b>typename</b> <a href=
  101. "#Allocator35940069"><tt>Allocator</tt></a>::size_type
  102. </pre>
  103. </td>
  104. <td>
  105. <p>Size type.</p>
  106. </td>
  107. </tr>
  108. <tr>
  109. <td>
  110. <pre>
  111. <a name="difference_type868028452" id=
  112. "difference_type868028452">difference_type</a>
  113. </pre>
  114. </td>
  115. <td>
  116. <pre>
  117. <b>typename</b> <a href=
  118. "#Allocator35940069"><tt>Allocator</tt></a>::difference_type
  119. </pre>
  120. </td>
  121. <td>
  122. <p>Difference type.</p>
  123. </td>
  124. </tr>
  125. </table>
  126. <h3><a name="link4" id="link4">Categories</a></h3>
  127. <table class="c1" width="100%" border="1" summary="Types">
  128. <tr>
  129. <td width="30%" align="left"><b>Type</b></td>
  130. <td width="55%" align="left"><b>Definition</b></td>
  131. <td width="15%" align="left"><b>Description</b></td>
  132. </tr>
  133. <tr>
  134. <td>
  135. <pre>
  136. <a name="container_category1247973216" id=
  137. "container_category1247973216">container_category</a>
  138. </pre>
  139. </td>
  140. <td>
  141. <pre>
  142. <a href="#Tag278938"><tt>Tag</tt></a>
  143. </pre>
  144. </td>
  145. <td>
  146. <p>The underlying mapped-structure tag of the
  147. container.</p>
  148. <p>This is one of:</p>
  149. <ol>
  150. <li><a href="binary_heap_tag.html"><span class=
  151. "c2"><tt>binary_heap_tag</tt></span></a></li>
  152. <li><a href="binomial_heap_tag.html"><span class=
  153. "c2"><tt>binomial_heap_tag</tt></span></a></li>
  154. <li><a href="rc_binomial_heap_tag.html"><span class=
  155. "c2"><tt>rc_binomial_heap_tag</tt></span></a></li>
  156. <li><a href="pairing_heap_tag.html"><span class=
  157. "c2"><tt>pairing_heap_tag</tt></span></a></li>
  158. <li><a href="thin_heap_tag.html"><span class=
  159. "c2"><tt>thin_heap_tag</tt></span></a></li>
  160. </ol>
  161. </td>
  162. </tr>
  163. </table>
  164. <h3><a name="link5" id="link5">Policy Definitions</a></h3>
  165. <table class="c1" width="100%" border="1" summary="Types">
  166. <tr>
  167. <td width="30%" align="left"><b>Type</b></td>
  168. <td width="55%" align="left"><b>Definition</b></td>
  169. <td width="15%" align="left"><b>Description</b></td>
  170. </tr>
  171. <tr>
  172. <td>
  173. <pre>
  174. <a name="cmp_fn394495" id="cmp_fn394495">cmp_fn</a>
  175. </pre>
  176. </td>
  177. <td>
  178. <pre>
  179. <a href="#Cmp_Fn294335"><tt>Cmp_Fn</tt></a>
  180. </pre>
  181. </td>
  182. <td>
  183. <p>Comparison functor type.</p>
  184. </td>
  185. </tr>
  186. <tr>
  187. <td>
  188. <pre>
  189. <a name="allocator48440069" id="allocator48440069">allocator</a>
  190. </pre>
  191. </td>
  192. <td>
  193. <pre>
  194. <a href="#Allocator35940069"><tt>Allocator</tt></a>
  195. </pre>
  196. </td>
  197. <td>
  198. <p><a href="#Allocator35940069"><tt>Allocator</tt></a>
  199. type.</p>
  200. </td>
  201. </tr>
  202. </table>
  203. <h3><a name="link6" id="link6">Value-Type Definitions</a></h3>
  204. <table class="c1" width="100%" border="1" summary="Types">
  205. <tr>
  206. <td width="30%" align="left"><b>Type</b></td>
  207. <td width="55%" align="left"><b>Definition</b></td>
  208. <td width="15%" align="left"><b>Description</b></td>
  209. </tr>
  210. <tr>
  211. <td>
  212. <pre>
  213. <a name="value_type279018186" id=
  214. "value_type279018186">value_type</a>
  215. </pre>
  216. </td>
  217. <td>
  218. <pre>
  219. <a href="#Value_Type216514186"><tt>Value_Type</tt></a>
  220. </pre>
  221. </td>
  222. <td>
  223. <p>Value type.</p>
  224. </td>
  225. </tr>
  226. <tr>
  227. <td>
  228. <pre>
  229. <a name="reference54418471" id="reference54418471">reference</a>
  230. </pre>
  231. </td>
  232. <td>
  233. <pre>
  234. <b>typename</b> <a href=
  235. "#allocator48440069"><tt>allocator</tt></a>::<b>template</b> rebind&lt;
  236. <a href=
  237. "#value_type279018186"><tt>value_type</tt></a>&gt;::other::reference
  238. </pre>
  239. </td>
  240. <td>
  241. <p>Value reference type.</p>
  242. </td>
  243. </tr>
  244. <tr>
  245. <td>
  246. <pre>
  247. <a name="const_reference495461441" id=
  248. "const_reference495461441">const_reference</a>
  249. </pre>
  250. </td>
  251. <td>
  252. <pre>
  253. <b>typename</b> <a href=
  254. "#allocator48440069"><tt>allocator</tt></a>::<b>template</b> rebind&lt;
  255. <a href=
  256. "#value_type279018186"><tt>value_type</tt></a>&gt;::other::const_reference
  257. </pre>
  258. </td>
  259. <td>
  260. <p>Const value <a href=
  261. "#reference54418471"><tt>reference</tt></a> type.</p>
  262. </td>
  263. </tr>
  264. <tr>
  265. <td>
  266. <pre>
  267. <a name="pointer2179769" id="pointer2179769">pointer</a>
  268. </pre>
  269. </td>
  270. <td>
  271. <pre>
  272. <b>typename</b> <a href=
  273. "#allocator48440069"><tt>allocator</tt></a>::<b>template</b> rebind&lt;
  274. <a href=
  275. "#value_type279018186"><tt>value_type</tt></a>&gt;::other::pointer
  276. </pre>
  277. </td>
  278. <td>
  279. <p>Value pointer type.</p>
  280. </td>
  281. </tr>
  282. <tr>
  283. <td>
  284. <pre>
  285. <a name="const_pointer878814947" id=
  286. "const_pointer878814947">const_pointer</a>
  287. </pre>
  288. </td>
  289. <td>
  290. <pre>
  291. <b>typename</b> <a href=
  292. "#allocator48440069"><tt>allocator</tt></a>::<b>template</b> rebind&lt;
  293. <a href=
  294. "#value_type279018186"><tt>value_type</tt></a>&gt;::other::const_pointer
  295. </pre>
  296. </td>
  297. <td>
  298. <p>Const Value <a href=
  299. "#pointer2179769"><tt>pointer</tt></a> type.</p>
  300. </td>
  301. </tr>
  302. </table>
  303. <h3><a name="link7" id="link7">Iterator Definitions</a></h3>
  304. <table class="c1" width="100%" border="1" summary="Types">
  305. <tr>
  306. <td width="30%" align="left"><b>Type</b></td>
  307. <td width="55%" align="left"><b>Definition</b></td>
  308. <td width="15%" align="left"><b>Description</b></td>
  309. </tr>
  310. <tr>
  311. <td>
  312. <pre>
  313. <a name="const_point_iterator2364676009" id=
  314. "const_point_iterator2364676009">const_point_iterator</a>
  315. </pre>
  316. </td>
  317. <td>
  318. <pre>
  319. Const point-type iterator.
  320. </pre>
  321. </td>
  322. <td>
  323. <p>Const point-type iterator.</p>
  324. </td>
  325. </tr>
  326. <tr>
  327. <td>
  328. <pre>
  329. <a name="point_iterator2789896775" id=
  330. "point_iterator2789896775">point_iterator</a>
  331. </pre>
  332. </td>
  333. <td>
  334. <pre>
  335. Point-type iterator.
  336. </pre>
  337. </td>
  338. <td>
  339. <p>Point-type iterator.</p>
  340. </td>
  341. </tr>
  342. <tr>
  343. <td>
  344. <pre>
  345. <a name="const_iterator98626788" id=
  346. "const_iterator98626788">const_iterator</a>
  347. </pre>
  348. </td>
  349. <td>
  350. <pre>
  351. Const range-type iterator.
  352. </pre>
  353. </td>
  354. <td>
  355. <p>Const range-type iterator.</p>
  356. </td>
  357. </tr>
  358. <tr>
  359. <td>
  360. <pre>
  361. <a name="iterator10418194" id="iterator10418194">iterator</a>
  362. </pre>
  363. </td>
  364. <td>
  365. <pre>
  366. Range-type iterator.
  367. </pre>
  368. </td>
  369. <td>
  370. <p>Range-type iterator.</p>
  371. </td>
  372. </tr>
  373. </table>
  374. <h2><a name="link8" id="link8">Public Methods</a></h2>
  375. <h3><a name="link9" id="link9">Constructors, Destructor, and
  376. Related</a></h3>
  377. <table class="c1" width="100%" border="1" summary="Methods">
  378. <tr>
  379. <td width="45%" align="left"><b>Method</b></td>
  380. <td width="55%" align="left"><b>Description</b></td>
  381. </tr>
  382. <tr>
  383. <td>
  384. <pre>
  385. priority_queue
  386. ()
  387. </pre>
  388. </td>
  389. <td>
  390. <p>Default constructor.</p>
  391. </td>
  392. </tr>
  393. <tr>
  394. <td>
  395. <pre>
  396. priority_queue
  397. (<b>const</b> <a href=
  398. "#cmp_fn394495"><tt>cmp_fn</tt></a> &amp;r_cmp_fn)
  399. </pre>
  400. </td>
  401. <td>
  402. <p>Constructor taking some policy objects. <span class=
  403. "c1"><tt>r_cmp_fn</tt></span> will be copied by the
  404. <a href="#Cmp_Fn294335"><tt>Cmp_Fn</tt></a> object of the
  405. container object.</p>
  406. </td>
  407. </tr>
  408. <tr>
  409. <td>
  410. <pre>
  411. <b>template</b>&lt;
  412. <b>class</b> It&gt;
  413. priority_queue
  414. (It first_it,
  415. It last_it)
  416. </pre>
  417. </td>
  418. <td>
  419. <p>Constructor taking iterators to a range of <a href=
  420. "#value_type279018186"><tt>value_type</tt></a>s. The
  421. <a href="#value_type279018186"><tt>value_type</tt></a>s
  422. between <span class="c1"><tt>first_it</tt></span> and
  423. <span class="c1"><tt>last_it</tt></span> will be inserted
  424. into the container object.</p>
  425. </td>
  426. </tr>
  427. <tr>
  428. <td>
  429. <pre>
  430. <b>template</b>&lt;
  431. <b>class</b> It&gt;
  432. priority_queue
  433. (It first_it,
  434. It last_it,
  435. <b>const</b> <a href=
  436. "#cmp_fn394495"><tt>cmp_fn</tt></a> &amp;r_cmp_fn)
  437. </pre>
  438. </td>
  439. <td>
  440. <p>Constructor taking iterators to a range of <a href=
  441. "#value_type279018186"><tt>value_type</tt></a>s and some
  442. policy objects The <a href=
  443. "#value_type279018186"><tt>value_type</tt></a>s between
  444. <span class="c1"><tt>first_it</tt></span> and
  445. <span class="c1"><tt>last_it</tt></span> will be inserted
  446. into the container object. <span class=
  447. "c1"><tt>r_cmp_fn</tt></span> will be copied by the
  448. <a href="#cmp_fn394495"><tt>cmp_fn</tt></a> object of the
  449. container object.</p>
  450. </td>
  451. </tr>
  452. <tr>
  453. <td>
  454. <pre>
  455. priority_queue
  456. (<b>const</b> <span class=
  457. "c2"><tt>priority_queue</tt></span> &amp;other)
  458. </pre>
  459. </td>
  460. <td>
  461. <p>Copy constructor.</p>
  462. </td>
  463. </tr>
  464. <tr>
  465. <td>
  466. <pre>
  467. <b>virtual</b>
  468. ~priority_queue
  469. ()
  470. </pre>
  471. </td>
  472. <td>
  473. <p>Destructor.</p>
  474. </td>
  475. </tr>
  476. <tr>
  477. <td>
  478. <pre>
  479. <span class="c2"><tt>priority_queue</tt></span> &amp;
  480. <b>operator</b>=
  481. (<b>const</b> <span class=
  482. "c2"><tt>priority_queue</tt></span> &amp;other)
  483. </pre>
  484. </td>
  485. <td>
  486. <p>Assignment operator.</p>
  487. </td>
  488. </tr>
  489. <tr>
  490. <td>
  491. <pre>
  492. <b>void</b>
  493. swap
  494. (<span class="c2"><tt>priority_queue</tt></span> &amp;other)
  495. </pre>
  496. </td>
  497. <td>
  498. <p>Swaps content.</p>
  499. </td>
  500. </tr>
  501. </table>
  502. <h3><a name="link10" id="link10">Information Methods</a></h3>
  503. <table class="c1" width="100%" border="1" summary="Methods">
  504. <tr>
  505. <td width="45%" align="left"><b>Method</b></td>
  506. <td width="55%" align="left"><b>Description</b></td>
  507. </tr>
  508. <tr>
  509. <td>
  510. <pre>
  511. <b>inline</b> <a href="#size_type55424436"><tt>size_type</tt></a>
  512. size
  513. () <b>const</b>
  514. </pre>
  515. </td>
  516. <td>
  517. <p>Returns the number of distinct <a href=
  518. "#value_type279018186"><tt>value_type</tt></a> objects
  519. the container object is storing.</p>
  520. </td>
  521. </tr>
  522. <tr>
  523. <td>
  524. <pre>
  525. <b>inline</b> <a href="#size_type55424436"><tt>size_type</tt></a>
  526. max_size
  527. () <b>const</b>
  528. </pre>
  529. </td>
  530. <td>
  531. <p>Returns an upper bound on the number of distinct
  532. <a href="#value_type279018186"><tt>value_type</tt></a>
  533. objects this container can store.</p>
  534. </td>
  535. </tr>
  536. <tr>
  537. <td>
  538. <pre>
  539. <b>inline</b> <b>bool</b>
  540. empty
  541. () <b>const</b>
  542. </pre>
  543. </td>
  544. <td>
  545. <p>Returns whether the container object is not storing
  546. any <a href=
  547. "#value_type279018186"><tt>value_type</tt></a>
  548. objects.</p>
  549. </td>
  550. </tr>
  551. </table>
  552. <h3><a name="link11" id="link11">Insert Methods</a></h3>
  553. <table class="c1" width="100%" border="1" summary="Methods">
  554. <tr>
  555. <td width="45%" align="left"><b>Method</b></td>
  556. <td width="55%" align="left"><b>Description</b></td>
  557. </tr>
  558. <tr>
  559. <td>
  560. <pre>
  561. <b>inline</b> <a href=
  562. "#point_iterator2789896775"><tt>point_iterator</tt></a>
  563. push
  564. (<a href=
  565. "#const_reference495461441"><tt>const_reference</tt></a> r_val)
  566. </pre>
  567. </td>
  568. <td>
  569. <p>Inserts a <a href=
  570. "#value_type279018186"><tt>value_type</tt></a> object.
  571. returns a <a href=
  572. "#point_iterator2789896775"><tt>point_iterator</tt></a>
  573. object associated with the new pushed <span class=
  574. "c1"><tt>r_val</tt></span>.</p>
  575. </td>
  576. </tr>
  577. </table>
  578. <h3><a name="link12" id="link12">Find Methods</a></h3>
  579. <table class="c1" width="100%" border="1" summary="Methods">
  580. <tr>
  581. <td width="45%" align="left"><b>Method</b></td>
  582. <td width="55%" align="left"><b>Description</b></td>
  583. </tr>
  584. <tr>
  585. <td>
  586. <pre>
  587. <b>inline</b> <a href=
  588. "#const_reference495461441"><tt>const_reference</tt></a>
  589. top
  590. () <b>const</b>
  591. </pre>
  592. </td>
  593. <td>
  594. <p>Returns the <a href=
  595. "#const_reference495461441"><tt>const_reference</tt></a>
  596. of the largest <a href=
  597. "#value_type279018186"><tt>value_type</tt></a> in the
  598. container object, i.e., a <a href=
  599. "#value_type279018186"><tt>value_type</tt></a> v_max for
  600. which any other <a href=
  601. "#value_type279018186"><tt>value_type</tt></a> v in the
  602. container object will satisfy !<a href=
  603. "#cmp_fn394495"><tt>cmp_fn</tt></a>()(v_max, v).</p>
  604. </td>
  605. </tr>
  606. </table>
  607. <h3><a name="link13" id="link13">Modify Methods</a></h3>
  608. <table class="c1" width="100%" border="1" summary="Methods">
  609. <tr>
  610. <td width="45%" align="left"><b>Method</b></td>
  611. <td width="55%" align="left"><b>Description</b></td>
  612. </tr>
  613. <tr>
  614. <td>
  615. <pre>
  616. <b>inline</b> <b>void</b>
  617. modify
  618. (<a href=
  619. "#point_iterator2789896775"><tt>point_iterator</tt></a> it,
  620. <a href=
  621. "#const_reference495461441"><tt>const_reference</tt></a> r_new_val)
  622. </pre>
  623. </td>
  624. <td>
  625. <p>Modifies the <a href=
  626. "#value_type279018186"><tt>value_type</tt></a> associated
  627. with the <a href=
  628. "#point_iterator2789896775"><tt>point_iterator</tt></a>
  629. <span class="c1"><tt>it</tt></span> into <span class=
  630. "c1"><tt>r_new_val</tt></span>.</p>
  631. <p>To use this method, <a href=
  632. "#value_type279018186"><tt>value_type</tt></a> must be
  633. assignable.</p>
  634. </td>
  635. </tr>
  636. </table>
  637. <h3><a name="link14" id="link14">Erase Methods</a></h3>
  638. <table class="c1" width="100%" border="1" summary="Methods">
  639. <tr>
  640. <td width="45%" align="left"><b>Method</b></td>
  641. <td width="55%" align="left"><b>Description</b></td>
  642. </tr>
  643. <tr>
  644. <td>
  645. <pre>
  646. <b>inline</b> <b>void</b>
  647. pop
  648. ()
  649. </pre>
  650. </td>
  651. <td>
  652. <p>Pops the largest <a href=
  653. "#value_type279018186"><tt>value_type</tt></a>.</p>
  654. <p>If the container object is empty, results are
  655. undefined.</p>
  656. </td>
  657. </tr>
  658. <tr>
  659. <td>
  660. <pre>
  661. <b>inline</b> <b>void</b>
  662. erase
  663. (<a href=
  664. "#point_iterator2789896775"><tt>point_iterator</tt></a> it)
  665. </pre>
  666. </td>
  667. <td>
  668. <p>Erases the <a href=
  669. "#value_type279018186"><tt>value_type</tt></a> associated
  670. with the <a href=
  671. "#point_iterator2789896775"><tt>point_iterator</tt></a>
  672. <span class="c1"><tt>it</tt></span>.</p>
  673. </td>
  674. </tr>
  675. <tr>
  676. <td>
  677. <pre>
  678. <b>template</b>&lt;
  679. <b>class</b> Pred&gt;
  680. <b>inline</b> <a href="#size_type55424436"><tt>size_type</tt></a>
  681. erase_if
  682. (Pred prd)
  683. </pre>
  684. </td>
  685. <td>
  686. <p>Erases any <a href=
  687. "#value_type279018186"><tt>value_type</tt></a> satisfying
  688. the predicate <span class="c1"><tt>prd</tt></span>;
  689. returns the number of <a href=
  690. "#value_type279018186"><tt>value_type</tt></a>s
  691. erased.</p>
  692. </td>
  693. </tr>
  694. <tr>
  695. <td>
  696. <pre>
  697. <b>void</b>
  698. clear
  699. ()
  700. </pre>
  701. </td>
  702. <td>
  703. <p>Clears the container object.</p>
  704. </td>
  705. </tr>
  706. </table>
  707. <h3><a name="link15" id="link15">Split and join
  708. Methods</a></h3>
  709. <table class="c1" width="100%" border="1" summary="Methods">
  710. <tr>
  711. <td width="45%" align="left"><b>Method</b></td>
  712. <td width="55%" align="left"><b>Description</b></td>
  713. </tr>
  714. <tr>
  715. <td>
  716. <pre>
  717. <b>void</b>
  718. join
  719. (<span class="c2"><tt>priority_queue</tt></span> &amp;other)
  720. </pre>
  721. </td>
  722. <td>
  723. <p>Joins two container objects. When this function
  724. returns, <span class="c1"><tt>other</tt></span> will be
  725. empty.</p>
  726. <p>When calling this method, <span class=
  727. "c1"><tt>other</tt></span>'s policies must be
  728. equivalent to this object's policies.</p>
  729. </td>
  730. </tr>
  731. <tr>
  732. <td>
  733. <pre>
  734. <b>template</b>&lt;
  735. <b>class</b> Pred&gt;
  736. <b>inline</b> <b>void</b>
  737. split
  738. (Pred prd,
  739. <span class="c2"><tt>priority_queue</tt></span> &amp;other)
  740. </pre>
  741. </td>
  742. <td>
  743. <p>Splits into two container objects. When this function
  744. returns, <span class="c1"><tt>other</tt></span> will be
  745. contain only values v for which <span class=
  746. "c1"><tt>prd</tt></span>(v) is <tt><b>true</b></tt>.</p>
  747. <p>When calling this method, <span class=
  748. "c1"><tt>other</tt></span>'s policies must be
  749. equivalent to this object's policies.</p>
  750. </td>
  751. </tr>
  752. </table>
  753. <h3><a name="link16" id="link16">Iteration Methods</a></h3>
  754. <table class="c1" width="100%" border="1" summary="Methods">
  755. <tr>
  756. <td width="45%" align="left"><b>Method</b></td>
  757. <td width="55%" align="left"><b>Description</b></td>
  758. </tr>
  759. <tr>
  760. <td>
  761. <pre>
  762. <b>inline</b> <a href="#iterator10418194"><tt>iterator</tt></a>
  763. begin
  764. ()
  765. </pre>
  766. </td>
  767. <td>
  768. <p>Returns an <a href=
  769. "#iterator10418194"><tt>iterator</tt></a> corresponding
  770. to the first <a href=
  771. "#value_type279018186"><tt>value_type</tt></a> in the
  772. container.</p>
  773. </td>
  774. </tr>
  775. <tr>
  776. <td>
  777. <pre>
  778. <b>inline</b> <a href=
  779. "#const_iterator98626788"><tt>const_iterator</tt></a>
  780. begin
  781. () <b>const</b>
  782. </pre>
  783. </td>
  784. <td>
  785. <p>Returns a <a href=
  786. "#const_iterator98626788"><tt>const_iterator</tt></a>
  787. corresponding to the first <a href=
  788. "#value_type279018186"><tt>value_type</tt></a> in the
  789. container.</p>
  790. </td>
  791. </tr>
  792. <tr>
  793. <td>
  794. <pre>
  795. <b>inline</b> <a href="#iterator10418194"><tt>iterator</tt></a>
  796. end
  797. ()
  798. </pre>
  799. </td>
  800. <td>
  801. <p>Returns an <a href=
  802. "#iterator10418194"><tt>iterator</tt></a> corresponding
  803. to the just-after-last <a href=
  804. "#value_type279018186"><tt>value_type</tt></a> in the
  805. container.</p>
  806. </td>
  807. </tr>
  808. <tr>
  809. <td>
  810. <pre>
  811. <b>inline</b> <a href=
  812. "#const_iterator98626788"><tt>const_iterator</tt></a>
  813. end
  814. () <b>const</b>
  815. </pre>
  816. </td>
  817. <td>
  818. <p>Returns a <a href=
  819. "#const_iterator98626788"><tt>const_iterator</tt></a>
  820. corresponding to the just-after-last <a href=
  821. "#value_type279018186"><tt>value_type</tt></a> in the
  822. container.</p>
  823. </td>
  824. </tr>
  825. </table>
  826. </div>
  827. </body>
  828. </html>