--- /dev/null
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+ <html xmlns="http://www.w3.org/1999/xhtml">
+<!--
+This file was generated by Devel::NYTProf version 4.06
+-->
+<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+ <meta http-equiv="Content-Language" content="en-us" />
+ <title>Profile of DBIx/Class/ResultSet.pm</title>
+<link rel="stylesheet" type="text/css" href="style.css" />
+ <script type="text/javascript" src="js/jquery-min.js"></script>
+
+ <script type="text/javascript" src="js/jquery-tablesorter-min.js"></script>
+ <link rel="stylesheet" type="text/css" href="js/style-tablesorter.css" />
+ <script type="text/javascript">
+ // when a column is first clicked on to sort it, use descending order
+ // XXX doesn't seem to work (and not just because the tablesorter formatSortingOrder() is broken)
+ $.tablesorter.defaults.sortInitialOrder = "desc";
+ // add parser through the tablesorter addParser method
+ $.tablesorter.addParser({
+ id: 'fmt_time', // name of this parser
+ is: function(s) {
+ return false; // return false so this parser is not auto detected
+ },
+ format: function(orig) { // format data for normalization
+ // console.log(orig);
+ val = orig.replace(/ns/,'');
+ if (val != orig) { return val / (1000*1000*1000); }
+ val = orig.replace(/µs/,''); /* XXX use µ ? */
+ if (val != orig) { return val / (1000*1000); }
+ var val = orig.replace(/ms/,'');
+ if (val != orig) { return val / (1000); }
+ var val = orig.replace(/s/,'');
+ if (val != orig) { return val; }
+ if (orig == '0') { return orig; }
+ console.log('no match for fmt_time of '.concat(orig));
+ return orig;
+ },
+ type: 'numeric' // set type, either numeric or text
+ });
+ </script>
+</head>
+
+<body >
+<div class="header" style="position: relative; overflow-x: hidden; overflow-y: hidden; z-index: 0; ">
+<div class="header_back">
+ <a href="index.html">← Index</a>
+ </div>
+<div class="headerForeground" style="float: left">
+ <span class="siteTitle">NYTProf Performance Profile</span>
+ <span class="siteSubtitle">  <span>« <span class="mode_btn"><a href="DBIx-Class-ResultSet-pm-2196-block.html">block view</a></span> • <span class="mode_btn"><a href="DBIx-Class-ResultSet-pm-2196-line.html">line view</a></span> • <span class="mode_btn mode_btn_selected">sub view</span> »</span><br />
+ For script/nytprof.pl
+ </span>
+</div>
+<div class="headerForeground" style="float: right; text-align: right">
+ <span class="siteTitle"> </span>
+ <span class="siteSubtitle">Run on Thu May 31 16:29:39 2012<br />Reported on Thu May 31 16:35:06 2012</span>
+</div>
+<div style="position: absolute; left: 0px; top: 0%; width: 100%; height: 101%; z-index: -1; background-color: rgb(17, 136, 255); "></div>
+<div style="position: absolute; left: 0px; top: 2%; width: 100%; height: 99%; z-index: -1; background-color: rgb(16, 134, 253); "></div>
+<div style="position: absolute; left: 0px; top: 4%; width: 100%; height: 97%; z-index: -1; background-color: rgb(16, 133, 252); "></div>
+<div style="position: absolute; left: 0px; top: 6%; width: 100%; height: 95%; z-index: -1; background-color: rgb(15, 131, 250); "></div>
+<div style="position: absolute; left: 0px; top: 8%; width: 100%; height: 93%; z-index: -1; background-color: rgb(15, 130, 249); "></div>
+<div style="position: absolute; left: 0px; top: 10%; width: 100%; height: 91%; z-index: -1; background-color: rgb(15, 129, 248); "></div>
+<div style="position: absolute; left: 0px; top: 12%; width: 100%; height: 89%; z-index: -1; background-color: rgb(14, 127, 246); "></div>
+<div style="position: absolute; left: 0px; top: 14%; width: 100%; height: 87%; z-index: -1; background-color: rgb(14, 126, 245); "></div>
+<div style="position: absolute; left: 0px; top: 16%; width: 100%; height: 85%; z-index: -1; background-color: rgb(14, 125, 244); "></div>
+<div style="position: absolute; left: 0px; top: 18%; width: 100%; height: 83%; z-index: -1; background-color: rgb(13, 123, 242); "></div>
+<div style="position: absolute; left: 0px; top: 20%; width: 100%; height: 81%; z-index: -1; background-color: rgb(13, 122, 241); "></div>
+<div style="position: absolute; left: 0px; top: 22%; width: 100%; height: 79%; z-index: -1; background-color: rgb(13, 121, 240); "></div>
+<div style="position: absolute; left: 0px; top: 24%; width: 100%; height: 77%; z-index: -1; background-color: rgb(12, 119, 238); "></div>
+<div style="position: absolute; left: 0px; top: 26%; width: 100%; height: 75%; z-index: -1; background-color: rgb(12, 118, 237); "></div>
+<div style="position: absolute; left: 0px; top: 28%; width: 100%; height: 73%; z-index: -1; background-color: rgb(12, 116, 235); "></div>
+<div style="position: absolute; left: 0px; top: 30%; width: 100%; height: 71%; z-index: -1; background-color: rgb(11, 115, 234); "></div>
+<div style="position: absolute; left: 0px; top: 32%; width: 100%; height: 69%; z-index: -1; background-color: rgb(11, 114, 233); "></div>
+<div style="position: absolute; left: 0px; top: 34%; width: 100%; height: 67%; z-index: -1; background-color: rgb(11, 112, 231); "></div>
+<div style="position: absolute; left: 0px; top: 36%; width: 100%; height: 65%; z-index: -1; background-color: rgb(10, 111, 230); "></div>
+<div style="position: absolute; left: 0px; top: 38%; width: 100%; height: 63%; z-index: -1; background-color: rgb(10, 110, 229); "></div>
+<div style="position: absolute; left: 0px; top: 40%; width: 100%; height: 61%; z-index: -1; background-color: rgb(10, 108, 227); "></div>
+<div style="position: absolute; left: 0px; top: 42%; width: 100%; height: 59%; z-index: -1; background-color: rgb(9, 107, 226); "></div>
+<div style="position: absolute; left: 0px; top: 44%; width: 100%; height: 57%; z-index: -1; background-color: rgb(9, 106, 225); "></div>
+<div style="position: absolute; left: 0px; top: 46%; width: 100%; height: 55%; z-index: -1; background-color: rgb(9, 104, 223); "></div>
+<div style="position: absolute; left: 0px; top: 48%; width: 100%; height: 53%; z-index: -1; background-color: rgb(8, 103, 222); "></div>
+<div style="position: absolute; left: 0px; top: 50%; width: 100%; height: 51%; z-index: -1; background-color: rgb(8, 102, 221); "></div>
+<div style="position: absolute; left: 0px; top: 52%; width: 100%; height: 49%; z-index: -1; background-color: rgb(8, 100, 219); "></div>
+<div style="position: absolute; left: 0px; top: 54%; width: 100%; height: 47%; z-index: -1; background-color: rgb(7, 99, 218); "></div>
+<div style="position: absolute; left: 0px; top: 56%; width: 100%; height: 45%; z-index: -1; background-color: rgb(7, 97, 216); "></div>
+<div style="position: absolute; left: 0px; top: 58%; width: 100%; height: 43%; z-index: -1; background-color: rgb(7, 96, 215); "></div>
+<div style="position: absolute; left: 0px; top: 60%; width: 100%; height: 41%; z-index: -1; background-color: rgb(6, 95, 214); "></div>
+<div style="position: absolute; left: 0px; top: 62%; width: 100%; height: 39%; z-index: -1; background-color: rgb(6, 93, 212); "></div>
+<div style="position: absolute; left: 0px; top: 64%; width: 100%; height: 37%; z-index: -1; background-color: rgb(6, 92, 211); "></div>
+<div style="position: absolute; left: 0px; top: 66%; width: 100%; height: 35%; z-index: -1; background-color: rgb(5, 91, 210); "></div>
+<div style="position: absolute; left: 0px; top: 68%; width: 100%; height: 33%; z-index: -1; background-color: rgb(5, 89, 208); "></div>
+<div style="position: absolute; left: 0px; top: 70%; width: 100%; height: 31%; z-index: -1; background-color: rgb(5, 88, 207); "></div>
+<div style="position: absolute; left: 0px; top: 72%; width: 100%; height: 29%; z-index: -1; background-color: rgb(4, 87, 206); "></div>
+<div style="position: absolute; left: 0px; top: 74%; width: 100%; height: 27%; z-index: -1; background-color: rgb(4, 85, 204); "></div>
+<div style="position: absolute; left: 0px; top: 76%; width: 100%; height: 25%; z-index: -1; background-color: rgb(4, 84, 203); "></div>
+<div style="position: absolute; left: 0px; top: 78%; width: 100%; height: 23%; z-index: -1; background-color: rgb(3, 82, 201); "></div>
+<div style="position: absolute; left: 0px; top: 80%; width: 100%; height: 21%; z-index: -1; background-color: rgb(3, 81, 200); "></div>
+<div style="position: absolute; left: 0px; top: 82%; width: 100%; height: 19%; z-index: -1; background-color: rgb(3, 80, 199); "></div>
+<div style="position: absolute; left: 0px; top: 84%; width: 100%; height: 17%; z-index: -1; background-color: rgb(2, 78, 197); "></div>
+<div style="position: absolute; left: 0px; top: 86%; width: 100%; height: 15%; z-index: -1; background-color: rgb(2, 77, 196); "></div>
+<div style="position: absolute; left: 0px; top: 88%; width: 100%; height: 13%; z-index: -1; background-color: rgb(2, 76, 195); "></div>
+<div style="position: absolute; left: 0px; top: 90%; width: 100%; height: 11%; z-index: -1; background-color: rgb(1, 74, 193); "></div>
+<div style="position: absolute; left: 0px; top: 92%; width: 100%; height: 9%; z-index: -1; background-color: rgb(1, 73, 192); "></div>
+<div style="position: absolute; left: 0px; top: 94%; width: 100%; height: 7%; z-index: -1; background-color: rgb(1, 72, 191); "></div>
+<div style="position: absolute; left: 0px; top: 96%; width: 100%; height: 5%; z-index: -1; background-color: rgb(0, 70, 189); "></div>
+<div style="position: absolute; left: 0px; top: 98%; width: 100%; height: 3%; z-index: -1; background-color: rgb(0, 69, 188); "></div>
+<div style="position: absolute; left: 0px; top: 100%; width: 100%; height: 1%; z-index: -1; background-color: rgb(0, 68, 187); "></div>
+</div>
+
+<div class="body_content"><br />
+<table class="file_summary"><tr><td class="h">Filename</td><td align="left"><a href="file:///Users/edenc/perl5/lib/perl5/DBIx/Class/ResultSet.pm">/Users/edenc/perl5/lib/perl5/DBIx/Class/ResultSet.pm</a></td></tr>
+<tr><td class="h">Statements</td><td align="left">Executed 30 statements in 11.5ms</td></tr></table>
+
+ <table id="subs_table" border="1" cellpadding="0" class="tablesorter">
+ <caption>Subroutines</caption>
+ <thead>
+ <tr>
+ <th>Calls</th>
+ <th><span title="Number of Places sub is called from">P</span></th>
+ <th><span title="Number of Files sub is called from">F</span></th>
+ <th>Exclusive<br />Time</th>
+ <th>Inclusive<br />Time</th>
+ <th>Subroutine</th>
+ </tr>
+ </thead>
+ <tbody>
+<tr><td class="c3">1</td><td class="c3">1</td><td class="c3">1</td><td class="c0"><span title="0.0%">1.71ms</span></td><td class="c0"><span title="0.0%">2.00ms</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::BEGIN@11</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#11">BEGIN@11</a></span></td></tr>
+<tr><td class="c3">1</td><td class="c3">1</td><td class="c3">1</td><td class="c0"><span title="0.0%">1.21ms</span></td><td class="c0"><span title="0.0%">1.64ms</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::BEGIN@8</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#8">BEGIN@8</a></span></td></tr>
+<tr><td class="c3">1</td><td class="c3">1</td><td class="c3">1</td><td class="c0"><span title="0.0%">14µs</span></td><td class="c3"><span title="0.0%">17µs</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::BEGIN@3</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3">BEGIN@3</a></span></td></tr>
+<tr><td class="c3">1</td><td class="c3">1</td><td class="c3">1</td><td class="c1"><span title="0.0%">10µs</span></td><td class="c3"><span title="0.0%">42µs</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::BEGIN@9</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#9">BEGIN@9</a></span></td></tr>
+<tr><td class="c3">1</td><td class="c3">1</td><td class="c3">1</td><td class="c2"><span title="0.0%">9µs</span></td><td class="c2"><span title="0.0%">59µs</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::BEGIN@25</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#25">BEGIN@25</a></span></td></tr>
+<tr><td class="c3">1</td><td class="c3">1</td><td class="c3">1</td><td class="c2"><span title="0.0%">9µs</span></td><td class="c3"><span title="0.0%">40µs</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::BEGIN@10</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#10">BEGIN@10</a></span></td></tr>
+<tr><td class="c3">1</td><td class="c3">1</td><td class="c3">1</td><td class="c3"><span title="0.0%">9µs</span></td><td class="c0"><span title="0.0%">235µs</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::BEGIN@22</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#22">BEGIN@22</a></span></td></tr>
+<tr><td class="c3">1</td><td class="c3">1</td><td class="c3">1</td><td class="c3"><span title="0.0%">9µs</span></td><td class="c3"><span title="0.0%">10µs</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::BEGIN@7</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#7">BEGIN@7</a></span></td></tr>
+<tr><td class="c3">1</td><td class="c3">1</td><td class="c3">1</td><td class="c3"><span title="0.0%">8µs</span></td><td class="c1"><span title="0.0%">75µs</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::BEGIN@6</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#6">BEGIN@6</a></span></td></tr>
+<tr><td class="c3">1</td><td class="c3">1</td><td class="c3">1</td><td class="c3"><span title="0.0%">8µs</span></td><td class="c1"><span title="0.0%">75µs</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::BEGIN@5</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#5">BEGIN@5</a></span></td></tr>
+<tr><td class="c3">1</td><td class="c3">1</td><td class="c3">1</td><td class="c3"><span title="0.0%">7µs</span></td><td class="c3"><span title="0.0%">12µs</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::BEGIN@4</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#4">BEGIN@4</a></span></td></tr>
+<tr><td class="c3">1</td><td class="c3">1</td><td class="c3">1</td><td class="c3"><span title="0.0%">6µs</span></td><td class="c3"><span title="0.0%">6µs</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::BEGIN@16</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#16">BEGIN@16</a></span></td></tr>
+<tr><td class="c3">1</td><td class="c3">1</td><td class="c3">1</td><td class="c3"><span title="0.0%">6µs</span></td><td class="c3"><span title="0.0%">6µs</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::BEGIN@14</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#14">BEGIN@14</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::STORABLE_freeze</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3551">STORABLE_freeze</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::STORABLE_thaw</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3567">STORABLE_thaw</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::__ANON__[:2152]</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#2152">__ANON__[:2152]</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::__ANON__[:3159]</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3159">__ANON__[:3159]</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::__ANON__[:332]</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#332">__ANON__[:332]</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::__ANON__[:3488]</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3473">__ANON__[:3488]</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::__ANON__[:3491]</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3491">__ANON__[:3491]</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::__ANON__[:3493]</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3489">__ANON__[:3493]</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::__ANON__[:3499]</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3494">__ANON__[:3499]</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::__ANON__[:3504]</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3504">__ANON__[:3504]</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::__ANON__[:3506]</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3502">__ANON__[:3506]</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::__ANON__[:3513]</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3507">__ANON__[:3513]</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::__ANON__[:3517]</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3517">__ANON__[:3517]</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::__ANON__[:3519]</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3514">__ANON__[:3519]</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::__ANON__[:3527]</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3522">__ANON__[:3527]</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::__ANON__[:3532]</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3532">__ANON__[:3532]</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::__ANON__[:3534]</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3528">__ANON__[:3534]</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::__ANON__[:3541]</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3535">__ANON__[:3541]</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::__ANON__[:356]</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#356">__ANON__[:356]</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::__ANON__[:793]</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#791">__ANON__[:793]</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::__ANON__[:858]</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#856">__ANON__[:858]</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::__ANON__[:860]</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#858">__ANON__[:860]</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_bool</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1592">_bool</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_build_unique_cond</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#850">_build_unique_cond</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_calculate_score</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3389">_calculate_score</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_chain_relationship</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3049">_chain_relationship</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_collapse_cond</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#2329">_collapse_cond</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_collapse_query</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1044">_collapse_query</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_collapse_result</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1229">_collapse_result</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_construct_object</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1218">_construct_object</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_count_rs</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1483">_count_rs</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_count_subq_rs</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1506">_count_subq_rs</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_has_resolved_attr</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#2285">_has_resolved_attr</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_merge_attr</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3466">_merge_attr</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_merge_joinpref_attr</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3421">_merge_joinpref_attr</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_merge_with_rscond</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#2222">_merge_with_rscond</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_non_unique_find_fallback</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#826">_non_unique_find_fallback</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_normalize_populate_args</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#2088">_normalize_populate_args</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_normalize_selection</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#442">_normalize_selection</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_qualify_cond_columns</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#838">_qualify_cond_columns</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_remove_alias</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#2362">_remove_alias</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_resolved_attrs</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3149">_resolved_attrs</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_resolved_attrs_copy</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3144">_resolved_attrs_copy</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_rollout_array</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3362">_rollout_array</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_rollout_attr</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3350">_rollout_attr</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_rollout_hash</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3379">_rollout_hash</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_rs_update_delete</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1709">_rs_update_delete</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::_stack_cond</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#531">_stack_cond</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::all</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1627">all</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::as_query</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#2396">as_query</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::as_subselect_rs</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3013">as_subselect_rs</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::clear_cache</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#2803">clear_cache</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::count</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1415">count</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::count_literal</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1611">count_literal</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::count_rs</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1464">count_rs</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::create</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#2541">create</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::current_source_alias</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#2958">current_source_alias</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::cursor</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#952">cursor</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::delete</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1872">delete</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::delete_all</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1896">delete_all</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::find</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#699">find</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::find_or_create</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#2603">find_or_create</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::find_or_new</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#2450">find_or_new</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::first</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1698">first</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::get_cache</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#2758">get_cache</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::get_column</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1088">get_column</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::is_ordered</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#2836">is_ordered</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::is_paged</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#2819">is_paged</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::new</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#190">new</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::new_result</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#2198">new_result</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::next</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1191">next</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::page</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#2174">page</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::pager</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#2129">pager</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::populate</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1980">populate</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::related_resultset</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#2857">related_resultset</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::reset</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1675">reset</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::result_class</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1384">result_class</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::search</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#272">search</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::search_like</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1124">search_like</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::search_literal</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#623">search_literal</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::search_related</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#922">search_related</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::search_related_rs</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#933">search_related_rs</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::search_rs</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#310">search_rs</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::set_cache</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#2782">set_cache</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::single</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1005">single</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::slice</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1155">slice</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::throw_exception</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#3582">throw_exception</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::update</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1814">update</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::update_all</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#1838">update_all</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::update_or_create</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#2664">update_or_create</a></span></td></tr>
+<tr><td class="c3">0</td><td class="c3">0</td><td class="c3">0</td><td class="c3"><span title="0.0%">0s</span></td><td class="c3"><span title="0.0%">0s</span></td><td class="sub_name"><span style="display: none;">DBIx::Class::ResultSet::::update_or_new</span>DBIx::Class::ResultSet::<a href="DBIx-Class-ResultSet-pm-2196-sub.html#2727">update_or_new</a></span></td></tr>
+</tbody></table>
+ Call graph for these subroutines as a
+ <a href="http://en.wikipedia.org/wiki/Graphviz">Graphviz</a>
+ <a href="Users-edenc-perl5-lib-perl5-DBIx-Class-ResultSet-pm.dot">dot language file</a>.
+
+ <table border="1" cellpadding="0">
+ <thead>
+ <tr><th>Line</th>
+ <th><span title="Number of statements executed">State<br />ments</span></th>
+ <th><span title="Time spend executing statements on the line,
+ excluding time spent executing statements in any called subroutines">Time<br />on line</span></th>
+ <th><span title="Number of subroutines calls">Calls</span></th>
+ <th><span title="Time spent in subroutines called (inclusive)">Time<br />in subs</span></th>
+ <th class="left_indent_header">Code</th>
+ </tr>
+
+ </thead>
+ <tbody>
+ <tr><td class="h"><a name="1"></a>1</td><td></td><td></td><td></td><td></td><td class="s">package DBIx::Class::ResultSet;</td></tr>
+<tr><td class="h"><a name="2"></a>2</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3"></a>3</td><td class="c3">2</td><td class="c3"><span title="Avg 11µs">22µs</span></td><td class="c3">2</td><td class="c3">19µs</td><td class="s"><div class="calls"><div class="calls_in"># spent 17µs (14+3) within DBIx::Class::ResultSet::BEGIN@3 which was called:
+# once (14µs+3µs) by DBIx::Class::ResultSource::Table::BEGIN@6 at <a href="DBIx-Class-ResultSet-pm-2196-sub.html#3">line 3</a></div></div>use strict;<div class="calls"><div class="calls_out"># spent 17µs making 1 call to <a href="DBIx-Class-ResultSet-pm-2196-sub.html#3">DBIx::Class::ResultSet::BEGIN@3</a>
+# spent 3µs making 1 call to <a href="strict-pm-3-sub.html#34">strict::import</a></div></div></td></tr>
+<tr><td class="h"><a name="4"></a>4</td><td class="c3">2</td><td class="c3"><span title="Avg 15µs">30µs</span></td><td class="c3">2</td><td class="c3">16µs</td><td class="s"><div class="calls"><div class="calls_in"># spent 12µs (7+5) within DBIx::Class::ResultSet::BEGIN@4 which was called:
+# once (7µs+5µs) by DBIx::Class::ResultSource::Table::BEGIN@6 at <a href="DBIx-Class-ResultSet-pm-2196-sub.html#4">line 4</a></div></div>use warnings;<div class="calls"><div class="calls_out"># spent 12µs making 1 call to <a href="DBIx-Class-ResultSet-pm-2196-sub.html#4">DBIx::Class::ResultSet::BEGIN@4</a>
+# spent 4µs making 1 call to <a href="warnings-pm-2-sub.html#386">warnings::import</a></div></div></td></tr>
+<tr><td class="h"><a name="5"></a>5</td><td class="c3">2</td><td class="c3"><span title="Avg 12µs">24µs</span></td><td class="c3">2</td><td class="c3">142µs</td><td class="s"><div class="calls"><div class="calls_in"># spent 75µs (8+67) within DBIx::Class::ResultSet::BEGIN@5 which was called:
+# once (8µs+67µs) by DBIx::Class::ResultSource::Table::BEGIN@6 at <a href="DBIx-Class-ResultSet-pm-2196-sub.html#5">line 5</a></div></div>use base qw/DBIx::Class/;<div class="calls"><div class="calls_out"># spent 75µs making 1 call to <a href="DBIx-Class-ResultSet-pm-2196-sub.html#5">DBIx::Class::ResultSet::BEGIN@5</a>
+# spent 67µs making 1 call to <a href="base-pm-22-sub.html#58">base::import</a></div></div></td></tr>
+<tr><td class="h"><a name="6"></a>6</td><td class="c3">2</td><td class="c3"><span title="Avg 12µs">25µs</span></td><td class="c3">2</td><td class="c3">142µs</td><td class="s"><div class="calls"><div class="calls_in"># spent 75µs (8+67) within DBIx::Class::ResultSet::BEGIN@6 which was called:
+# once (8µs+67µs) by DBIx::Class::ResultSource::Table::BEGIN@6 at <a href="DBIx-Class-ResultSet-pm-2196-sub.html#6">line 6</a></div></div>use DBIx::Class::Carp;<div class="calls"><div class="calls_out"># spent 75µs making 1 call to <a href="DBIx-Class-ResultSet-pm-2196-sub.html#6">DBIx::Class::ResultSet::BEGIN@6</a>
+# spent 67µs making 1 call to <a href="DBIx-Class-Carp-pm-2169-sub.html#66">DBIx::Class::Carp::import</a></div></div></td></tr>
+<tr><td class="h"><a name="7"></a>7</td><td class="c3">2</td><td class="c3"><span title="Avg 12µs">24µs</span></td><td class="c3">2</td><td class="c3">12µs</td><td class="s"><div class="calls"><div class="calls_in"># spent 10µs (9+1) within DBIx::Class::ResultSet::BEGIN@7 which was called:
+# once (9µs+1µs) by DBIx::Class::ResultSource::Table::BEGIN@6 at <a href="DBIx-Class-ResultSet-pm-2196-sub.html#7">line 7</a></div></div>use DBIx::Class::Exception;<div class="calls"><div class="calls_out"># spent 10µs making 1 call to <a href="DBIx-Class-ResultSet-pm-2196-sub.html#7">DBIx::Class::ResultSet::BEGIN@7</a>
+# spent 2µs making 1 call to <a href="UNIVERSAL-pm-738-sub.html#16">UNIVERSAL::import</a></div></div></td></tr>
+<tr><td class="h"><a name="8"></a>8</td><td class="c3">2</td><td class="c0"><span title="Avg 55µs">111µs</span></td><td class="c3">2</td><td class="c0">1.64ms</td><td class="s"><div class="calls"><div class="calls_in"># spent 1.64ms (1.21+425µs) within DBIx::Class::ResultSet::BEGIN@8 which was called:
+# once (1.21ms+425µs) by DBIx::Class::ResultSource::Table::BEGIN@6 at <a href="DBIx-Class-ResultSet-pm-2196-sub.html#8">line 8</a></div></div>use DBIx::Class::ResultSetColumn;<div class="calls"><div class="calls_out"># spent 1.64ms making 1 call to <a href="DBIx-Class-ResultSet-pm-2196-sub.html#8">DBIx::Class::ResultSet::BEGIN@8</a>
+# spent 2µs making 1 call to <a href="UNIVERSAL-pm-738-sub.html#16">UNIVERSAL::import</a></div></div></td></tr>
+<tr><td class="h"><a name="9"></a>9</td><td class="c3">2</td><td class="c3"><span title="Avg 13µs">26µs</span></td><td class="c3">2</td><td class="c3">74µs</td><td class="s"><div class="calls"><div class="calls_in"># spent 42µs (10+32) within DBIx::Class::ResultSet::BEGIN@9 which was called:
+# once (10µs+32µs) by DBIx::Class::ResultSource::Table::BEGIN@6 at <a href="DBIx-Class-ResultSet-pm-2196-sub.html#9">line 9</a></div></div>use Scalar::Util qw/blessed weaken/;<div class="calls"><div class="calls_out"># spent 42µs making 1 call to <a href="DBIx-Class-ResultSet-pm-2196-sub.html#9">DBIx::Class::ResultSet::BEGIN@9</a>
+# spent 32µs making 1 call to <a href="Exporter-pm-8-sub.html#28">Exporter::import</a></div></div></td></tr>
+<tr><td class="h"><a name="10"></a>10</td><td class="c3">2</td><td class="c3"><span title="Avg 11µs">23µs</span></td><td class="c3">2</td><td class="c3">70µs</td><td class="s"><div class="calls"><div class="calls_in"># spent 40µs (9+31) within DBIx::Class::ResultSet::BEGIN@10 which was called:
+# once (9µs+31µs) by DBIx::Class::ResultSource::Table::BEGIN@6 at <a href="DBIx-Class-ResultSet-pm-2196-sub.html#10">line 10</a></div></div>use Try::Tiny;<div class="calls"><div class="calls_out"># spent 40µs making 1 call to <a href="DBIx-Class-ResultSet-pm-2196-sub.html#10">DBIx::Class::ResultSet::BEGIN@10</a>
+# spent 31µs making 1 call to <a href="Exporter-pm-8-sub.html#28">Exporter::import</a></div></div></td></tr>
+<tr><td class="h"><a name="11"></a>11</td><td class="c3">2</td><td class="c0"><span title="Avg 54µs">107µs</span></td><td class="c3">1</td><td class="c0">2.00ms</td><td class="s"><div class="calls"><div class="calls_in"># spent 2.00ms (1.71+288µs) within DBIx::Class::ResultSet::BEGIN@11 which was called:
+# once (1.71ms+288µs) by DBIx::Class::ResultSource::Table::BEGIN@6 at <a href="DBIx-Class-ResultSet-pm-2196-sub.html#11">line 11</a></div></div>use Data::Compare (); # no imports!!! guard against insane architecture<div class="calls"><div class="calls_out"># spent 2.00ms making 1 call to <a href="DBIx-Class-ResultSet-pm-2196-sub.html#11">DBIx::Class::ResultSet::BEGIN@11</a></div></div></td></tr>
+<tr><td class="h"><a name="12"></a>12</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="13"></a>13</td><td></td><td></td><td></td><td></td><td class="s"># not importing first() as it will clash with our own method</td></tr>
+<tr><td class="h"><a name="14"></a>14</td><td class="c3">2</td><td class="c1"><span title="Avg 22µs">44µs</span></td><td class="c3">1</td><td class="c3">6µs</td><td class="s"><div class="calls"><div class="calls_in"># spent 6µs within DBIx::Class::ResultSet::BEGIN@14 which was called:
+# once (6µs+0s) by DBIx::Class::ResultSource::Table::BEGIN@6 at <a href="DBIx-Class-ResultSet-pm-2196-sub.html#14">line 14</a></div></div>use List::Util ();<div class="calls"><div class="calls_out"># spent 6µs making 1 call to <a href="DBIx-Class-ResultSet-pm-2196-sub.html#14">DBIx::Class::ResultSet::BEGIN@14</a></div></div></td></tr>
+<tr><td class="h"><a name="15"></a>15</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="16"></a>16</td><td></td><td></td><td></td><td></td><td class="s"><div class="calls"><div class="calls_in"># spent 6µs within DBIx::Class::ResultSet::BEGIN@16 which was called:
+# once (6µs+0s) by DBIx::Class::ResultSource::Table::BEGIN@6 at <a href="DBIx-Class-ResultSet-pm-2196-sub.html#20">line 20</a></div></div>BEGIN {</td></tr>
+<tr><td class="h"><a name="17"></a>17</td><td></td><td></td><td></td><td></td><td class="s"> # De-duplication in _merge_attr() is disabled, but left in for reference</td></tr>
+<tr><td class="h"><a name="18"></a>18</td><td></td><td></td><td></td><td></td><td class="s"> # (the merger is used for other things that ought not to be de-duped)</td></tr>
+<tr><td class="h"><a name="19"></a>19</td><td class="c3">1</td><td class="c3"><span title="Avg 6µs">6µs</span></td><td></td><td></td><td class="s"> *__HM_DEDUP = sub () { 0 };</td></tr>
+<tr><td class="h"><a name="20"></a>20</td><td class="c3">1</td><td class="c3"><span title="Avg 18µs">18µs</span></td><td class="c3">1</td><td class="c3">6µs</td><td class="s">}<div class="calls"><div class="calls_out"># spent 6µs making 1 call to <a href="DBIx-Class-ResultSet-pm-2196-sub.html#16">DBIx::Class::ResultSet::BEGIN@16</a></div></div></td></tr>
+<tr><td class="h"><a name="21"></a>21</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="22"></a>22</td><td class="c3">2</td><td class="c2"><span title="Avg 18µs">35µs</span></td><td class="c3">2</td><td class="c0">461µs</td><td class="s"><div class="calls"><div class="calls_in"># spent 235µs (9+226) within DBIx::Class::ResultSet::BEGIN@22 which was called:
+# once (9µs+226µs) by DBIx::Class::ResultSource::Table::BEGIN@6 at <a href="DBIx-Class-ResultSet-pm-2196-sub.html#22">line 22</a></div></div>use namespace::clean;<div class="calls"><div class="calls_out"># spent 235µs making 1 call to <a href="DBIx-Class-ResultSet-pm-2196-sub.html#22">DBIx::Class::ResultSet::BEGIN@22</a>
+# spent 226µs making 1 call to <a href="namespace-clean-pm-379-sub.html#288">namespace::clean::import</a></div></div></td></tr>
+<tr><td class="h"><a name="23"></a>23</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="24"></a>24</td><td></td><td></td><td></td><td></td><td class="s">use overload</td></tr>
+<tr><td class="h"><a name="25"></a>25</td><td class="c3">2</td><td class="c3"><span title="Avg 3µs">7µs</span></td><td></td><td></td><td class="s"><div class="calls"><div class="calls_in"># spent 59µs (9+50) within DBIx::Class::ResultSet::BEGIN@25 which was called:
+# once (9µs+50µs) by DBIx::Class::ResultSource::Table::BEGIN@6 at <a href="DBIx-Class-ResultSet-pm-2196-sub.html#27">line 27</a></div></div> '0+' => "count",</td></tr>
+<tr><td class="h"><a name="26"></a>26</td><td></td><td></td><td></td><td></td><td class="s"> 'bool' => "_bool",</td></tr>
+<tr><td class="h"><a name="27"></a>27</td><td class="c3">1</td><td class="c0"><span title="Avg 11.0ms">11.0ms</span></td><td class="c3">2</td><td class="c3">108µs</td><td class="s"> fallback => 1;<div class="calls"><div class="calls_out"> # spent 59µs making 1 call to <a href="DBIx-Class-ResultSet-pm-2196-sub.html#25">DBIx::Class::ResultSet::BEGIN@25</a>
+ # spent 50µs making 1 call to <a href="overload-pm-29-sub.html#30">overload::import</a></div></div></td></tr>
+<tr><td class="h"><a name="28"></a>28</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="29"></a>29</td><td class="c3">1</td><td class="c3"><span title="Avg 12µs">12µs</span></td><td class="c3">1</td><td class="c2">162µs</td><td class="s">__PACKAGE__->mk_group_accessors('simple' => qw/_result_class result_source/);<div class="calls"><div class="calls_out"># spent 162µs making 1 call to <a href="Class-Accessor-Grouped-pm-2180-sub.html#122">Class::Accessor::Grouped::mk_group_accessors</a></div></div></td></tr>
+<tr><td class="h"><a name="30"></a>30</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="31"></a>31</td><td></td><td></td><td></td><td></td><td class="s">=head1 NAME</td></tr>
+<tr><td class="h"><a name="32"></a>32</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="33"></a>33</td><td></td><td></td><td></td><td></td><td class="s">DBIx::Class::ResultSet - Represents a query used for fetching a set of results.</td></tr>
+<tr><td class="h"><a name="34"></a>34</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="35"></a>35</td><td></td><td></td><td></td><td></td><td class="s">=head1 SYNOPSIS</td></tr>
+<tr><td class="h"><a name="36"></a>36</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="37"></a>37</td><td></td><td></td><td></td><td></td><td class="s"> my $users_rs = $schema->resultset('User');</td></tr>
+<tr><td class="h"><a name="38"></a>38</td><td></td><td></td><td></td><td></td><td class="s"> while( $user = $users_rs->next) {</td></tr>
+<tr><td class="h"><a name="39"></a>39</td><td></td><td></td><td></td><td></td><td class="s"> print $user->username;</td></tr>
+<tr><td class="h"><a name="40"></a>40</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="41"></a>41</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="42"></a>42</td><td></td><td></td><td></td><td></td><td class="s"> my $registered_users_rs = $schema->resultset('User')->search({ registered => 1 });</td></tr>
+<tr><td class="h"><a name="43"></a>43</td><td></td><td></td><td></td><td></td><td class="s"> my @cds_in_2005 = $schema->resultset('CD')->search({ year => 2005 })->all();</td></tr>
+<tr><td class="h"><a name="44"></a>44</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="45"></a>45</td><td></td><td></td><td></td><td></td><td class="s">=head1 DESCRIPTION</td></tr>
+<tr><td class="h"><a name="46"></a>46</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="47"></a>47</td><td></td><td></td><td></td><td></td><td class="s">A ResultSet is an object which stores a set of conditions representing</td></tr>
+<tr><td class="h"><a name="48"></a>48</td><td></td><td></td><td></td><td></td><td class="s">a query. It is the backbone of DBIx::Class (i.e. the really</td></tr>
+<tr><td class="h"><a name="49"></a>49</td><td></td><td></td><td></td><td></td><td class="s">important/useful bit).</td></tr>
+<tr><td class="h"><a name="50"></a>50</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="51"></a>51</td><td></td><td></td><td></td><td></td><td class="s">No SQL is executed on the database when a ResultSet is created, it</td></tr>
+<tr><td class="h"><a name="52"></a>52</td><td></td><td></td><td></td><td></td><td class="s">just stores all the conditions needed to create the query.</td></tr>
+<tr><td class="h"><a name="53"></a>53</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="54"></a>54</td><td></td><td></td><td></td><td></td><td class="s">A basic ResultSet representing the data of an entire table is returned</td></tr>
+<tr><td class="h"><a name="55"></a>55</td><td></td><td></td><td></td><td></td><td class="s">by calling C<resultset> on a L<DBIx::Class::Schema> and passing in a</td></tr>
+<tr><td class="h"><a name="56"></a>56</td><td></td><td></td><td></td><td></td><td class="s">L<Source|DBIx::Class::Manual::Glossary/Source> name.</td></tr>
+<tr><td class="h"><a name="57"></a>57</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="58"></a>58</td><td></td><td></td><td></td><td></td><td class="s"> my $users_rs = $schema->resultset('User');</td></tr>
+<tr><td class="h"><a name="59"></a>59</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="60"></a>60</td><td></td><td></td><td></td><td></td><td class="s">A new ResultSet is returned from calling L</search> on an existing</td></tr>
+<tr><td class="h"><a name="61"></a>61</td><td></td><td></td><td></td><td></td><td class="s">ResultSet. The new one will contain all the conditions of the</td></tr>
+<tr><td class="h"><a name="62"></a>62</td><td></td><td></td><td></td><td></td><td class="s">original, plus any new conditions added in the C<search> call.</td></tr>
+<tr><td class="h"><a name="63"></a>63</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="64"></a>64</td><td></td><td></td><td></td><td></td><td class="s">A ResultSet also incorporates an implicit iterator. L</next> and L</reset></td></tr>
+<tr><td class="h"><a name="65"></a>65</td><td></td><td></td><td></td><td></td><td class="s">can be used to walk through all the L<DBIx::Class::Row>s the ResultSet</td></tr>
+<tr><td class="h"><a name="66"></a>66</td><td></td><td></td><td></td><td></td><td class="s">represents.</td></tr>
+<tr><td class="h"><a name="67"></a>67</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="68"></a>68</td><td></td><td></td><td></td><td></td><td class="s">The query that the ResultSet represents is B<only> executed against</td></tr>
+<tr><td class="h"><a name="69"></a>69</td><td></td><td></td><td></td><td></td><td class="s">the database when these methods are called:</td></tr>
+<tr><td class="h"><a name="70"></a>70</td><td></td><td></td><td></td><td></td><td class="s">L</find>, L</next>, L</all>, L</first>, L</single>, L</count>.</td></tr>
+<tr><td class="h"><a name="71"></a>71</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="72"></a>72</td><td></td><td></td><td></td><td></td><td class="s">If a resultset is used in a numeric context it returns the L</count>.</td></tr>
+<tr><td class="h"><a name="73"></a>73</td><td></td><td></td><td></td><td></td><td class="s">However, if it is used in a boolean context it is B<always> true. So if</td></tr>
+<tr><td class="h"><a name="74"></a>74</td><td></td><td></td><td></td><td></td><td class="s">you want to check if a resultset has any results, you must use C<if $rs</td></tr>
+<tr><td class="h"><a name="75"></a>75</td><td></td><td></td><td></td><td></td><td class="s">!= 0>.</td></tr>
+<tr><td class="h"><a name="76"></a>76</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="77"></a>77</td><td></td><td></td><td></td><td></td><td class="s">=head1 EXAMPLES</td></tr>
+<tr><td class="h"><a name="78"></a>78</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="79"></a>79</td><td></td><td></td><td></td><td></td><td class="s">=head2 Chaining resultsets</td></tr>
+<tr><td class="h"><a name="80"></a>80</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="81"></a>81</td><td></td><td></td><td></td><td></td><td class="s">Let's say you've got a query that needs to be run to return some data</td></tr>
+<tr><td class="h"><a name="82"></a>82</td><td></td><td></td><td></td><td></td><td class="s">to the user. But, you have an authorization system in place that</td></tr>
+<tr><td class="h"><a name="83"></a>83</td><td></td><td></td><td></td><td></td><td class="s">prevents certain users from seeing certain information. So, you want</td></tr>
+<tr><td class="h"><a name="84"></a>84</td><td></td><td></td><td></td><td></td><td class="s">to construct the basic query in one method, but add constraints to it in</td></tr>
+<tr><td class="h"><a name="85"></a>85</td><td></td><td></td><td></td><td></td><td class="s">another.</td></tr>
+<tr><td class="h"><a name="86"></a>86</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="87"></a>87</td><td></td><td></td><td></td><td></td><td class="s"> sub get_data {</td></tr>
+<tr><td class="h"><a name="88"></a>88</td><td></td><td></td><td></td><td></td><td class="s"> my $self = shift;</td></tr>
+<tr><td class="h"><a name="89"></a>89</td><td></td><td></td><td></td><td></td><td class="s"> my $request = $self->get_request; # Get a request object somehow.</td></tr>
+<tr><td class="h"><a name="90"></a>90</td><td></td><td></td><td></td><td></td><td class="s"> my $schema = $self->result_source->schema;</td></tr>
+<tr><td class="h"><a name="91"></a>91</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="92"></a>92</td><td></td><td></td><td></td><td></td><td class="s"> my $cd_rs = $schema->resultset('CD')->search({</td></tr>
+<tr><td class="h"><a name="93"></a>93</td><td></td><td></td><td></td><td></td><td class="s"> title => $request->param('title'),</td></tr>
+<tr><td class="h"><a name="94"></a>94</td><td></td><td></td><td></td><td></td><td class="s"> year => $request->param('year'),</td></tr>
+<tr><td class="h"><a name="95"></a>95</td><td></td><td></td><td></td><td></td><td class="s"> });</td></tr>
+<tr><td class="h"><a name="96"></a>96</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="97"></a>97</td><td></td><td></td><td></td><td></td><td class="s"> $cd_rs = $self->apply_security_policy( $cd_rs );</td></tr>
+<tr><td class="h"><a name="98"></a>98</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="99"></a>99</td><td></td><td></td><td></td><td></td><td class="s"> return $cd_rs->all();</td></tr>
+<tr><td class="h"><a name="100"></a>100</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="101"></a>101</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="102"></a>102</td><td></td><td></td><td></td><td></td><td class="s"> sub apply_security_policy {</td></tr>
+<tr><td class="h"><a name="103"></a>103</td><td></td><td></td><td></td><td></td><td class="s"> my $self = shift;</td></tr>
+<tr><td class="h"><a name="104"></a>104</td><td></td><td></td><td></td><td></td><td class="s"> my ($rs) = @_;</td></tr>
+<tr><td class="h"><a name="105"></a>105</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="106"></a>106</td><td></td><td></td><td></td><td></td><td class="s"> return $rs->search({</td></tr>
+<tr><td class="h"><a name="107"></a>107</td><td></td><td></td><td></td><td></td><td class="s"> subversive => 0,</td></tr>
+<tr><td class="h"><a name="108"></a>108</td><td></td><td></td><td></td><td></td><td class="s"> });</td></tr>
+<tr><td class="h"><a name="109"></a>109</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="110"></a>110</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="111"></a>111</td><td></td><td></td><td></td><td></td><td class="s">=head3 Resolving conditions and attributes</td></tr>
+<tr><td class="h"><a name="112"></a>112</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="113"></a>113</td><td></td><td></td><td></td><td></td><td class="s">When a resultset is chained from another resultset, conditions and</td></tr>
+<tr><td class="h"><a name="114"></a>114</td><td></td><td></td><td></td><td></td><td class="s">attributes with the same keys need resolving.</td></tr>
+<tr><td class="h"><a name="115"></a>115</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="116"></a>116</td><td></td><td></td><td></td><td></td><td class="s">L</join>, L</prefetch>, L</+select>, L</+as> attributes are merged</td></tr>
+<tr><td class="h"><a name="117"></a>117</td><td></td><td></td><td></td><td></td><td class="s">into the existing ones from the original resultset.</td></tr>
+<tr><td class="h"><a name="118"></a>118</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="119"></a>119</td><td></td><td></td><td></td><td></td><td class="s">The L</where> and L</having> attributes, and any search conditions, are</td></tr>
+<tr><td class="h"><a name="120"></a>120</td><td></td><td></td><td></td><td></td><td class="s">merged with an SQL C<AND> to the existing condition from the original</td></tr>
+<tr><td class="h"><a name="121"></a>121</td><td></td><td></td><td></td><td></td><td class="s">resultset.</td></tr>
+<tr><td class="h"><a name="122"></a>122</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="123"></a>123</td><td></td><td></td><td></td><td></td><td class="s">All other attributes are overridden by any new ones supplied in the</td></tr>
+<tr><td class="h"><a name="124"></a>124</td><td></td><td></td><td></td><td></td><td class="s">search attributes.</td></tr>
+<tr><td class="h"><a name="125"></a>125</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="126"></a>126</td><td></td><td></td><td></td><td></td><td class="s">=head2 Multiple queries</td></tr>
+<tr><td class="h"><a name="127"></a>127</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="128"></a>128</td><td></td><td></td><td></td><td></td><td class="s">Since a resultset just defines a query, you can do all sorts of</td></tr>
+<tr><td class="h"><a name="129"></a>129</td><td></td><td></td><td></td><td></td><td class="s">things with it with the same object.</td></tr>
+<tr><td class="h"><a name="130"></a>130</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="131"></a>131</td><td></td><td></td><td></td><td></td><td class="s"> # Don't hit the DB yet.</td></tr>
+<tr><td class="h"><a name="132"></a>132</td><td></td><td></td><td></td><td></td><td class="s"> my $cd_rs = $schema->resultset('CD')->search({</td></tr>
+<tr><td class="h"><a name="133"></a>133</td><td></td><td></td><td></td><td></td><td class="s"> title => 'something',</td></tr>
+<tr><td class="h"><a name="134"></a>134</td><td></td><td></td><td></td><td></td><td class="s"> year => 2009,</td></tr>
+<tr><td class="h"><a name="135"></a>135</td><td></td><td></td><td></td><td></td><td class="s"> });</td></tr>
+<tr><td class="h"><a name="136"></a>136</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="137"></a>137</td><td></td><td></td><td></td><td></td><td class="s"> # Each of these hits the DB individually.</td></tr>
+<tr><td class="h"><a name="138"></a>138</td><td></td><td></td><td></td><td></td><td class="s"> my $count = $cd_rs->count;</td></tr>
+<tr><td class="h"><a name="139"></a>139</td><td></td><td></td><td></td><td></td><td class="s"> my $most_recent = $cd_rs->get_column('date_released')->max();</td></tr>
+<tr><td class="h"><a name="140"></a>140</td><td></td><td></td><td></td><td></td><td class="s"> my @records = $cd_rs->all;</td></tr>
+<tr><td class="h"><a name="141"></a>141</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="142"></a>142</td><td></td><td></td><td></td><td></td><td class="s">And it's not just limited to SELECT statements.</td></tr>
+<tr><td class="h"><a name="143"></a>143</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="144"></a>144</td><td></td><td></td><td></td><td></td><td class="s"> $cd_rs->delete();</td></tr>
+<tr><td class="h"><a name="145"></a>145</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="146"></a>146</td><td></td><td></td><td></td><td></td><td class="s">This is even cooler:</td></tr>
+<tr><td class="h"><a name="147"></a>147</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="148"></a>148</td><td></td><td></td><td></td><td></td><td class="s"> $cd_rs->create({ artist => 'Fred' });</td></tr>
+<tr><td class="h"><a name="149"></a>149</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="150"></a>150</td><td></td><td></td><td></td><td></td><td class="s">Which is the same as:</td></tr>
+<tr><td class="h"><a name="151"></a>151</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="152"></a>152</td><td></td><td></td><td></td><td></td><td class="s"> $schema->resultset('CD')->create({</td></tr>
+<tr><td class="h"><a name="153"></a>153</td><td></td><td></td><td></td><td></td><td class="s"> title => 'something',</td></tr>
+<tr><td class="h"><a name="154"></a>154</td><td></td><td></td><td></td><td></td><td class="s"> year => 2009,</td></tr>
+<tr><td class="h"><a name="155"></a>155</td><td></td><td></td><td></td><td></td><td class="s"> artist => 'Fred'</td></tr>
+<tr><td class="h"><a name="156"></a>156</td><td></td><td></td><td></td><td></td><td class="s"> });</td></tr>
+<tr><td class="h"><a name="157"></a>157</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="158"></a>158</td><td></td><td></td><td></td><td></td><td class="s">See: L</search>, L</count>, L</get_column>, L</all>, L</create>.</td></tr>
+<tr><td class="h"><a name="159"></a>159</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="160"></a>160</td><td></td><td></td><td></td><td></td><td class="s">=head1 METHODS</td></tr>
+<tr><td class="h"><a name="161"></a>161</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="162"></a>162</td><td></td><td></td><td></td><td></td><td class="s">=head2 new</td></tr>
+<tr><td class="h"><a name="163"></a>163</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="164"></a>164</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="165"></a>165</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="166"></a>166</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: $source, \%$attrs</td></tr>
+<tr><td class="h"><a name="167"></a>167</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="168"></a>168</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $rs</td></tr>
+<tr><td class="h"><a name="169"></a>169</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="170"></a>170</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="171"></a>171</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="172"></a>172</td><td></td><td></td><td></td><td></td><td class="s">The resultset constructor. Takes a source object (usually a</td></tr>
+<tr><td class="h"><a name="173"></a>173</td><td></td><td></td><td></td><td></td><td class="s">L<DBIx::Class::ResultSourceProxy::Table>) and an attribute hash (see</td></tr>
+<tr><td class="h"><a name="174"></a>174</td><td></td><td></td><td></td><td></td><td class="s">L</ATTRIBUTES> below). Does not perform any queries -- these are</td></tr>
+<tr><td class="h"><a name="175"></a>175</td><td></td><td></td><td></td><td></td><td class="s">executed as needed by the other methods.</td></tr>
+<tr><td class="h"><a name="176"></a>176</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="177"></a>177</td><td></td><td></td><td></td><td></td><td class="s">Generally you won't need to construct a resultset manually. You'll</td></tr>
+<tr><td class="h"><a name="178"></a>178</td><td></td><td></td><td></td><td></td><td class="s">automatically get one from e.g. a L</search> called in scalar context:</td></tr>
+<tr><td class="h"><a name="179"></a>179</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="180"></a>180</td><td></td><td></td><td></td><td></td><td class="s"> my $rs = $schema->resultset('CD')->search({ title => '100th Window' });</td></tr>
+<tr><td class="h"><a name="181"></a>181</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="182"></a>182</td><td></td><td></td><td></td><td></td><td class="s">IMPORTANT: If called on an object, proxies to new_result instead so</td></tr>
+<tr><td class="h"><a name="183"></a>183</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="184"></a>184</td><td></td><td></td><td></td><td></td><td class="s"> my $cd = $schema->resultset('CD')->new({ title => 'Spoon' });</td></tr>
+<tr><td class="h"><a name="185"></a>185</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="186"></a>186</td><td></td><td></td><td></td><td></td><td class="s">will return a CD object, not a ResultSet.</td></tr>
+<tr><td class="h"><a name="187"></a>187</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="188"></a>188</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="189"></a>189</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="190"></a>190</td><td></td><td></td><td></td><td></td><td class="s">sub new {</td></tr>
+<tr><td class="h"><a name="191"></a>191</td><td></td><td></td><td></td><td></td><td class="s"> my $class = shift;</td></tr>
+<tr><td class="h"><a name="192"></a>192</td><td></td><td></td><td></td><td></td><td class="s"> return $class->new_result(@_) if ref $class;</td></tr>
+<tr><td class="h"><a name="193"></a>193</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="194"></a>194</td><td></td><td></td><td></td><td></td><td class="s"> my ($source, $attrs) = @_;</td></tr>
+<tr><td class="h"><a name="195"></a>195</td><td></td><td></td><td></td><td></td><td class="s"> $source = $source->resolve</td></tr>
+<tr><td class="h"><a name="196"></a>196</td><td></td><td></td><td></td><td></td><td class="s"> if $source->isa('DBIx::Class::ResultSourceHandle');</td></tr>
+<tr><td class="h"><a name="197"></a>197</td><td></td><td></td><td></td><td></td><td class="s"> $attrs = { %{$attrs||{}} };</td></tr>
+<tr><td class="h"><a name="198"></a>198</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="199"></a>199</td><td></td><td></td><td></td><td></td><td class="s"> if ($attrs->{page}) {</td></tr>
+<tr><td class="h"><a name="200"></a>200</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{rows} ||= 10;</td></tr>
+<tr><td class="h"><a name="201"></a>201</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="202"></a>202</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="203"></a>203</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{alias} ||= 'me';</td></tr>
+<tr><td class="h"><a name="204"></a>204</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="205"></a>205</td><td></td><td></td><td></td><td></td><td class="s"> my $self = bless {</td></tr>
+<tr><td class="h"><a name="206"></a>206</td><td></td><td></td><td></td><td></td><td class="s"> result_source => $source,</td></tr>
+<tr><td class="h"><a name="207"></a>207</td><td></td><td></td><td></td><td></td><td class="s"> cond => $attrs->{where},</td></tr>
+<tr><td class="h"><a name="208"></a>208</td><td></td><td></td><td></td><td></td><td class="s"> pager => undef,</td></tr>
+<tr><td class="h"><a name="209"></a>209</td><td></td><td></td><td></td><td></td><td class="s"> attrs => $attrs,</td></tr>
+<tr><td class="h"><a name="210"></a>210</td><td></td><td></td><td></td><td></td><td class="s"> }, $class;</td></tr>
+<tr><td class="h"><a name="211"></a>211</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="212"></a>212</td><td></td><td></td><td></td><td></td><td class="s"> # if there is a dark selector, this means we are already in a</td></tr>
+<tr><td class="h"><a name="213"></a>213</td><td></td><td></td><td></td><td></td><td class="s"> # chain and the cleanup/sanification was taken care of by</td></tr>
+<tr><td class="h"><a name="214"></a>214</td><td></td><td></td><td></td><td></td><td class="s"> # _search_rs already</td></tr>
+<tr><td class="h"><a name="215"></a>215</td><td></td><td></td><td></td><td></td><td class="s"> $self->_normalize_selection($attrs)</td></tr>
+<tr><td class="h"><a name="216"></a>216</td><td></td><td></td><td></td><td></td><td class="s"> unless $attrs->{_dark_selector};</td></tr>
+<tr><td class="h"><a name="217"></a>217</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="218"></a>218</td><td></td><td></td><td></td><td></td><td class="s"> $self->result_class(</td></tr>
+<tr><td class="h"><a name="219"></a>219</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{result_class} || $source->result_class</td></tr>
+<tr><td class="h"><a name="220"></a>220</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="221"></a>221</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="222"></a>222</td><td></td><td></td><td></td><td></td><td class="s"> $self;</td></tr>
+<tr><td class="h"><a name="223"></a>223</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="224"></a>224</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="225"></a>225</td><td></td><td></td><td></td><td></td><td class="s">=head2 search</td></tr>
+<tr><td class="h"><a name="226"></a>226</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="227"></a>227</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="228"></a>228</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="229"></a>229</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: $cond, \%attrs?</td></tr>
+<tr><td class="h"><a name="230"></a>230</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="231"></a>231</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $resultset (scalar context) || @row_objs (list context)</td></tr>
+<tr><td class="h"><a name="232"></a>232</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="233"></a>233</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="234"></a>234</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="235"></a>235</td><td></td><td></td><td></td><td></td><td class="s"> my @cds = $cd_rs->search({ year => 2001 }); # "... WHERE year = 2001"</td></tr>
+<tr><td class="h"><a name="236"></a>236</td><td></td><td></td><td></td><td></td><td class="s"> my $new_rs = $cd_rs->search({ year => 2005 });</td></tr>
+<tr><td class="h"><a name="237"></a>237</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="238"></a>238</td><td></td><td></td><td></td><td></td><td class="s"> my $new_rs = $cd_rs->search([ { year => 2005 }, { year => 2004 } ]);</td></tr>
+<tr><td class="h"><a name="239"></a>239</td><td></td><td></td><td></td><td></td><td class="s"> # year = 2005 OR year = 2004</td></tr>
+<tr><td class="h"><a name="240"></a>240</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="241"></a>241</td><td></td><td></td><td></td><td></td><td class="s">In list context, C<< ->all() >> is called implicitly on the resultset, thus</td></tr>
+<tr><td class="h"><a name="242"></a>242</td><td></td><td></td><td></td><td></td><td class="s">returning a list of row objects instead. To avoid that, use L</search_rs>.</td></tr>
+<tr><td class="h"><a name="243"></a>243</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="244"></a>244</td><td></td><td></td><td></td><td></td><td class="s">If you need to pass in additional attributes but no additional condition,</td></tr>
+<tr><td class="h"><a name="245"></a>245</td><td></td><td></td><td></td><td></td><td class="s">call it as C<search(undef, \%attrs)>.</td></tr>
+<tr><td class="h"><a name="246"></a>246</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="247"></a>247</td><td></td><td></td><td></td><td></td><td class="s"> # "SELECT name, artistid FROM $artist_table"</td></tr>
+<tr><td class="h"><a name="248"></a>248</td><td></td><td></td><td></td><td></td><td class="s"> my @all_artists = $schema->resultset('Artist')->search(undef, {</td></tr>
+<tr><td class="h"><a name="249"></a>249</td><td></td><td></td><td></td><td></td><td class="s"> columns => [qw/name artistid/],</td></tr>
+<tr><td class="h"><a name="250"></a>250</td><td></td><td></td><td></td><td></td><td class="s"> });</td></tr>
+<tr><td class="h"><a name="251"></a>251</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="252"></a>252</td><td></td><td></td><td></td><td></td><td class="s">For a list of attributes that can be passed to C<search>, see</td></tr>
+<tr><td class="h"><a name="253"></a>253</td><td></td><td></td><td></td><td></td><td class="s">L</ATTRIBUTES>. For more examples of using this function, see</td></tr>
+<tr><td class="h"><a name="254"></a>254</td><td></td><td></td><td></td><td></td><td class="s">L<Searching|DBIx::Class::Manual::Cookbook/Searching>. For a complete</td></tr>
+<tr><td class="h"><a name="255"></a>255</td><td></td><td></td><td></td><td></td><td class="s">documentation for the first argument, see L<SQL::Abstract></td></tr>
+<tr><td class="h"><a name="256"></a>256</td><td></td><td></td><td></td><td></td><td class="s">and its extension L<DBIx::Class::SQLMaker>.</td></tr>
+<tr><td class="h"><a name="257"></a>257</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="258"></a>258</td><td></td><td></td><td></td><td></td><td class="s">For more help on using joins with search, see L<DBIx::Class::Manual::Joining>.</td></tr>
+<tr><td class="h"><a name="259"></a>259</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="260"></a>260</td><td></td><td></td><td></td><td></td><td class="s">=head3 CAVEAT</td></tr>
+<tr><td class="h"><a name="261"></a>261</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="262"></a>262</td><td></td><td></td><td></td><td></td><td class="s">Note that L</search> does not process/deflate any of the values passed in the</td></tr>
+<tr><td class="h"><a name="263"></a>263</td><td></td><td></td><td></td><td></td><td class="s">L<SQL::Abstract>-compatible search condition structure. This is unlike other</td></tr>
+<tr><td class="h"><a name="264"></a>264</td><td></td><td></td><td></td><td></td><td class="s">condition-bound methods L</new>, L</create> and L</find>. The user must ensure</td></tr>
+<tr><td class="h"><a name="265"></a>265</td><td></td><td></td><td></td><td></td><td class="s">manually that any value passed to this method will stringify to something the</td></tr>
+<tr><td class="h"><a name="266"></a>266</td><td></td><td></td><td></td><td></td><td class="s">RDBMS knows how to deal with. A notable example is the handling of L<DateTime></td></tr>
+<tr><td class="h"><a name="267"></a>267</td><td></td><td></td><td></td><td></td><td class="s">objects, for more info see:</td></tr>
+<tr><td class="h"><a name="268"></a>268</td><td></td><td></td><td></td><td></td><td class="s">L<DBIx::Class::Manual::Cookbook/Formatting_DateTime_objects_in_queries>.</td></tr>
+<tr><td class="h"><a name="269"></a>269</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="270"></a>270</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="271"></a>271</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="272"></a>272</td><td></td><td></td><td></td><td></td><td class="s">sub search {</td></tr>
+<tr><td class="h"><a name="273"></a>273</td><td></td><td></td><td></td><td></td><td class="s"> my $self = shift;</td></tr>
+<tr><td class="h"><a name="274"></a>274</td><td></td><td></td><td></td><td></td><td class="s"> my $rs = $self->search_rs( @_ );</td></tr>
+<tr><td class="h"><a name="275"></a>275</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="276"></a>276</td><td></td><td></td><td></td><td></td><td class="s"> if (wantarray) {</td></tr>
+<tr><td class="h"><a name="277"></a>277</td><td></td><td></td><td></td><td></td><td class="s"> return $rs->all;</td></tr>
+<tr><td class="h"><a name="278"></a>278</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="279"></a>279</td><td></td><td></td><td></td><td></td><td class="s"> elsif (defined wantarray) {</td></tr>
+<tr><td class="h"><a name="280"></a>280</td><td></td><td></td><td></td><td></td><td class="s"> return $rs;</td></tr>
+<tr><td class="h"><a name="281"></a>281</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="282"></a>282</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="283"></a>283</td><td></td><td></td><td></td><td></td><td class="s"> # we can be called by a relationship helper, which in</td></tr>
+<tr><td class="h"><a name="284"></a>284</td><td></td><td></td><td></td><td></td><td class="s"> # turn may be called in void context due to some braindead</td></tr>
+<tr><td class="h"><a name="285"></a>285</td><td></td><td></td><td></td><td></td><td class="s"> # overload or whatever else the user decided to be clever</td></tr>
+<tr><td class="h"><a name="286"></a>286</td><td></td><td></td><td></td><td></td><td class="s"> # at this particular day. Thus limit the exception to</td></tr>
+<tr><td class="h"><a name="287"></a>287</td><td></td><td></td><td></td><td></td><td class="s"> # external code calls only</td></tr>
+<tr><td class="h"><a name="288"></a>288</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception ('->search is *not* a mutator, calling it in void context makes no sense')</td></tr>
+<tr><td class="h"><a name="289"></a>289</td><td></td><td></td><td></td><td></td><td class="s"> if (caller)[0] !~ /^\QDBIx::Class::/;</td></tr>
+<tr><td class="h"><a name="290"></a>290</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="291"></a>291</td><td></td><td></td><td></td><td></td><td class="s"> return ();</td></tr>
+<tr><td class="h"><a name="292"></a>292</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="293"></a>293</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="294"></a>294</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="295"></a>295</td><td></td><td></td><td></td><td></td><td class="s">=head2 search_rs</td></tr>
+<tr><td class="h"><a name="296"></a>296</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="297"></a>297</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="298"></a>298</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="299"></a>299</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: $cond, \%attrs?</td></tr>
+<tr><td class="h"><a name="300"></a>300</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="301"></a>301</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $resultset</td></tr>
+<tr><td class="h"><a name="302"></a>302</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="303"></a>303</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="304"></a>304</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="305"></a>305</td><td></td><td></td><td></td><td></td><td class="s">This method does the same exact thing as search() except it will</td></tr>
+<tr><td class="h"><a name="306"></a>306</td><td></td><td></td><td></td><td></td><td class="s">always return a resultset, even in list context.</td></tr>
+<tr><td class="h"><a name="307"></a>307</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="308"></a>308</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="309"></a>309</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="310"></a>310</td><td></td><td></td><td></td><td></td><td class="s">sub search_rs {</td></tr>
+<tr><td class="h"><a name="311"></a>311</td><td></td><td></td><td></td><td></td><td class="s"> my $self = shift;</td></tr>
+<tr><td class="h"><a name="312"></a>312</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="313"></a>313</td><td></td><td></td><td></td><td></td><td class="s"> # Special-case handling for (undef, undef).</td></tr>
+<tr><td class="h"><a name="314"></a>314</td><td></td><td></td><td></td><td></td><td class="s"> if ( @_ == 2 && !defined $_[1] && !defined $_[0] ) {</td></tr>
+<tr><td class="h"><a name="315"></a>315</td><td></td><td></td><td></td><td></td><td class="s"> @_ = ();</td></tr>
+<tr><td class="h"><a name="316"></a>316</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="317"></a>317</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="318"></a>318</td><td></td><td></td><td></td><td></td><td class="s"> my $call_attrs = {};</td></tr>
+<tr><td class="h"><a name="319"></a>319</td><td></td><td></td><td></td><td></td><td class="s"> if (@_ > 1) {</td></tr>
+<tr><td class="h"><a name="320"></a>320</td><td></td><td></td><td></td><td></td><td class="s"> if (ref $_[-1] eq 'HASH') {</td></tr>
+<tr><td class="h"><a name="321"></a>321</td><td></td><td></td><td></td><td></td><td class="s"> # copy for _normalize_selection</td></tr>
+<tr><td class="h"><a name="322"></a>322</td><td></td><td></td><td></td><td></td><td class="s"> $call_attrs = { %{ pop @_ } };</td></tr>
+<tr><td class="h"><a name="323"></a>323</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="324"></a>324</td><td></td><td></td><td></td><td></td><td class="s"> elsif (! defined $_[-1] ) {</td></tr>
+<tr><td class="h"><a name="325"></a>325</td><td></td><td></td><td></td><td></td><td class="s"> pop @_; # search({}, undef)</td></tr>
+<tr><td class="h"><a name="326"></a>326</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="327"></a>327</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="328"></a>328</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="329"></a>329</td><td></td><td></td><td></td><td></td><td class="s"> # see if we can keep the cache (no $rs changes)</td></tr>
+<tr><td class="h"><a name="330"></a>330</td><td></td><td></td><td></td><td></td><td class="s"> my $cache;</td></tr>
+<tr><td class="h"><a name="331"></a>331</td><td></td><td></td><td></td><td></td><td class="s"> my %safe = (alias => 1, cache => 1);</td></tr>
+<tr><td class="h"><a name="332"></a>332</td><td></td><td></td><td></td><td></td><td class="s"> if ( ! List::Util::first { !$safe{$_} } keys %$call_attrs and (</td></tr>
+<tr><td class="h"><a name="333"></a>333</td><td></td><td></td><td></td><td></td><td class="s"> ! defined $_[0]</td></tr>
+<tr><td class="h"><a name="334"></a>334</td><td></td><td></td><td></td><td></td><td class="s"> or</td></tr>
+<tr><td class="h"><a name="335"></a>335</td><td></td><td></td><td></td><td></td><td class="s"> ref $_[0] eq 'HASH' && ! keys %{$_[0]}</td></tr>
+<tr><td class="h"><a name="336"></a>336</td><td></td><td></td><td></td><td></td><td class="s"> or</td></tr>
+<tr><td class="h"><a name="337"></a>337</td><td></td><td></td><td></td><td></td><td class="s"> ref $_[0] eq 'ARRAY' && ! @{$_[0]}</td></tr>
+<tr><td class="h"><a name="338"></a>338</td><td></td><td></td><td></td><td></td><td class="s"> )) {</td></tr>
+<tr><td class="h"><a name="339"></a>339</td><td></td><td></td><td></td><td></td><td class="s"> $cache = $self->get_cache;</td></tr>
+<tr><td class="h"><a name="340"></a>340</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="341"></a>341</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="342"></a>342</td><td></td><td></td><td></td><td></td><td class="s"> my $rsrc = $self->result_source;</td></tr>
+<tr><td class="h"><a name="343"></a>343</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="344"></a>344</td><td></td><td></td><td></td><td></td><td class="s"> my $old_attrs = { %{$self->{attrs}} };</td></tr>
+<tr><td class="h"><a name="345"></a>345</td><td></td><td></td><td></td><td></td><td class="s"> my $old_having = delete $old_attrs->{having};</td></tr>
+<tr><td class="h"><a name="346"></a>346</td><td></td><td></td><td></td><td></td><td class="s"> my $old_where = delete $old_attrs->{where};</td></tr>
+<tr><td class="h"><a name="347"></a>347</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="348"></a>348</td><td></td><td></td><td></td><td></td><td class="s"> my $new_attrs = { %$old_attrs };</td></tr>
+<tr><td class="h"><a name="349"></a>349</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="350"></a>350</td><td></td><td></td><td></td><td></td><td class="s"> # take care of call attrs (only if anything is changing)</td></tr>
+<tr><td class="h"><a name="351"></a>351</td><td></td><td></td><td></td><td></td><td class="s"> if (keys %$call_attrs) {</td></tr>
+<tr><td class="h"><a name="352"></a>352</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="353"></a>353</td><td></td><td></td><td></td><td></td><td class="s"> my @selector_attrs = qw/select as columns cols +select +as +columns include_columns/;</td></tr>
+<tr><td class="h"><a name="354"></a>354</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="355"></a>355</td><td></td><td></td><td></td><td></td><td class="s"> # reset the current selector list if new selectors are supplied</td></tr>
+<tr><td class="h"><a name="356"></a>356</td><td></td><td></td><td></td><td></td><td class="s"> if (List::Util::first { exists $call_attrs->{$_} } qw/columns cols select as/) {</td></tr>
+<tr><td class="h"><a name="357"></a>357</td><td></td><td></td><td></td><td></td><td class="s"> delete @{$old_attrs}{(@selector_attrs, '_dark_selector')};</td></tr>
+<tr><td class="h"><a name="358"></a>358</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="359"></a>359</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="360"></a>360</td><td></td><td></td><td></td><td></td><td class="s"> # Normalize the new selector list (operates on the passed-in attr structure)</td></tr>
+<tr><td class="h"><a name="361"></a>361</td><td></td><td></td><td></td><td></td><td class="s"> # Need to do it on every chain instead of only once on _resolved_attrs, in</td></tr>
+<tr><td class="h"><a name="362"></a>362</td><td></td><td></td><td></td><td></td><td class="s"> # order to allow detection of empty vs partial 'as'</td></tr>
+<tr><td class="h"><a name="363"></a>363</td><td></td><td></td><td></td><td></td><td class="s"> $call_attrs->{_dark_selector} = $old_attrs->{_dark_selector}</td></tr>
+<tr><td class="h"><a name="364"></a>364</td><td></td><td></td><td></td><td></td><td class="s"> if $old_attrs->{_dark_selector};</td></tr>
+<tr><td class="h"><a name="365"></a>365</td><td></td><td></td><td></td><td></td><td class="s"> $self->_normalize_selection ($call_attrs);</td></tr>
+<tr><td class="h"><a name="366"></a>366</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="367"></a>367</td><td></td><td></td><td></td><td></td><td class="s"> # start with blind overwriting merge, exclude selector attrs</td></tr>
+<tr><td class="h"><a name="368"></a>368</td><td></td><td></td><td></td><td></td><td class="s"> $new_attrs = { %{$old_attrs}, %{$call_attrs} };</td></tr>
+<tr><td class="h"><a name="369"></a>369</td><td></td><td></td><td></td><td></td><td class="s"> delete @{$new_attrs}{@selector_attrs};</td></tr>
+<tr><td class="h"><a name="370"></a>370</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="371"></a>371</td><td></td><td></td><td></td><td></td><td class="s"> for (@selector_attrs) {</td></tr>
+<tr><td class="h"><a name="372"></a>372</td><td></td><td></td><td></td><td></td><td class="s"> $new_attrs->{$_} = $self->_merge_attr($old_attrs->{$_}, $call_attrs->{$_})</td></tr>
+<tr><td class="h"><a name="373"></a>373</td><td></td><td></td><td></td><td></td><td class="s"> if ( exists $old_attrs->{$_} or exists $call_attrs->{$_} );</td></tr>
+<tr><td class="h"><a name="374"></a>374</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="375"></a>375</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="376"></a>376</td><td></td><td></td><td></td><td></td><td class="s"> # older deprecated name, use only if {columns} is not there</td></tr>
+<tr><td class="h"><a name="377"></a>377</td><td></td><td></td><td></td><td></td><td class="s"> if (my $c = delete $new_attrs->{cols}) {</td></tr>
+<tr><td class="h"><a name="378"></a>378</td><td></td><td></td><td></td><td></td><td class="s"> if ($new_attrs->{columns}) {</td></tr>
+<tr><td class="h"><a name="379"></a>379</td><td></td><td></td><td></td><td></td><td class="s"> carp "Resultset specifies both the 'columns' and the legacy 'cols' attributes - ignoring 'cols'";</td></tr>
+<tr><td class="h"><a name="380"></a>380</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="381"></a>381</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="382"></a>382</td><td></td><td></td><td></td><td></td><td class="s"> $new_attrs->{columns} = $c;</td></tr>
+<tr><td class="h"><a name="383"></a>383</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="384"></a>384</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="385"></a>385</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="386"></a>386</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="387"></a>387</td><td></td><td></td><td></td><td></td><td class="s"> # join/prefetch use their own crazy merging heuristics</td></tr>
+<tr><td class="h"><a name="388"></a>388</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $key (qw/join prefetch/) {</td></tr>
+<tr><td class="h"><a name="389"></a>389</td><td></td><td></td><td></td><td></td><td class="s"> $new_attrs->{$key} = $self->_merge_joinpref_attr($old_attrs->{$key}, $call_attrs->{$key})</td></tr>
+<tr><td class="h"><a name="390"></a>390</td><td></td><td></td><td></td><td></td><td class="s"> if exists $call_attrs->{$key};</td></tr>
+<tr><td class="h"><a name="391"></a>391</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="392"></a>392</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="393"></a>393</td><td></td><td></td><td></td><td></td><td class="s"> # stack binds together</td></tr>
+<tr><td class="h"><a name="394"></a>394</td><td></td><td></td><td></td><td></td><td class="s"> $new_attrs->{bind} = [ @{ $old_attrs->{bind} || [] }, @{ $call_attrs->{bind} || [] } ];</td></tr>
+<tr><td class="h"><a name="395"></a>395</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="396"></a>396</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="397"></a>397</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="398"></a>398</td><td></td><td></td><td></td><td></td><td class="s"> # rip apart the rest of @_, parse a condition</td></tr>
+<tr><td class="h"><a name="399"></a>399</td><td></td><td></td><td></td><td></td><td class="s"> my $call_cond = do {</td></tr>
+<tr><td class="h"><a name="400"></a>400</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="401"></a>401</td><td></td><td></td><td></td><td></td><td class="s"> if (ref $_[0] eq 'HASH') {</td></tr>
+<tr><td class="h"><a name="402"></a>402</td><td></td><td></td><td></td><td></td><td class="s"> (keys %{$_[0]}) ? $_[0] : undef</td></tr>
+<tr><td class="h"><a name="403"></a>403</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="404"></a>404</td><td></td><td></td><td></td><td></td><td class="s"> elsif (@_ == 1) {</td></tr>
+<tr><td class="h"><a name="405"></a>405</td><td></td><td></td><td></td><td></td><td class="s"> $_[0]</td></tr>
+<tr><td class="h"><a name="406"></a>406</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="407"></a>407</td><td></td><td></td><td></td><td></td><td class="s"> elsif (@_ % 2) {</td></tr>
+<tr><td class="h"><a name="408"></a>408</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception('Odd number of arguments to search')</td></tr>
+<tr><td class="h"><a name="409"></a>409</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="410"></a>410</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="411"></a>411</td><td></td><td></td><td></td><td></td><td class="s"> +{ @_ }</td></tr>
+<tr><td class="h"><a name="412"></a>412</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="413"></a>413</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="414"></a>414</td><td></td><td></td><td></td><td></td><td class="s"> } if @_;</td></tr>
+<tr><td class="h"><a name="415"></a>415</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="416"></a>416</td><td></td><td></td><td></td><td></td><td class="s"> if( @_ > 1 and ! $rsrc->result_class->isa('DBIx::Class::CDBICompat') ) {</td></tr>
+<tr><td class="h"><a name="417"></a>417</td><td></td><td></td><td></td><td></td><td class="s"> carp_unique 'search( %condition ) is deprecated, use search( \%condition ) instead';</td></tr>
+<tr><td class="h"><a name="418"></a>418</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="419"></a>419</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="420"></a>420</td><td></td><td></td><td></td><td></td><td class="s"> for ($old_where, $call_cond) {</td></tr>
+<tr><td class="h"><a name="421"></a>421</td><td></td><td></td><td></td><td></td><td class="s"> if (defined $_) {</td></tr>
+<tr><td class="h"><a name="422"></a>422</td><td></td><td></td><td></td><td></td><td class="s"> $new_attrs->{where} = $self->_stack_cond (</td></tr>
+<tr><td class="h"><a name="423"></a>423</td><td></td><td></td><td></td><td></td><td class="s"> $_, $new_attrs->{where}</td></tr>
+<tr><td class="h"><a name="424"></a>424</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="425"></a>425</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="426"></a>426</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="427"></a>427</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="428"></a>428</td><td></td><td></td><td></td><td></td><td class="s"> if (defined $old_having) {</td></tr>
+<tr><td class="h"><a name="429"></a>429</td><td></td><td></td><td></td><td></td><td class="s"> $new_attrs->{having} = $self->_stack_cond (</td></tr>
+<tr><td class="h"><a name="430"></a>430</td><td></td><td></td><td></td><td></td><td class="s"> $old_having, $new_attrs->{having}</td></tr>
+<tr><td class="h"><a name="431"></a>431</td><td></td><td></td><td></td><td></td><td class="s"> )</td></tr>
+<tr><td class="h"><a name="432"></a>432</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="433"></a>433</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="434"></a>434</td><td></td><td></td><td></td><td></td><td class="s"> my $rs = (ref $self)->new($rsrc, $new_attrs);</td></tr>
+<tr><td class="h"><a name="435"></a>435</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="436"></a>436</td><td></td><td></td><td></td><td></td><td class="s"> $rs->set_cache($cache) if ($cache);</td></tr>
+<tr><td class="h"><a name="437"></a>437</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="438"></a>438</td><td></td><td></td><td></td><td></td><td class="s"> return $rs;</td></tr>
+<tr><td class="h"><a name="439"></a>439</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="440"></a>440</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="441"></a>441</td><td class="c3">1</td><td class="c3"><span title="Avg 200ns">200ns</span></td><td></td><td></td><td class="s">my $dark_sel_dumper;</td></tr>
+<tr><td class="h"><a name="442"></a>442</td><td></td><td></td><td></td><td></td><td class="s">sub _normalize_selection {</td></tr>
+<tr><td class="h"><a name="443"></a>443</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $attrs) = @_;</td></tr>
+<tr><td class="h"><a name="444"></a>444</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="445"></a>445</td><td></td><td></td><td></td><td></td><td class="s"> # legacy syntax</td></tr>
+<tr><td class="h"><a name="446"></a>446</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{'+columns'} = $self->_merge_attr($attrs->{'+columns'}, delete $attrs->{include_columns})</td></tr>
+<tr><td class="h"><a name="447"></a>447</td><td></td><td></td><td></td><td></td><td class="s"> if exists $attrs->{include_columns};</td></tr>
+<tr><td class="h"><a name="448"></a>448</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="449"></a>449</td><td></td><td></td><td></td><td></td><td class="s"> # columns are always placed first, however </td></tr>
+<tr><td class="h"><a name="450"></a>450</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="451"></a>451</td><td></td><td></td><td></td><td></td><td class="s"> # Keep the X vs +X separation until _resolved_attrs time - this allows to</td></tr>
+<tr><td class="h"><a name="452"></a>452</td><td></td><td></td><td></td><td></td><td class="s"> # delay the decision on whether to use a default select list ($rsrc->columns)</td></tr>
+<tr><td class="h"><a name="453"></a>453</td><td></td><td></td><td></td><td></td><td class="s"> # allowing stuff like the remove_columns helper to work</td></tr>
+<tr><td class="h"><a name="454"></a>454</td><td></td><td></td><td></td><td></td><td class="s"> #</td></tr>
+<tr><td class="h"><a name="455"></a>455</td><td></td><td></td><td></td><td></td><td class="s"> # select/as +select/+as pairs need special handling - the amount of select/as</td></tr>
+<tr><td class="h"><a name="456"></a>456</td><td></td><td></td><td></td><td></td><td class="s"> # elements in each pair does *not* have to be equal (think multicolumn</td></tr>
+<tr><td class="h"><a name="457"></a>457</td><td></td><td></td><td></td><td></td><td class="s"> # selectors like distinct(foo, bar) ). If the selector is bare (no 'as'</td></tr>
+<tr><td class="h"><a name="458"></a>458</td><td></td><td></td><td></td><td></td><td class="s"> # supplied at all) - try to infer the alias, either from the -as parameter</td></tr>
+<tr><td class="h"><a name="459"></a>459</td><td></td><td></td><td></td><td></td><td class="s"> # of the selector spec, or use the parameter whole if it looks like a column</td></tr>
+<tr><td class="h"><a name="460"></a>460</td><td></td><td></td><td></td><td></td><td class="s"> # name (ugly legacy heuristic). If all fails - leave the selector bare (which</td></tr>
+<tr><td class="h"><a name="461"></a>461</td><td></td><td></td><td></td><td></td><td class="s"> # is ok as well), but make sure no more additions to the 'as' chain take place</td></tr>
+<tr><td class="h"><a name="462"></a>462</td><td></td><td></td><td></td><td></td><td class="s"> for my $pref ('', '+') {</td></tr>
+<tr><td class="h"><a name="463"></a>463</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="464"></a>464</td><td></td><td></td><td></td><td></td><td class="s"> my ($sel, $as) = map {</td></tr>
+<tr><td class="h"><a name="465"></a>465</td><td></td><td></td><td></td><td></td><td class="s"> my $key = "${pref}${_}";</td></tr>
+<tr><td class="h"><a name="466"></a>466</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="467"></a>467</td><td></td><td></td><td></td><td></td><td class="s"> my $val = [ ref $attrs->{$key} eq 'ARRAY'</td></tr>
+<tr><td class="h"><a name="468"></a>468</td><td></td><td></td><td></td><td></td><td class="s"> ? @{$attrs->{$key}}</td></tr>
+<tr><td class="h"><a name="469"></a>469</td><td></td><td></td><td></td><td></td><td class="s"> : $attrs->{$key} || ()</td></tr>
+<tr><td class="h"><a name="470"></a>470</td><td></td><td></td><td></td><td></td><td class="s"> ];</td></tr>
+<tr><td class="h"><a name="471"></a>471</td><td></td><td></td><td></td><td></td><td class="s"> delete $attrs->{$key};</td></tr>
+<tr><td class="h"><a name="472"></a>472</td><td></td><td></td><td></td><td></td><td class="s"> $val;</td></tr>
+<tr><td class="h"><a name="473"></a>473</td><td></td><td></td><td></td><td></td><td class="s"> } qw/select as/;</td></tr>
+<tr><td class="h"><a name="474"></a>474</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="475"></a>475</td><td></td><td></td><td></td><td></td><td class="s"> if (! @$as and ! @$sel ) {</td></tr>
+<tr><td class="h"><a name="476"></a>476</td><td></td><td></td><td></td><td></td><td class="s"> next;</td></tr>
+<tr><td class="h"><a name="477"></a>477</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="478"></a>478</td><td></td><td></td><td></td><td></td><td class="s"> elsif (@$as and ! @$sel) {</td></tr>
+<tr><td class="h"><a name="479"></a>479</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception(</td></tr>
+<tr><td class="h"><a name="480"></a>480</td><td></td><td></td><td></td><td></td><td class="s"> "Unable to handle ${pref}as specification (@$as) without a corresponding ${pref}select"</td></tr>
+<tr><td class="h"><a name="481"></a>481</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="482"></a>482</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="483"></a>483</td><td></td><td></td><td></td><td></td><td class="s"> elsif( ! @$as ) {</td></tr>
+<tr><td class="h"><a name="484"></a>484</td><td></td><td></td><td></td><td></td><td class="s"> # no as part supplied at all - try to deduce (unless explicit end of named selection is declared)</td></tr>
+<tr><td class="h"><a name="485"></a>485</td><td></td><td></td><td></td><td></td><td class="s"> # if any @$as has been supplied we assume the user knows what (s)he is doing</td></tr>
+<tr><td class="h"><a name="486"></a>486</td><td></td><td></td><td></td><td></td><td class="s"> # and blindly keep stacking up pieces</td></tr>
+<tr><td class="h"><a name="487"></a>487</td><td></td><td></td><td></td><td></td><td class="s"> unless ($attrs->{_dark_selector}) {</td></tr>
+<tr><td class="h"><a name="488"></a>488</td><td></td><td></td><td></td><td></td><td class="s"> SELECTOR:</td></tr>
+<tr><td class="h"><a name="489"></a>489</td><td></td><td></td><td></td><td></td><td class="s"> for (@$sel) {</td></tr>
+<tr><td class="h"><a name="490"></a>490</td><td></td><td></td><td></td><td></td><td class="s"> if ( ref $_ eq 'HASH' and exists $_->{-as} ) {</td></tr>
+<tr><td class="h"><a name="491"></a>491</td><td></td><td></td><td></td><td></td><td class="s"> push @$as, $_->{-as};</td></tr>
+<tr><td class="h"><a name="492"></a>492</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="493"></a>493</td><td></td><td></td><td></td><td></td><td class="s"> # assume any plain no-space, no-parenthesis string to be a column spec</td></tr>
+<tr><td class="h"><a name="494"></a>494</td><td></td><td></td><td></td><td></td><td class="s"> # FIXME - this is retarded but is necessary to support shit like 'count(foo)'</td></tr>
+<tr><td class="h"><a name="495"></a>495</td><td></td><td></td><td></td><td></td><td class="s"> elsif ( ! ref $_ and $_ =~ /^ [^\s\(\)]+ $/x) {</td></tr>
+<tr><td class="h"><a name="496"></a>496</td><td></td><td></td><td></td><td></td><td class="s"> push @$as, $_;</td></tr>
+<tr><td class="h"><a name="497"></a>497</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="498"></a>498</td><td></td><td></td><td></td><td></td><td class="s"> # if all else fails - raise a flag that no more aliasing will be allowed</td></tr>
+<tr><td class="h"><a name="499"></a>499</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="500"></a>500</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{_dark_selector} = {</td></tr>
+<tr><td class="h"><a name="501"></a>501</td><td></td><td></td><td></td><td></td><td class="s"> plus_stage => $pref,</td></tr>
+<tr><td class="h"><a name="502"></a>502</td><td></td><td></td><td></td><td></td><td class="s"> string => ($dark_sel_dumper ||= do {</td></tr>
+<tr><td class="h"><a name="503"></a>503</td><td></td><td></td><td></td><td></td><td class="s"> require Data::Dumper::Concise;</td></tr>
+<tr><td class="h"><a name="504"></a>504</td><td></td><td></td><td></td><td></td><td class="s"> Data::Dumper::Concise::DumperObject()->Indent(0);</td></tr>
+<tr><td class="h"><a name="505"></a>505</td><td></td><td></td><td></td><td></td><td class="s"> })->Values([$_])->Dump</td></tr>
+<tr><td class="h"><a name="506"></a>506</td><td></td><td></td><td></td><td></td><td class="s"> ,</td></tr>
+<tr><td class="h"><a name="507"></a>507</td><td></td><td></td><td></td><td></td><td class="s"> };</td></tr>
+<tr><td class="h"><a name="508"></a>508</td><td></td><td></td><td></td><td></td><td class="s"> last SELECTOR;</td></tr>
+<tr><td class="h"><a name="509"></a>509</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="510"></a>510</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="511"></a>511</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="512"></a>512</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="513"></a>513</td><td></td><td></td><td></td><td></td><td class="s"> elsif (@$as < @$sel) {</td></tr>
+<tr><td class="h"><a name="514"></a>514</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception(</td></tr>
+<tr><td class="h"><a name="515"></a>515</td><td></td><td></td><td></td><td></td><td class="s"> "Unable to handle an ${pref}as specification (@$as) with less elements than the corresponding ${pref}select"</td></tr>
+<tr><td class="h"><a name="516"></a>516</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="517"></a>517</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="518"></a>518</td><td></td><td></td><td></td><td></td><td class="s"> elsif ($pref and $attrs->{_dark_selector}) {</td></tr>
+<tr><td class="h"><a name="519"></a>519</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception(</td></tr>
+<tr><td class="h"><a name="520"></a>520</td><td></td><td></td><td></td><td></td><td class="s"> "Unable to process named '+select', resultset contains an unnamed selector $attrs->{_dark_selector}{string}"</td></tr>
+<tr><td class="h"><a name="521"></a>521</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="522"></a>522</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="523"></a>523</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="524"></a>524</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="525"></a>525</td><td></td><td></td><td></td><td></td><td class="s"> # merge result</td></tr>
+<tr><td class="h"><a name="526"></a>526</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{"${pref}select"} = $self->_merge_attr($attrs->{"${pref}select"}, $sel);</td></tr>
+<tr><td class="h"><a name="527"></a>527</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{"${pref}as"} = $self->_merge_attr($attrs->{"${pref}as"}, $as);</td></tr>
+<tr><td class="h"><a name="528"></a>528</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="529"></a>529</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="530"></a>530</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="531"></a>531</td><td></td><td></td><td></td><td></td><td class="s">sub _stack_cond {</td></tr>
+<tr><td class="h"><a name="532"></a>532</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $left, $right) = @_;</td></tr>
+<tr><td class="h"><a name="533"></a>533</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="534"></a>534</td><td></td><td></td><td></td><td></td><td class="s"> # collapse single element top-level conditions</td></tr>
+<tr><td class="h"><a name="535"></a>535</td><td></td><td></td><td></td><td></td><td class="s"> # (single pass only, unlikely to need recursion)</td></tr>
+<tr><td class="h"><a name="536"></a>536</td><td></td><td></td><td></td><td></td><td class="s"> for ($left, $right) {</td></tr>
+<tr><td class="h"><a name="537"></a>537</td><td></td><td></td><td></td><td></td><td class="s"> if (ref $_ eq 'ARRAY') {</td></tr>
+<tr><td class="h"><a name="538"></a>538</td><td></td><td></td><td></td><td></td><td class="s"> if (@$_ == 0) {</td></tr>
+<tr><td class="h"><a name="539"></a>539</td><td></td><td></td><td></td><td></td><td class="s"> $_ = undef;</td></tr>
+<tr><td class="h"><a name="540"></a>540</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="541"></a>541</td><td></td><td></td><td></td><td></td><td class="s"> elsif (@$_ == 1) {</td></tr>
+<tr><td class="h"><a name="542"></a>542</td><td></td><td></td><td></td><td></td><td class="s"> $_ = $_->[0];</td></tr>
+<tr><td class="h"><a name="543"></a>543</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="544"></a>544</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="545"></a>545</td><td></td><td></td><td></td><td></td><td class="s"> elsif (ref $_ eq 'HASH') {</td></tr>
+<tr><td class="h"><a name="546"></a>546</td><td></td><td></td><td></td><td></td><td class="s"> my ($first, $more) = keys %$_;</td></tr>
+<tr><td class="h"><a name="547"></a>547</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="548"></a>548</td><td></td><td></td><td></td><td></td><td class="s"> # empty hash</td></tr>
+<tr><td class="h"><a name="549"></a>549</td><td></td><td></td><td></td><td></td><td class="s"> if (! defined $first) {</td></tr>
+<tr><td class="h"><a name="550"></a>550</td><td></td><td></td><td></td><td></td><td class="s"> $_ = undef;</td></tr>
+<tr><td class="h"><a name="551"></a>551</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="552"></a>552</td><td></td><td></td><td></td><td></td><td class="s"> # one element hash</td></tr>
+<tr><td class="h"><a name="553"></a>553</td><td></td><td></td><td></td><td></td><td class="s"> elsif (! defined $more) {</td></tr>
+<tr><td class="h"><a name="554"></a>554</td><td></td><td></td><td></td><td></td><td class="s"> if ($first eq '-and' and ref $_->{'-and'} eq 'HASH') {</td></tr>
+<tr><td class="h"><a name="555"></a>555</td><td></td><td></td><td></td><td></td><td class="s"> $_ = $_->{'-and'};</td></tr>
+<tr><td class="h"><a name="556"></a>556</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="557"></a>557</td><td></td><td></td><td></td><td></td><td class="s"> elsif ($first eq '-or' and ref $_->{'-or'} eq 'ARRAY') {</td></tr>
+<tr><td class="h"><a name="558"></a>558</td><td></td><td></td><td></td><td></td><td class="s"> $_ = $_->{'-or'};</td></tr>
+<tr><td class="h"><a name="559"></a>559</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="560"></a>560</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="561"></a>561</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="562"></a>562</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="563"></a>563</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="564"></a>564</td><td></td><td></td><td></td><td></td><td class="s"> # merge hashes with weeding out of duplicates (simple cases only)</td></tr>
+<tr><td class="h"><a name="565"></a>565</td><td></td><td></td><td></td><td></td><td class="s"> if (ref $left eq 'HASH' and ref $right eq 'HASH') {</td></tr>
+<tr><td class="h"><a name="566"></a>566</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="567"></a>567</td><td></td><td></td><td></td><td></td><td class="s"> # shallow copy to destroy</td></tr>
+<tr><td class="h"><a name="568"></a>568</td><td></td><td></td><td></td><td></td><td class="s"> $right = { %$right };</td></tr>
+<tr><td class="h"><a name="569"></a>569</td><td></td><td></td><td></td><td></td><td class="s"> for (grep { exists $right->{$_} } keys %$left) {</td></tr>
+<tr><td class="h"><a name="570"></a>570</td><td></td><td></td><td></td><td></td><td class="s"> # the use of eq_deeply here is justified - the rhs of an</td></tr>
+<tr><td class="h"><a name="571"></a>571</td><td></td><td></td><td></td><td></td><td class="s"> # expression can contain a lot of twisted weird stuff</td></tr>
+<tr><td class="h"><a name="572"></a>572</td><td></td><td></td><td></td><td></td><td class="s"> delete $right->{$_} if Data::Compare::Compare( $left->{$_}, $right->{$_} );</td></tr>
+<tr><td class="h"><a name="573"></a>573</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="574"></a>574</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="575"></a>575</td><td></td><td></td><td></td><td></td><td class="s"> $right = undef unless keys %$right;</td></tr>
+<tr><td class="h"><a name="576"></a>576</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="577"></a>577</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="578"></a>578</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="579"></a>579</td><td></td><td></td><td></td><td></td><td class="s"> if (defined $left xor defined $right) {</td></tr>
+<tr><td class="h"><a name="580"></a>580</td><td></td><td></td><td></td><td></td><td class="s"> return defined $left ? $left : $right;</td></tr>
+<tr><td class="h"><a name="581"></a>581</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="582"></a>582</td><td></td><td></td><td></td><td></td><td class="s"> elsif (! defined $left) {</td></tr>
+<tr><td class="h"><a name="583"></a>583</td><td></td><td></td><td></td><td></td><td class="s"> return undef;</td></tr>
+<tr><td class="h"><a name="584"></a>584</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="585"></a>585</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="586"></a>586</td><td></td><td></td><td></td><td></td><td class="s"> return { -and => [ $left, $right ] };</td></tr>
+<tr><td class="h"><a name="587"></a>587</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="588"></a>588</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="589"></a>589</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="590"></a>590</td><td></td><td></td><td></td><td></td><td class="s">=head2 search_literal</td></tr>
+<tr><td class="h"><a name="591"></a>591</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="592"></a>592</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="593"></a>593</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="594"></a>594</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: $sql_fragment, @bind_values</td></tr>
+<tr><td class="h"><a name="595"></a>595</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="596"></a>596</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $resultset (scalar context) || @row_objs (list context)</td></tr>
+<tr><td class="h"><a name="597"></a>597</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="598"></a>598</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="599"></a>599</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="600"></a>600</td><td></td><td></td><td></td><td></td><td class="s"> my @cds = $cd_rs->search_literal('year = ? AND title = ?', qw/2001 Reload/);</td></tr>
+<tr><td class="h"><a name="601"></a>601</td><td></td><td></td><td></td><td></td><td class="s"> my $newrs = $artist_rs->search_literal('name = ?', 'Metallica');</td></tr>
+<tr><td class="h"><a name="602"></a>602</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="603"></a>603</td><td></td><td></td><td></td><td></td><td class="s">Pass a literal chunk of SQL to be added to the conditional part of the</td></tr>
+<tr><td class="h"><a name="604"></a>604</td><td></td><td></td><td></td><td></td><td class="s">resultset query.</td></tr>
+<tr><td class="h"><a name="605"></a>605</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="606"></a>606</td><td></td><td></td><td></td><td></td><td class="s">CAVEAT: C<search_literal> is provided for Class::DBI compatibility and should</td></tr>
+<tr><td class="h"><a name="607"></a>607</td><td></td><td></td><td></td><td></td><td class="s">only be used in that context. C<search_literal> is a convenience method.</td></tr>
+<tr><td class="h"><a name="608"></a>608</td><td></td><td></td><td></td><td></td><td class="s">It is equivalent to calling $schema->search(\[]), but if you want to ensure</td></tr>
+<tr><td class="h"><a name="609"></a>609</td><td></td><td></td><td></td><td></td><td class="s">columns are bound correctly, use C<search>.</td></tr>
+<tr><td class="h"><a name="610"></a>610</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="611"></a>611</td><td></td><td></td><td></td><td></td><td class="s">Example of how to use C<search> instead of C<search_literal></td></tr>
+<tr><td class="h"><a name="612"></a>612</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="613"></a>613</td><td></td><td></td><td></td><td></td><td class="s"> my @cds = $cd_rs->search_literal('cdid = ? AND (artist = ? OR artist = ?)', (2, 1, 2));</td></tr>
+<tr><td class="h"><a name="614"></a>614</td><td></td><td></td><td></td><td></td><td class="s"> my @cds = $cd_rs->search(\[ 'cdid = ? AND (artist = ? OR artist = ?)', [ 'cdid', 2 ], [ 'artist', 1 ], [ 'artist', 2 ] ]);</td></tr>
+<tr><td class="h"><a name="615"></a>615</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="616"></a>616</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="617"></a>617</td><td></td><td></td><td></td><td></td><td class="s">See L<DBIx::Class::Manual::Cookbook/Searching> and</td></tr>
+<tr><td class="h"><a name="618"></a>618</td><td></td><td></td><td></td><td></td><td class="s">L<DBIx::Class::Manual::FAQ/Searching> for searching techniques that do not</td></tr>
+<tr><td class="h"><a name="619"></a>619</td><td></td><td></td><td></td><td></td><td class="s">require C<search_literal>.</td></tr>
+<tr><td class="h"><a name="620"></a>620</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="621"></a>621</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="622"></a>622</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="623"></a>623</td><td></td><td></td><td></td><td></td><td class="s">sub search_literal {</td></tr>
+<tr><td class="h"><a name="624"></a>624</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $sql, @bind) = @_;</td></tr>
+<tr><td class="h"><a name="625"></a>625</td><td></td><td></td><td></td><td></td><td class="s"> my $attr;</td></tr>
+<tr><td class="h"><a name="626"></a>626</td><td></td><td></td><td></td><td></td><td class="s"> if ( @bind && ref($bind[-1]) eq 'HASH' ) {</td></tr>
+<tr><td class="h"><a name="627"></a>627</td><td></td><td></td><td></td><td></td><td class="s"> $attr = pop @bind;</td></tr>
+<tr><td class="h"><a name="628"></a>628</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="629"></a>629</td><td></td><td></td><td></td><td></td><td class="s"> return $self->search(\[ $sql, map [ __DUMMY__ => $_ ], @bind ], ($attr || () ));</td></tr>
+<tr><td class="h"><a name="630"></a>630</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="631"></a>631</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="632"></a>632</td><td></td><td></td><td></td><td></td><td class="s">=head2 find</td></tr>
+<tr><td class="h"><a name="633"></a>633</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="634"></a>634</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="635"></a>635</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="636"></a>636</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: \%columns_values | @pk_values, \%attrs?</td></tr>
+<tr><td class="h"><a name="637"></a>637</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="638"></a>638</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $row_object | undef</td></tr>
+<tr><td class="h"><a name="639"></a>639</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="640"></a>640</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="641"></a>641</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="642"></a>642</td><td></td><td></td><td></td><td></td><td class="s">Finds and returns a single row based on supplied criteria. Takes either a</td></tr>
+<tr><td class="h"><a name="643"></a>643</td><td></td><td></td><td></td><td></td><td class="s">hashref with the same format as L</create> (including inference of foreign</td></tr>
+<tr><td class="h"><a name="644"></a>644</td><td></td><td></td><td></td><td></td><td class="s">keys from related objects), or a list of primary key values in the same</td></tr>
+<tr><td class="h"><a name="645"></a>645</td><td></td><td></td><td></td><td></td><td class="s">order as the L<primary columns|DBIx::Class::ResultSource/primary_columns></td></tr>
+<tr><td class="h"><a name="646"></a>646</td><td></td><td></td><td></td><td></td><td class="s">declaration on the L</result_source>.</td></tr>
+<tr><td class="h"><a name="647"></a>647</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="648"></a>648</td><td></td><td></td><td></td><td></td><td class="s">In either case an attempt is made to combine conditions already existing on</td></tr>
+<tr><td class="h"><a name="649"></a>649</td><td></td><td></td><td></td><td></td><td class="s">the resultset with the condition passed to this method.</td></tr>
+<tr><td class="h"><a name="650"></a>650</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="651"></a>651</td><td></td><td></td><td></td><td></td><td class="s">To aid with preparing the correct query for the storage you may supply the</td></tr>
+<tr><td class="h"><a name="652"></a>652</td><td></td><td></td><td></td><td></td><td class="s">C<key> attribute, which is the name of a</td></tr>
+<tr><td class="h"><a name="653"></a>653</td><td></td><td></td><td></td><td></td><td class="s">L<unique constraint|DBIx::Class::ResultSource/add_unique_constraint> (the</td></tr>
+<tr><td class="h"><a name="654"></a>654</td><td></td><td></td><td></td><td></td><td class="s">unique constraint corresponding to the</td></tr>
+<tr><td class="h"><a name="655"></a>655</td><td></td><td></td><td></td><td></td><td class="s">L<primary columns|DBIx::Class::ResultSource/primary_columns> is always named</td></tr>
+<tr><td class="h"><a name="656"></a>656</td><td></td><td></td><td></td><td></td><td class="s">C<primary>). If the C<key> attribute has been supplied, and DBIC is unable</td></tr>
+<tr><td class="h"><a name="657"></a>657</td><td></td><td></td><td></td><td></td><td class="s">to construct a query that satisfies the named unique constraint fully (</td></tr>
+<tr><td class="h"><a name="658"></a>658</td><td></td><td></td><td></td><td></td><td class="s">non-NULL values for each column member of the constraint) an exception is</td></tr>
+<tr><td class="h"><a name="659"></a>659</td><td></td><td></td><td></td><td></td><td class="s">thrown.</td></tr>
+<tr><td class="h"><a name="660"></a>660</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="661"></a>661</td><td></td><td></td><td></td><td></td><td class="s">If no C<key> is specified, the search is carried over all unique constraints</td></tr>
+<tr><td class="h"><a name="662"></a>662</td><td></td><td></td><td></td><td></td><td class="s">which are fully defined by the available condition.</td></tr>
+<tr><td class="h"><a name="663"></a>663</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="664"></a>664</td><td></td><td></td><td></td><td></td><td class="s">If no such constraint is found, C<find> currently defaults to a simple</td></tr>
+<tr><td class="h"><a name="665"></a>665</td><td></td><td></td><td></td><td></td><td class="s">C<< search->(\%column_values) >> which may or may not do what you expect.</td></tr>
+<tr><td class="h"><a name="666"></a>666</td><td></td><td></td><td></td><td></td><td class="s">Note that this fallback behavior may be deprecated in further versions. If</td></tr>
+<tr><td class="h"><a name="667"></a>667</td><td></td><td></td><td></td><td></td><td class="s">you need to search with arbitrary conditions - use L</search>. If the query</td></tr>
+<tr><td class="h"><a name="668"></a>668</td><td></td><td></td><td></td><td></td><td class="s">resulting from this fallback produces more than one row, a warning to the</td></tr>
+<tr><td class="h"><a name="669"></a>669</td><td></td><td></td><td></td><td></td><td class="s">effect is issued, though only the first row is constructed and returned as</td></tr>
+<tr><td class="h"><a name="670"></a>670</td><td></td><td></td><td></td><td></td><td class="s">C<$row_object>.</td></tr>
+<tr><td class="h"><a name="671"></a>671</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="672"></a>672</td><td></td><td></td><td></td><td></td><td class="s">In addition to C<key>, L</find> recognizes and applies standard</td></tr>
+<tr><td class="h"><a name="673"></a>673</td><td></td><td></td><td></td><td></td><td class="s">L<resultset attributes|/ATTRIBUTES> in the same way as L</search> does.</td></tr>
+<tr><td class="h"><a name="674"></a>674</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="675"></a>675</td><td></td><td></td><td></td><td></td><td class="s">Note that if you have extra concerns about the correctness of the resulting</td></tr>
+<tr><td class="h"><a name="676"></a>676</td><td></td><td></td><td></td><td></td><td class="s">query you need to specify the C<key> attribute and supply the entire condition</td></tr>
+<tr><td class="h"><a name="677"></a>677</td><td></td><td></td><td></td><td></td><td class="s">as an argument to find (since it is not always possible to perform the</td></tr>
+<tr><td class="h"><a name="678"></a>678</td><td></td><td></td><td></td><td></td><td class="s">combination of the resultset condition with the supplied one, especially if</td></tr>
+<tr><td class="h"><a name="679"></a>679</td><td></td><td></td><td></td><td></td><td class="s">the resultset condition contains literal sql).</td></tr>
+<tr><td class="h"><a name="680"></a>680</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="681"></a>681</td><td></td><td></td><td></td><td></td><td class="s">For example, to find a row by its primary key:</td></tr>
+<tr><td class="h"><a name="682"></a>682</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="683"></a>683</td><td></td><td></td><td></td><td></td><td class="s"> my $cd = $schema->resultset('CD')->find(5);</td></tr>
+<tr><td class="h"><a name="684"></a>684</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="685"></a>685</td><td></td><td></td><td></td><td></td><td class="s">You can also find a row by a specific unique constraint:</td></tr>
+<tr><td class="h"><a name="686"></a>686</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="687"></a>687</td><td></td><td></td><td></td><td></td><td class="s"> my $cd = $schema->resultset('CD')->find(</td></tr>
+<tr><td class="h"><a name="688"></a>688</td><td></td><td></td><td></td><td></td><td class="s"> {</td></tr>
+<tr><td class="h"><a name="689"></a>689</td><td></td><td></td><td></td><td></td><td class="s"> artist => 'Massive Attack',</td></tr>
+<tr><td class="h"><a name="690"></a>690</td><td></td><td></td><td></td><td></td><td class="s"> title => 'Mezzanine',</td></tr>
+<tr><td class="h"><a name="691"></a>691</td><td></td><td></td><td></td><td></td><td class="s"> },</td></tr>
+<tr><td class="h"><a name="692"></a>692</td><td></td><td></td><td></td><td></td><td class="s"> { key => 'cd_artist_title' }</td></tr>
+<tr><td class="h"><a name="693"></a>693</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="694"></a>694</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="695"></a>695</td><td></td><td></td><td></td><td></td><td class="s">See also L</find_or_create> and L</update_or_create>.</td></tr>
+<tr><td class="h"><a name="696"></a>696</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="697"></a>697</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="698"></a>698</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="699"></a>699</td><td></td><td></td><td></td><td></td><td class="s">sub find {</td></tr>
+<tr><td class="h"><a name="700"></a>700</td><td></td><td></td><td></td><td></td><td class="s"> my $self = shift;</td></tr>
+<tr><td class="h"><a name="701"></a>701</td><td></td><td></td><td></td><td></td><td class="s"> my $attrs = (@_ > 1 && ref $_[$#_] eq 'HASH' ? pop(@_) : {});</td></tr>
+<tr><td class="h"><a name="702"></a>702</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="703"></a>703</td><td></td><td></td><td></td><td></td><td class="s"> my $rsrc = $self->result_source;</td></tr>
+<tr><td class="h"><a name="704"></a>704</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="705"></a>705</td><td></td><td></td><td></td><td></td><td class="s"> my $constraint_name;</td></tr>
+<tr><td class="h"><a name="706"></a>706</td><td></td><td></td><td></td><td></td><td class="s"> if (exists $attrs->{key}) {</td></tr>
+<tr><td class="h"><a name="707"></a>707</td><td></td><td></td><td></td><td></td><td class="s"> $constraint_name = defined $attrs->{key}</td></tr>
+<tr><td class="h"><a name="708"></a>708</td><td></td><td></td><td></td><td></td><td class="s"> ? $attrs->{key}</td></tr>
+<tr><td class="h"><a name="709"></a>709</td><td></td><td></td><td></td><td></td><td class="s"> : $self->throw_exception("An undefined 'key' resultset attribute makes no sense")</td></tr>
+<tr><td class="h"><a name="710"></a>710</td><td></td><td></td><td></td><td></td><td class="s"> ;</td></tr>
+<tr><td class="h"><a name="711"></a>711</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="712"></a>712</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="713"></a>713</td><td></td><td></td><td></td><td></td><td class="s"> # Parse out the condition from input</td></tr>
+<tr><td class="h"><a name="714"></a>714</td><td></td><td></td><td></td><td></td><td class="s"> my $call_cond;</td></tr>
+<tr><td class="h"><a name="715"></a>715</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="716"></a>716</td><td></td><td></td><td></td><td></td><td class="s"> if (ref $_[0] eq 'HASH') {</td></tr>
+<tr><td class="h"><a name="717"></a>717</td><td></td><td></td><td></td><td></td><td class="s"> $call_cond = { %{$_[0]} };</td></tr>
+<tr><td class="h"><a name="718"></a>718</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="719"></a>719</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="720"></a>720</td><td></td><td></td><td></td><td></td><td class="s"> # if only values are supplied we need to default to 'primary'</td></tr>
+<tr><td class="h"><a name="721"></a>721</td><td></td><td></td><td></td><td></td><td class="s"> $constraint_name = 'primary' unless defined $constraint_name;</td></tr>
+<tr><td class="h"><a name="722"></a>722</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="723"></a>723</td><td></td><td></td><td></td><td></td><td class="s"> my @c_cols = $rsrc->unique_constraint_columns($constraint_name);</td></tr>
+<tr><td class="h"><a name="724"></a>724</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="725"></a>725</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception(</td></tr>
+<tr><td class="h"><a name="726"></a>726</td><td></td><td></td><td></td><td></td><td class="s"> "No constraint columns, maybe a malformed '$constraint_name' constraint?"</td></tr>
+<tr><td class="h"><a name="727"></a>727</td><td></td><td></td><td></td><td></td><td class="s"> ) unless @c_cols;</td></tr>
+<tr><td class="h"><a name="728"></a>728</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="729"></a>729</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception (</td></tr>
+<tr><td class="h"><a name="730"></a>730</td><td></td><td></td><td></td><td></td><td class="s"> 'find() expects either a column/value hashref, or a list of values '</td></tr>
+<tr><td class="h"><a name="731"></a>731</td><td></td><td></td><td></td><td></td><td class="s"> . "corresponding to the columns of the specified unique constraint '$constraint_name'"</td></tr>
+<tr><td class="h"><a name="732"></a>732</td><td></td><td></td><td></td><td></td><td class="s"> ) unless @c_cols == @_;</td></tr>
+<tr><td class="h"><a name="733"></a>733</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="734"></a>734</td><td></td><td></td><td></td><td></td><td class="s"> $call_cond = {};</td></tr>
+<tr><td class="h"><a name="735"></a>735</td><td></td><td></td><td></td><td></td><td class="s"> @{$call_cond}{@c_cols} = @_;</td></tr>
+<tr><td class="h"><a name="736"></a>736</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="737"></a>737</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="738"></a>738</td><td></td><td></td><td></td><td></td><td class="s"> my %related;</td></tr>
+<tr><td class="h"><a name="739"></a>739</td><td></td><td></td><td></td><td></td><td class="s"> for my $key (keys %$call_cond) {</td></tr>
+<tr><td class="h"><a name="740"></a>740</td><td></td><td></td><td></td><td></td><td class="s"> if (</td></tr>
+<tr><td class="h"><a name="741"></a>741</td><td></td><td></td><td></td><td></td><td class="s"> my $keyref = ref($call_cond->{$key})</td></tr>
+<tr><td class="h"><a name="742"></a>742</td><td></td><td></td><td></td><td></td><td class="s"> and</td></tr>
+<tr><td class="h"><a name="743"></a>743</td><td></td><td></td><td></td><td></td><td class="s"> my $relinfo = $rsrc->relationship_info($key)</td></tr>
+<tr><td class="h"><a name="744"></a>744</td><td></td><td></td><td></td><td></td><td class="s"> ) {</td></tr>
+<tr><td class="h"><a name="745"></a>745</td><td></td><td></td><td></td><td></td><td class="s"> my $val = delete $call_cond->{$key};</td></tr>
+<tr><td class="h"><a name="746"></a>746</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="747"></a>747</td><td></td><td></td><td></td><td></td><td class="s"> next if $keyref eq 'ARRAY'; # has_many for multi_create</td></tr>
+<tr><td class="h"><a name="748"></a>748</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="749"></a>749</td><td></td><td></td><td></td><td></td><td class="s"> my $rel_q = $rsrc->_resolve_condition(</td></tr>
+<tr><td class="h"><a name="750"></a>750</td><td></td><td></td><td></td><td></td><td class="s"> $relinfo->{cond}, $val, $key, $key</td></tr>
+<tr><td class="h"><a name="751"></a>751</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="752"></a>752</td><td></td><td></td><td></td><td></td><td class="s"> die "Can't handle complex relationship conditions in find" if ref($rel_q) ne 'HASH';</td></tr>
+<tr><td class="h"><a name="753"></a>753</td><td></td><td></td><td></td><td></td><td class="s"> @related{keys %$rel_q} = values %$rel_q;</td></tr>
+<tr><td class="h"><a name="754"></a>754</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="755"></a>755</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="756"></a>756</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="757"></a>757</td><td></td><td></td><td></td><td></td><td class="s"> # relationship conditions take precedence (?)</td></tr>
+<tr><td class="h"><a name="758"></a>758</td><td></td><td></td><td></td><td></td><td class="s"> @{$call_cond}{keys %related} = values %related;</td></tr>
+<tr><td class="h"><a name="759"></a>759</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="760"></a>760</td><td></td><td></td><td></td><td></td><td class="s"> my $alias = exists $attrs->{alias} ? $attrs->{alias} : $self->{attrs}{alias};</td></tr>
+<tr><td class="h"><a name="761"></a>761</td><td></td><td></td><td></td><td></td><td class="s"> my $final_cond;</td></tr>
+<tr><td class="h"><a name="762"></a>762</td><td></td><td></td><td></td><td></td><td class="s"> if (defined $constraint_name) {</td></tr>
+<tr><td class="h"><a name="763"></a>763</td><td></td><td></td><td></td><td></td><td class="s"> $final_cond = $self->_qualify_cond_columns (</td></tr>
+<tr><td class="h"><a name="764"></a>764</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="765"></a>765</td><td></td><td></td><td></td><td></td><td class="s"> $self->_build_unique_cond (</td></tr>
+<tr><td class="h"><a name="766"></a>766</td><td></td><td></td><td></td><td></td><td class="s"> $constraint_name,</td></tr>
+<tr><td class="h"><a name="767"></a>767</td><td></td><td></td><td></td><td></td><td class="s"> $call_cond,</td></tr>
+<tr><td class="h"><a name="768"></a>768</td><td></td><td></td><td></td><td></td><td class="s"> ),</td></tr>
+<tr><td class="h"><a name="769"></a>769</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="770"></a>770</td><td></td><td></td><td></td><td></td><td class="s"> $alias,</td></tr>
+<tr><td class="h"><a name="771"></a>771</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="772"></a>772</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="773"></a>773</td><td></td><td></td><td></td><td></td><td class="s"> elsif ($self->{attrs}{accessor} and $self->{attrs}{accessor} eq 'single') {</td></tr>
+<tr><td class="h"><a name="774"></a>774</td><td></td><td></td><td></td><td></td><td class="s"> # This means that we got here after a merger of relationship conditions</td></tr>
+<tr><td class="h"><a name="775"></a>775</td><td></td><td></td><td></td><td></td><td class="s"> # in ::Relationship::Base::search_related (the row method), and furthermore</td></tr>
+<tr><td class="h"><a name="776"></a>776</td><td></td><td></td><td></td><td></td><td class="s"> # the relationship is of the 'single' type. This means that the condition</td></tr>
+<tr><td class="h"><a name="777"></a>777</td><td></td><td></td><td></td><td></td><td class="s"> # provided by the relationship (already attached to $self) is sufficient,</td></tr>
+<tr><td class="h"><a name="778"></a>778</td><td></td><td></td><td></td><td></td><td class="s"> # as there can be only one row in the database that would satisfy the</td></tr>
+<tr><td class="h"><a name="779"></a>779</td><td></td><td></td><td></td><td></td><td class="s"> # relationship</td></tr>
+<tr><td class="h"><a name="780"></a>780</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="781"></a>781</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="782"></a>782</td><td></td><td></td><td></td><td></td><td class="s"> # no key was specified - fall down to heuristics mode:</td></tr>
+<tr><td class="h"><a name="783"></a>783</td><td></td><td></td><td></td><td></td><td class="s"> # run through all unique queries registered on the resultset, and</td></tr>
+<tr><td class="h"><a name="784"></a>784</td><td></td><td></td><td></td><td></td><td class="s"> # 'OR' all qualifying queries together</td></tr>
+<tr><td class="h"><a name="785"></a>785</td><td></td><td></td><td></td><td></td><td class="s"> my (@unique_queries, %seen_column_combinations);</td></tr>
+<tr><td class="h"><a name="786"></a>786</td><td></td><td></td><td></td><td></td><td class="s"> for my $c_name ($rsrc->unique_constraint_names) {</td></tr>
+<tr><td class="h"><a name="787"></a>787</td><td></td><td></td><td></td><td></td><td class="s"> next if $seen_column_combinations{</td></tr>
+<tr><td class="h"><a name="788"></a>788</td><td></td><td></td><td></td><td></td><td class="s"> join "\x00", sort $rsrc->unique_constraint_columns($c_name)</td></tr>
+<tr><td class="h"><a name="789"></a>789</td><td></td><td></td><td></td><td></td><td class="s"> }++;</td></tr>
+<tr><td class="h"><a name="790"></a>790</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="791"></a>791</td><td></td><td></td><td></td><td></td><td class="s"> push @unique_queries, try {</td></tr>
+<tr><td class="h"><a name="792"></a>792</td><td></td><td></td><td></td><td></td><td class="s"> $self->_build_unique_cond ($c_name, $call_cond, 'croak_on_nulls')</td></tr>
+<tr><td class="h"><a name="793"></a>793</td><td></td><td></td><td></td><td></td><td class="s"> } || ();</td></tr>
+<tr><td class="h"><a name="794"></a>794</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="795"></a>795</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="796"></a>796</td><td></td><td></td><td></td><td></td><td class="s"> $final_cond = @unique_queries</td></tr>
+<tr><td class="h"><a name="797"></a>797</td><td></td><td></td><td></td><td></td><td class="s"> ? [ map { $self->_qualify_cond_columns($_, $alias) } @unique_queries ]</td></tr>
+<tr><td class="h"><a name="798"></a>798</td><td></td><td></td><td></td><td></td><td class="s"> : $self->_non_unique_find_fallback ($call_cond, $attrs)</td></tr>
+<tr><td class="h"><a name="799"></a>799</td><td></td><td></td><td></td><td></td><td class="s"> ;</td></tr>
+<tr><td class="h"><a name="800"></a>800</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="801"></a>801</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="802"></a>802</td><td></td><td></td><td></td><td></td><td class="s"> # Run the query, passing the result_class since it should propagate for find</td></tr>
+<tr><td class="h"><a name="803"></a>803</td><td></td><td></td><td></td><td></td><td class="s"> my $rs = $self->search ($final_cond, {result_class => $self->result_class, %$attrs});</td></tr>
+<tr><td class="h"><a name="804"></a>804</td><td></td><td></td><td></td><td></td><td class="s"> if (keys %{$rs->_resolved_attrs->{collapse}}) {</td></tr>
+<tr><td class="h"><a name="805"></a>805</td><td></td><td></td><td></td><td></td><td class="s"> my $row = $rs->next;</td></tr>
+<tr><td class="h"><a name="806"></a>806</td><td></td><td></td><td></td><td></td><td class="s"> carp "Query returned more than one row" if $rs->next;</td></tr>
+<tr><td class="h"><a name="807"></a>807</td><td></td><td></td><td></td><td></td><td class="s"> return $row;</td></tr>
+<tr><td class="h"><a name="808"></a>808</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="809"></a>809</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="810"></a>810</td><td></td><td></td><td></td><td></td><td class="s"> return $rs->single;</td></tr>
+<tr><td class="h"><a name="811"></a>811</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="812"></a>812</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="813"></a>813</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="814"></a>814</td><td></td><td></td><td></td><td></td><td class="s"># This is a stop-gap method as agreed during the discussion on find() cleanup:</td></tr>
+<tr><td class="h"><a name="815"></a>815</td><td></td><td></td><td></td><td></td><td class="s"># http://lists.scsys.co.uk/pipermail/dbix-class/2010-October/009535.html</td></tr>
+<tr><td class="h"><a name="816"></a>816</td><td></td><td></td><td></td><td></td><td class="s">#</td></tr>
+<tr><td class="h"><a name="817"></a>817</td><td></td><td></td><td></td><td></td><td class="s"># It is invoked when find() is called in legacy-mode with insufficiently-unique</td></tr>
+<tr><td class="h"><a name="818"></a>818</td><td></td><td></td><td></td><td></td><td class="s"># condition. It is provided for overrides until a saner way forward is devised</td></tr>
+<tr><td class="h"><a name="819"></a>819</td><td></td><td></td><td></td><td></td><td class="s">#</td></tr>
+<tr><td class="h"><a name="820"></a>820</td><td></td><td></td><td></td><td></td><td class="s"># *NOTE* This is not a public method, and it's *GUARANTEED* to disappear down</td></tr>
+<tr><td class="h"><a name="821"></a>821</td><td></td><td></td><td></td><td></td><td class="s"># the road. Please adjust your tests accordingly to catch this situation early</td></tr>
+<tr><td class="h"><a name="822"></a>822</td><td></td><td></td><td></td><td></td><td class="s"># DBIx::Class::ResultSet->can('_non_unique_find_fallback') is reasonable</td></tr>
+<tr><td class="h"><a name="823"></a>823</td><td></td><td></td><td></td><td></td><td class="s">#</td></tr>
+<tr><td class="h"><a name="824"></a>824</td><td></td><td></td><td></td><td></td><td class="s"># The method will not be removed without an adequately complete replacement</td></tr>
+<tr><td class="h"><a name="825"></a>825</td><td></td><td></td><td></td><td></td><td class="s"># for strict-mode enforcement</td></tr>
+<tr><td class="h"><a name="826"></a>826</td><td></td><td></td><td></td><td></td><td class="s">sub _non_unique_find_fallback {</td></tr>
+<tr><td class="h"><a name="827"></a>827</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $cond, $attrs) = @_;</td></tr>
+<tr><td class="h"><a name="828"></a>828</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="829"></a>829</td><td></td><td></td><td></td><td></td><td class="s"> return $self->_qualify_cond_columns(</td></tr>
+<tr><td class="h"><a name="830"></a>830</td><td></td><td></td><td></td><td></td><td class="s"> $cond,</td></tr>
+<tr><td class="h"><a name="831"></a>831</td><td></td><td></td><td></td><td></td><td class="s"> exists $attrs->{alias}</td></tr>
+<tr><td class="h"><a name="832"></a>832</td><td></td><td></td><td></td><td></td><td class="s"> ? $attrs->{alias}</td></tr>
+<tr><td class="h"><a name="833"></a>833</td><td></td><td></td><td></td><td></td><td class="s"> : $self->{attrs}{alias}</td></tr>
+<tr><td class="h"><a name="834"></a>834</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="835"></a>835</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="836"></a>836</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="837"></a>837</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="838"></a>838</td><td></td><td></td><td></td><td></td><td class="s">sub _qualify_cond_columns {</td></tr>
+<tr><td class="h"><a name="839"></a>839</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $cond, $alias) = @_;</td></tr>
+<tr><td class="h"><a name="840"></a>840</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="841"></a>841</td><td></td><td></td><td></td><td></td><td class="s"> my %aliased = %$cond;</td></tr>
+<tr><td class="h"><a name="842"></a>842</td><td></td><td></td><td></td><td></td><td class="s"> for (keys %aliased) {</td></tr>
+<tr><td class="h"><a name="843"></a>843</td><td></td><td></td><td></td><td></td><td class="s"> $aliased{"$alias.$_"} = delete $aliased{$_}</td></tr>
+<tr><td class="h"><a name="844"></a>844</td><td></td><td></td><td></td><td></td><td class="s"> if $_ !~ /\./;</td></tr>
+<tr><td class="h"><a name="845"></a>845</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="846"></a>846</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="847"></a>847</td><td></td><td></td><td></td><td></td><td class="s"> return \%aliased;</td></tr>
+<tr><td class="h"><a name="848"></a>848</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="849"></a>849</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="850"></a>850</td><td></td><td></td><td></td><td></td><td class="s">sub _build_unique_cond {</td></tr>
+<tr><td class="h"><a name="851"></a>851</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $constraint_name, $extra_cond, $croak_on_null) = @_;</td></tr>
+<tr><td class="h"><a name="852"></a>852</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="853"></a>853</td><td></td><td></td><td></td><td></td><td class="s"> my @c_cols = $self->result_source->unique_constraint_columns($constraint_name);</td></tr>
+<tr><td class="h"><a name="854"></a>854</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="855"></a>855</td><td></td><td></td><td></td><td></td><td class="s"> # combination may fail if $self->{cond} is non-trivial</td></tr>
+<tr><td class="h"><a name="856"></a>856</td><td></td><td></td><td></td><td></td><td class="s"> my ($final_cond) = try {</td></tr>
+<tr><td class="h"><a name="857"></a>857</td><td></td><td></td><td></td><td></td><td class="s"> $self->_merge_with_rscond ($extra_cond)</td></tr>
+<tr><td class="h"><a name="858"></a>858</td><td></td><td></td><td></td><td></td><td class="s"> } catch {</td></tr>
+<tr><td class="h"><a name="859"></a>859</td><td></td><td></td><td></td><td></td><td class="s"> +{ %$extra_cond }</td></tr>
+<tr><td class="h"><a name="860"></a>860</td><td></td><td></td><td></td><td></td><td class="s"> };</td></tr>
+<tr><td class="h"><a name="861"></a>861</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="862"></a>862</td><td></td><td></td><td></td><td></td><td class="s"> # trim out everything not in $columns</td></tr>
+<tr><td class="h"><a name="863"></a>863</td><td></td><td></td><td></td><td></td><td class="s"> $final_cond = { map {</td></tr>
+<tr><td class="h"><a name="864"></a>864</td><td></td><td></td><td></td><td></td><td class="s"> exists $final_cond->{$_}</td></tr>
+<tr><td class="h"><a name="865"></a>865</td><td></td><td></td><td></td><td></td><td class="s"> ? ( $_ => $final_cond->{$_} )</td></tr>
+<tr><td class="h"><a name="866"></a>866</td><td></td><td></td><td></td><td></td><td class="s"> : ()</td></tr>
+<tr><td class="h"><a name="867"></a>867</td><td></td><td></td><td></td><td></td><td class="s"> } @c_cols };</td></tr>
+<tr><td class="h"><a name="868"></a>868</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="869"></a>869</td><td></td><td></td><td></td><td></td><td class="s"> if (my @missing = grep</td></tr>
+<tr><td class="h"><a name="870"></a>870</td><td></td><td></td><td></td><td></td><td class="s"> { ! ($croak_on_null ? defined $final_cond->{$_} : exists $final_cond->{$_}) }</td></tr>
+<tr><td class="h"><a name="871"></a>871</td><td></td><td></td><td></td><td></td><td class="s"> (@c_cols)</td></tr>
+<tr><td class="h"><a name="872"></a>872</td><td></td><td></td><td></td><td></td><td class="s"> ) {</td></tr>
+<tr><td class="h"><a name="873"></a>873</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception( sprintf ( "Unable to satisfy requested constraint '%s', no values for column(s): %s",</td></tr>
+<tr><td class="h"><a name="874"></a>874</td><td></td><td></td><td></td><td></td><td class="s"> $constraint_name,</td></tr>
+<tr><td class="h"><a name="875"></a>875</td><td></td><td></td><td></td><td></td><td class="s"> join (', ', map { "'$_'" } @missing),</td></tr>
+<tr><td class="h"><a name="876"></a>876</td><td></td><td></td><td></td><td></td><td class="s"> ) );</td></tr>
+<tr><td class="h"><a name="877"></a>877</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="878"></a>878</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="879"></a>879</td><td></td><td></td><td></td><td></td><td class="s"> if (</td></tr>
+<tr><td class="h"><a name="880"></a>880</td><td></td><td></td><td></td><td></td><td class="s"> !$croak_on_null</td></tr>
+<tr><td class="h"><a name="881"></a>881</td><td></td><td></td><td></td><td></td><td class="s"> and</td></tr>
+<tr><td class="h"><a name="882"></a>882</td><td></td><td></td><td></td><td></td><td class="s"> !$ENV{DBIC_NULLABLE_KEY_NOWARN}</td></tr>
+<tr><td class="h"><a name="883"></a>883</td><td></td><td></td><td></td><td></td><td class="s"> and</td></tr>
+<tr><td class="h"><a name="884"></a>884</td><td></td><td></td><td></td><td></td><td class="s"> my @undefs = grep { ! defined $final_cond->{$_} } (keys %$final_cond)</td></tr>
+<tr><td class="h"><a name="885"></a>885</td><td></td><td></td><td></td><td></td><td class="s"> ) {</td></tr>
+<tr><td class="h"><a name="886"></a>886</td><td></td><td></td><td></td><td></td><td class="s"> carp_unique ( sprintf (</td></tr>
+<tr><td class="h"><a name="887"></a>887</td><td></td><td></td><td></td><td></td><td class="s"> "NULL/undef values supplied for requested unique constraint '%s' (NULL "</td></tr>
+<tr><td class="h"><a name="888"></a>888</td><td></td><td></td><td></td><td></td><td class="s"> . 'values in column(s): %s). This is almost certainly not what you wanted, '</td></tr>
+<tr><td class="h"><a name="889"></a>889</td><td></td><td></td><td></td><td></td><td class="s"> . 'though you can set DBIC_NULLABLE_KEY_NOWARN to disable this warning.',</td></tr>
+<tr><td class="h"><a name="890"></a>890</td><td></td><td></td><td></td><td></td><td class="s"> $constraint_name,</td></tr>
+<tr><td class="h"><a name="891"></a>891</td><td></td><td></td><td></td><td></td><td class="s"> join (', ', map { "'$_'" } @undefs),</td></tr>
+<tr><td class="h"><a name="892"></a>892</td><td></td><td></td><td></td><td></td><td class="s"> ));</td></tr>
+<tr><td class="h"><a name="893"></a>893</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="894"></a>894</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="895"></a>895</td><td></td><td></td><td></td><td></td><td class="s"> return $final_cond;</td></tr>
+<tr><td class="h"><a name="896"></a>896</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="897"></a>897</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="898"></a>898</td><td></td><td></td><td></td><td></td><td class="s">=head2 search_related</td></tr>
+<tr><td class="h"><a name="899"></a>899</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="900"></a>900</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="901"></a>901</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="902"></a>902</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: $rel, $cond, \%attrs?</td></tr>
+<tr><td class="h"><a name="903"></a>903</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="904"></a>904</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $new_resultset (scalar context) || @row_objs (list context)</td></tr>
+<tr><td class="h"><a name="905"></a>905</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="906"></a>906</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="907"></a>907</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="908"></a>908</td><td></td><td></td><td></td><td></td><td class="s"> $new_rs = $cd_rs->search_related('artist', {</td></tr>
+<tr><td class="h"><a name="909"></a>909</td><td></td><td></td><td></td><td></td><td class="s"> name => 'Emo-R-Us',</td></tr>
+<tr><td class="h"><a name="910"></a>910</td><td></td><td></td><td></td><td></td><td class="s"> });</td></tr>
+<tr><td class="h"><a name="911"></a>911</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="912"></a>912</td><td></td><td></td><td></td><td></td><td class="s">Searches the specified relationship, optionally specifying a condition and</td></tr>
+<tr><td class="h"><a name="913"></a>913</td><td></td><td></td><td></td><td></td><td class="s">attributes for matching records. See L</ATTRIBUTES> for more information.</td></tr>
+<tr><td class="h"><a name="914"></a>914</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="915"></a>915</td><td></td><td></td><td></td><td></td><td class="s">In list context, C<< ->all() >> is called implicitly on the resultset, thus</td></tr>
+<tr><td class="h"><a name="916"></a>916</td><td></td><td></td><td></td><td></td><td class="s">returning a list of row objects instead. To avoid that, use L</search_related_rs>.</td></tr>
+<tr><td class="h"><a name="917"></a>917</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="918"></a>918</td><td></td><td></td><td></td><td></td><td class="s">See also L</search_related_rs>.</td></tr>
+<tr><td class="h"><a name="919"></a>919</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="920"></a>920</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="921"></a>921</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="922"></a>922</td><td></td><td></td><td></td><td></td><td class="s">sub search_related {</td></tr>
+<tr><td class="h"><a name="923"></a>923</td><td></td><td></td><td></td><td></td><td class="s"> return shift->related_resultset(shift)->search(@_);</td></tr>
+<tr><td class="h"><a name="924"></a>924</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="925"></a>925</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="926"></a>926</td><td></td><td></td><td></td><td></td><td class="s">=head2 search_related_rs</td></tr>
+<tr><td class="h"><a name="927"></a>927</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="928"></a>928</td><td></td><td></td><td></td><td></td><td class="s">This method works exactly the same as search_related, except that</td></tr>
+<tr><td class="h"><a name="929"></a>929</td><td></td><td></td><td></td><td></td><td class="s">it guarantees a resultset, even in list context.</td></tr>
+<tr><td class="h"><a name="930"></a>930</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="931"></a>931</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="932"></a>932</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="933"></a>933</td><td></td><td></td><td></td><td></td><td class="s">sub search_related_rs {</td></tr>
+<tr><td class="h"><a name="934"></a>934</td><td></td><td></td><td></td><td></td><td class="s"> return shift->related_resultset(shift)->search_rs(@_);</td></tr>
+<tr><td class="h"><a name="935"></a>935</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="936"></a>936</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="937"></a>937</td><td></td><td></td><td></td><td></td><td class="s">=head2 cursor</td></tr>
+<tr><td class="h"><a name="938"></a>938</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="939"></a>939</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="940"></a>940</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="941"></a>941</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: none</td></tr>
+<tr><td class="h"><a name="942"></a>942</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="943"></a>943</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $cursor</td></tr>
+<tr><td class="h"><a name="944"></a>944</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="945"></a>945</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="946"></a>946</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="947"></a>947</td><td></td><td></td><td></td><td></td><td class="s">Returns a storage-driven cursor to the given resultset. See</td></tr>
+<tr><td class="h"><a name="948"></a>948</td><td></td><td></td><td></td><td></td><td class="s">L<DBIx::Class::Cursor> for more information.</td></tr>
+<tr><td class="h"><a name="949"></a>949</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="950"></a>950</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="951"></a>951</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="952"></a>952</td><td></td><td></td><td></td><td></td><td class="s">sub cursor {</td></tr>
+<tr><td class="h"><a name="953"></a>953</td><td></td><td></td><td></td><td></td><td class="s"> my ($self) = @_;</td></tr>
+<tr><td class="h"><a name="954"></a>954</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="955"></a>955</td><td></td><td></td><td></td><td></td><td class="s"> my $attrs = $self->_resolved_attrs_copy;</td></tr>
+<tr><td class="h"><a name="956"></a>956</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="957"></a>957</td><td></td><td></td><td></td><td></td><td class="s"> return $self->{cursor}</td></tr>
+<tr><td class="h"><a name="958"></a>958</td><td></td><td></td><td></td><td></td><td class="s"> ||= $self->result_source->storage->select($attrs->{from}, $attrs->{select},</td></tr>
+<tr><td class="h"><a name="959"></a>959</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{where},$attrs);</td></tr>
+<tr><td class="h"><a name="960"></a>960</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="961"></a>961</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="962"></a>962</td><td></td><td></td><td></td><td></td><td class="s">=head2 single</td></tr>
+<tr><td class="h"><a name="963"></a>963</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="964"></a>964</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="965"></a>965</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="966"></a>966</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: $cond?</td></tr>
+<tr><td class="h"><a name="967"></a>967</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="968"></a>968</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $row_object | undef</td></tr>
+<tr><td class="h"><a name="969"></a>969</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="970"></a>970</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="971"></a>971</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="972"></a>972</td><td></td><td></td><td></td><td></td><td class="s"> my $cd = $schema->resultset('CD')->single({ year => 2001 });</td></tr>
+<tr><td class="h"><a name="973"></a>973</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="974"></a>974</td><td></td><td></td><td></td><td></td><td class="s">Inflates the first result without creating a cursor if the resultset has</td></tr>
+<tr><td class="h"><a name="975"></a>975</td><td></td><td></td><td></td><td></td><td class="s">any records in it; if not returns C<undef>. Used by L</find> as a lean version</td></tr>
+<tr><td class="h"><a name="976"></a>976</td><td></td><td></td><td></td><td></td><td class="s">of L</search>.</td></tr>
+<tr><td class="h"><a name="977"></a>977</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="978"></a>978</td><td></td><td></td><td></td><td></td><td class="s">While this method can take an optional search condition (just like L</search>)</td></tr>
+<tr><td class="h"><a name="979"></a>979</td><td></td><td></td><td></td><td></td><td class="s">being a fast-code-path it does not recognize search attributes. If you need to</td></tr>
+<tr><td class="h"><a name="980"></a>980</td><td></td><td></td><td></td><td></td><td class="s">add extra joins or similar, call L</search> and then chain-call L</single> on the</td></tr>
+<tr><td class="h"><a name="981"></a>981</td><td></td><td></td><td></td><td></td><td class="s">L<DBIx::Class::ResultSet> returned.</td></tr>
+<tr><td class="h"><a name="982"></a>982</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="983"></a>983</td><td></td><td></td><td></td><td></td><td class="s">=over</td></tr>
+<tr><td class="h"><a name="984"></a>984</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="985"></a>985</td><td></td><td></td><td></td><td></td><td class="s">=item B<Note></td></tr>
+<tr><td class="h"><a name="986"></a>986</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="987"></a>987</td><td></td><td></td><td></td><td></td><td class="s">As of 0.08100, this method enforces the assumption that the preceding</td></tr>
+<tr><td class="h"><a name="988"></a>988</td><td></td><td></td><td></td><td></td><td class="s">query returns only one row. If more than one row is returned, you will receive</td></tr>
+<tr><td class="h"><a name="989"></a>989</td><td></td><td></td><td></td><td></td><td class="s">a warning:</td></tr>
+<tr><td class="h"><a name="990"></a>990</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="991"></a>991</td><td></td><td></td><td></td><td></td><td class="s"> Query returned more than one row</td></tr>
+<tr><td class="h"><a name="992"></a>992</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="993"></a>993</td><td></td><td></td><td></td><td></td><td class="s">In this case, you should be using L</next> or L</find> instead, or if you really</td></tr>
+<tr><td class="h"><a name="994"></a>994</td><td></td><td></td><td></td><td></td><td class="s">know what you are doing, use the L</rows> attribute to explicitly limit the size</td></tr>
+<tr><td class="h"><a name="995"></a>995</td><td></td><td></td><td></td><td></td><td class="s">of the resultset.</td></tr>
+<tr><td class="h"><a name="996"></a>996</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="997"></a>997</td><td></td><td></td><td></td><td></td><td class="s">This method will also throw an exception if it is called on a resultset prefetching</td></tr>
+<tr><td class="h"><a name="998"></a>998</td><td></td><td></td><td></td><td></td><td class="s">has_many, as such a prefetch implies fetching multiple rows from the database in</td></tr>
+<tr><td class="h"><a name="999"></a>999</td><td></td><td></td><td></td><td></td><td class="s">order to assemble the resulting object.</td></tr>
+<tr><td class="h"><a name="1000"></a>1000</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1001"></a>1001</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="1002"></a>1002</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1003"></a>1003</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="1004"></a>1004</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1005"></a>1005</td><td></td><td></td><td></td><td></td><td class="s">sub single {</td></tr>
+<tr><td class="h"><a name="1006"></a>1006</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $where) = @_;</td></tr>
+<tr><td class="h"><a name="1007"></a>1007</td><td></td><td></td><td></td><td></td><td class="s"> if(@_ > 2) {</td></tr>
+<tr><td class="h"><a name="1008"></a>1008</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception('single() only takes search conditions, no attributes. You want ->search( $cond, $attrs )->single()');</td></tr>
+<tr><td class="h"><a name="1009"></a>1009</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1010"></a>1010</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1011"></a>1011</td><td></td><td></td><td></td><td></td><td class="s"> my $attrs = $self->_resolved_attrs_copy;</td></tr>
+<tr><td class="h"><a name="1012"></a>1012</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1013"></a>1013</td><td></td><td></td><td></td><td></td><td class="s"> if (keys %{$attrs->{collapse}}) {</td></tr>
+<tr><td class="h"><a name="1014"></a>1014</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception(</td></tr>
+<tr><td class="h"><a name="1015"></a>1015</td><td></td><td></td><td></td><td></td><td class="s"> 'single() can not be used on resultsets prefetching has_many. Use find( \%cond ) or next() instead'</td></tr>
+<tr><td class="h"><a name="1016"></a>1016</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="1017"></a>1017</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1018"></a>1018</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1019"></a>1019</td><td></td><td></td><td></td><td></td><td class="s"> if ($where) {</td></tr>
+<tr><td class="h"><a name="1020"></a>1020</td><td></td><td></td><td></td><td></td><td class="s"> if (defined $attrs->{where}) {</td></tr>
+<tr><td class="h"><a name="1021"></a>1021</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{where} = {</td></tr>
+<tr><td class="h"><a name="1022"></a>1022</td><td></td><td></td><td></td><td></td><td class="s"> '-and' =></td></tr>
+<tr><td class="h"><a name="1023"></a>1023</td><td></td><td></td><td></td><td></td><td class="s"> [ map { ref $_ eq 'ARRAY' ? [ -or => $_ ] : $_ }</td></tr>
+<tr><td class="h"><a name="1024"></a>1024</td><td></td><td></td><td></td><td></td><td class="s"> $where, delete $attrs->{where} ]</td></tr>
+<tr><td class="h"><a name="1025"></a>1025</td><td></td><td></td><td></td><td></td><td class="s"> };</td></tr>
+<tr><td class="h"><a name="1026"></a>1026</td><td></td><td></td><td></td><td></td><td class="s"> } else {</td></tr>
+<tr><td class="h"><a name="1027"></a>1027</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{where} = $where;</td></tr>
+<tr><td class="h"><a name="1028"></a>1028</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1029"></a>1029</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1030"></a>1030</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1031"></a>1031</td><td></td><td></td><td></td><td></td><td class="s"> my @data = $self->result_source->storage->select_single(</td></tr>
+<tr><td class="h"><a name="1032"></a>1032</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{from}, $attrs->{select},</td></tr>
+<tr><td class="h"><a name="1033"></a>1033</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{where}, $attrs</td></tr>
+<tr><td class="h"><a name="1034"></a>1034</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="1035"></a>1035</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1036"></a>1036</td><td></td><td></td><td></td><td></td><td class="s"> return (@data ? ($self->_construct_object(@data))[0] : undef);</td></tr>
+<tr><td class="h"><a name="1037"></a>1037</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="1038"></a>1038</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1039"></a>1039</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1040"></a>1040</td><td></td><td></td><td></td><td></td><td class="s"># _collapse_query</td></tr>
+<tr><td class="h"><a name="1041"></a>1041</td><td></td><td></td><td></td><td></td><td class="s">#</td></tr>
+<tr><td class="h"><a name="1042"></a>1042</td><td></td><td></td><td></td><td></td><td class="s"># Recursively collapse the query, accumulating values for each column.</td></tr>
+<tr><td class="h"><a name="1043"></a>1043</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1044"></a>1044</td><td></td><td></td><td></td><td></td><td class="s">sub _collapse_query {</td></tr>
+<tr><td class="h"><a name="1045"></a>1045</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $query, $collapsed) = @_;</td></tr>
+<tr><td class="h"><a name="1046"></a>1046</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1047"></a>1047</td><td></td><td></td><td></td><td></td><td class="s"> $collapsed ||= {};</td></tr>
+<tr><td class="h"><a name="1048"></a>1048</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1049"></a>1049</td><td></td><td></td><td></td><td></td><td class="s"> if (ref $query eq 'ARRAY') {</td></tr>
+<tr><td class="h"><a name="1050"></a>1050</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $subquery (@$query) {</td></tr>
+<tr><td class="h"><a name="1051"></a>1051</td><td></td><td></td><td></td><td></td><td class="s"> next unless ref $subquery; # -or</td></tr>
+<tr><td class="h"><a name="1052"></a>1052</td><td></td><td></td><td></td><td></td><td class="s"> $collapsed = $self->_collapse_query($subquery, $collapsed);</td></tr>
+<tr><td class="h"><a name="1053"></a>1053</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1054"></a>1054</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1055"></a>1055</td><td></td><td></td><td></td><td></td><td class="s"> elsif (ref $query eq 'HASH') {</td></tr>
+<tr><td class="h"><a name="1056"></a>1056</td><td></td><td></td><td></td><td></td><td class="s"> if (keys %$query and (keys %$query)[0] eq '-and') {</td></tr>
+<tr><td class="h"><a name="1057"></a>1057</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $subquery (@{$query->{-and}}) {</td></tr>
+<tr><td class="h"><a name="1058"></a>1058</td><td></td><td></td><td></td><td></td><td class="s"> $collapsed = $self->_collapse_query($subquery, $collapsed);</td></tr>
+<tr><td class="h"><a name="1059"></a>1059</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1060"></a>1060</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1061"></a>1061</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="1062"></a>1062</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $col (keys %$query) {</td></tr>
+<tr><td class="h"><a name="1063"></a>1063</td><td></td><td></td><td></td><td></td><td class="s"> my $value = $query->{$col};</td></tr>
+<tr><td class="h"><a name="1064"></a>1064</td><td></td><td></td><td></td><td></td><td class="s"> $collapsed->{$col}{$value}++;</td></tr>
+<tr><td class="h"><a name="1065"></a>1065</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1066"></a>1066</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1067"></a>1067</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1068"></a>1068</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1069"></a>1069</td><td></td><td></td><td></td><td></td><td class="s"> return $collapsed;</td></tr>
+<tr><td class="h"><a name="1070"></a>1070</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="1071"></a>1071</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1072"></a>1072</td><td></td><td></td><td></td><td></td><td class="s">=head2 get_column</td></tr>
+<tr><td class="h"><a name="1073"></a>1073</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1074"></a>1074</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="1075"></a>1075</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1076"></a>1076</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: $cond?</td></tr>
+<tr><td class="h"><a name="1077"></a>1077</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1078"></a>1078</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $resultsetcolumn</td></tr>
+<tr><td class="h"><a name="1079"></a>1079</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1080"></a>1080</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="1081"></a>1081</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1082"></a>1082</td><td></td><td></td><td></td><td></td><td class="s"> my $max_length = $rs->get_column('length')->max;</td></tr>
+<tr><td class="h"><a name="1083"></a>1083</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1084"></a>1084</td><td></td><td></td><td></td><td></td><td class="s">Returns a L<DBIx::Class::ResultSetColumn> instance for a column of the ResultSet.</td></tr>
+<tr><td class="h"><a name="1085"></a>1085</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1086"></a>1086</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="1087"></a>1087</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1088"></a>1088</td><td></td><td></td><td></td><td></td><td class="s">sub get_column {</td></tr>
+<tr><td class="h"><a name="1089"></a>1089</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $column) = @_;</td></tr>
+<tr><td class="h"><a name="1090"></a>1090</td><td></td><td></td><td></td><td></td><td class="s"> my $new = DBIx::Class::ResultSetColumn->new($self, $column);</td></tr>
+<tr><td class="h"><a name="1091"></a>1091</td><td></td><td></td><td></td><td></td><td class="s"> return $new;</td></tr>
+<tr><td class="h"><a name="1092"></a>1092</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="1093"></a>1093</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1094"></a>1094</td><td></td><td></td><td></td><td></td><td class="s">=head2 search_like</td></tr>
+<tr><td class="h"><a name="1095"></a>1095</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1096"></a>1096</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="1097"></a>1097</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1098"></a>1098</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: $cond, \%attrs?</td></tr>
+<tr><td class="h"><a name="1099"></a>1099</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1100"></a>1100</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $resultset (scalar context) || @row_objs (list context)</td></tr>
+<tr><td class="h"><a name="1101"></a>1101</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1102"></a>1102</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="1103"></a>1103</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1104"></a>1104</td><td></td><td></td><td></td><td></td><td class="s"> # WHERE title LIKE '%blue%'</td></tr>
+<tr><td class="h"><a name="1105"></a>1105</td><td></td><td></td><td></td><td></td><td class="s"> $cd_rs = $rs->search_like({ title => '%blue%'});</td></tr>
+<tr><td class="h"><a name="1106"></a>1106</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1107"></a>1107</td><td></td><td></td><td></td><td></td><td class="s">Performs a search, but uses C<LIKE> instead of C<=> as the condition. Note</td></tr>
+<tr><td class="h"><a name="1108"></a>1108</td><td></td><td></td><td></td><td></td><td class="s">that this is simply a convenience method retained for ex Class::DBI users.</td></tr>
+<tr><td class="h"><a name="1109"></a>1109</td><td></td><td></td><td></td><td></td><td class="s">You most likely want to use L</search> with specific operators.</td></tr>
+<tr><td class="h"><a name="1110"></a>1110</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1111"></a>1111</td><td></td><td></td><td></td><td></td><td class="s">For more information, see L<DBIx::Class::Manual::Cookbook>.</td></tr>
+<tr><td class="h"><a name="1112"></a>1112</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1113"></a>1113</td><td></td><td></td><td></td><td></td><td class="s">This method is deprecated and will be removed in 0.09. Use L</search()></td></tr>
+<tr><td class="h"><a name="1114"></a>1114</td><td></td><td></td><td></td><td></td><td class="s">instead. An example conversion is:</td></tr>
+<tr><td class="h"><a name="1115"></a>1115</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1116"></a>1116</td><td></td><td></td><td></td><td></td><td class="s"> ->search_like({ foo => 'bar' });</td></tr>
+<tr><td class="h"><a name="1117"></a>1117</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1118"></a>1118</td><td></td><td></td><td></td><td></td><td class="s"> # Becomes</td></tr>
+<tr><td class="h"><a name="1119"></a>1119</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1120"></a>1120</td><td></td><td></td><td></td><td></td><td class="s"> ->search({ foo => { like => 'bar' } });</td></tr>
+<tr><td class="h"><a name="1121"></a>1121</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1122"></a>1122</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="1123"></a>1123</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1124"></a>1124</td><td></td><td></td><td></td><td></td><td class="s">sub search_like {</td></tr>
+<tr><td class="h"><a name="1125"></a>1125</td><td></td><td></td><td></td><td></td><td class="s"> my $class = shift;</td></tr>
+<tr><td class="h"><a name="1126"></a>1126</td><td></td><td></td><td></td><td></td><td class="s"> carp_unique (</td></tr>
+<tr><td class="h"><a name="1127"></a>1127</td><td></td><td></td><td></td><td></td><td class="s"> 'search_like() is deprecated and will be removed in DBIC version 0.09.'</td></tr>
+<tr><td class="h"><a name="1128"></a>1128</td><td></td><td></td><td></td><td></td><td class="s"> .' Instead use ->search({ x => { -like => "y%" } })'</td></tr>
+<tr><td class="h"><a name="1129"></a>1129</td><td></td><td></td><td></td><td></td><td class="s"> .' (note the outer pair of {}s - they are important!)'</td></tr>
+<tr><td class="h"><a name="1130"></a>1130</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="1131"></a>1131</td><td></td><td></td><td></td><td></td><td class="s"> my $attrs = (@_ > 1 && ref $_[$#_] eq 'HASH' ? pop(@_) : {});</td></tr>
+<tr><td class="h"><a name="1132"></a>1132</td><td></td><td></td><td></td><td></td><td class="s"> my $query = ref $_[0] eq 'HASH' ? { %{shift()} }: {@_};</td></tr>
+<tr><td class="h"><a name="1133"></a>1133</td><td></td><td></td><td></td><td></td><td class="s"> $query->{$_} = { 'like' => $query->{$_} } for keys %$query;</td></tr>
+<tr><td class="h"><a name="1134"></a>1134</td><td></td><td></td><td></td><td></td><td class="s"> return $class->search($query, { %$attrs });</td></tr>
+<tr><td class="h"><a name="1135"></a>1135</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="1136"></a>1136</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1137"></a>1137</td><td></td><td></td><td></td><td></td><td class="s">=head2 slice</td></tr>
+<tr><td class="h"><a name="1138"></a>1138</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1139"></a>1139</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="1140"></a>1140</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1141"></a>1141</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: $first, $last</td></tr>
+<tr><td class="h"><a name="1142"></a>1142</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1143"></a>1143</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $resultset (scalar context) || @row_objs (list context)</td></tr>
+<tr><td class="h"><a name="1144"></a>1144</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1145"></a>1145</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="1146"></a>1146</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1147"></a>1147</td><td></td><td></td><td></td><td></td><td class="s">Returns a resultset or object list representing a subset of elements from the</td></tr>
+<tr><td class="h"><a name="1148"></a>1148</td><td></td><td></td><td></td><td></td><td class="s">resultset slice is called on. Indexes are from 0, i.e., to get the first</td></tr>
+<tr><td class="h"><a name="1149"></a>1149</td><td></td><td></td><td></td><td></td><td class="s">three records, call:</td></tr>
+<tr><td class="h"><a name="1150"></a>1150</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1151"></a>1151</td><td></td><td></td><td></td><td></td><td class="s"> my ($one, $two, $three) = $rs->slice(0, 2);</td></tr>
+<tr><td class="h"><a name="1152"></a>1152</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1153"></a>1153</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="1154"></a>1154</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1155"></a>1155</td><td></td><td></td><td></td><td></td><td class="s">sub slice {</td></tr>
+<tr><td class="h"><a name="1156"></a>1156</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $min, $max) = @_;</td></tr>
+<tr><td class="h"><a name="1157"></a>1157</td><td></td><td></td><td></td><td></td><td class="s"> my $attrs = {}; # = { %{ $self->{attrs} || {} } };</td></tr>
+<tr><td class="h"><a name="1158"></a>1158</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{offset} = $self->{attrs}{offset} || 0;</td></tr>
+<tr><td class="h"><a name="1159"></a>1159</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{offset} += $min;</td></tr>
+<tr><td class="h"><a name="1160"></a>1160</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{rows} = ($max ? ($max - $min + 1) : 1);</td></tr>
+<tr><td class="h"><a name="1161"></a>1161</td><td></td><td></td><td></td><td></td><td class="s"> return $self->search(undef, $attrs);</td></tr>
+<tr><td class="h"><a name="1162"></a>1162</td><td></td><td></td><td></td><td></td><td class="s"> #my $slice = (ref $self)->new($self->result_source, $attrs);</td></tr>
+<tr><td class="h"><a name="1163"></a>1163</td><td></td><td></td><td></td><td></td><td class="s"> #return (wantarray ? $slice->all : $slice);</td></tr>
+<tr><td class="h"><a name="1164"></a>1164</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="1165"></a>1165</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1166"></a>1166</td><td></td><td></td><td></td><td></td><td class="s">=head2 next</td></tr>
+<tr><td class="h"><a name="1167"></a>1167</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1168"></a>1168</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="1169"></a>1169</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1170"></a>1170</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: none</td></tr>
+<tr><td class="h"><a name="1171"></a>1171</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1172"></a>1172</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $result | undef</td></tr>
+<tr><td class="h"><a name="1173"></a>1173</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1174"></a>1174</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="1175"></a>1175</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1176"></a>1176</td><td></td><td></td><td></td><td></td><td class="s">Returns the next element in the resultset (C<undef> is there is none).</td></tr>
+<tr><td class="h"><a name="1177"></a>1177</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1178"></a>1178</td><td></td><td></td><td></td><td></td><td class="s">Can be used to efficiently iterate over records in the resultset:</td></tr>
+<tr><td class="h"><a name="1179"></a>1179</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1180"></a>1180</td><td></td><td></td><td></td><td></td><td class="s"> my $rs = $schema->resultset('CD')->search;</td></tr>
+<tr><td class="h"><a name="1181"></a>1181</td><td></td><td></td><td></td><td></td><td class="s"> while (my $cd = $rs->next) {</td></tr>
+<tr><td class="h"><a name="1182"></a>1182</td><td></td><td></td><td></td><td></td><td class="s"> print $cd->title;</td></tr>
+<tr><td class="h"><a name="1183"></a>1183</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1184"></a>1184</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1185"></a>1185</td><td></td><td></td><td></td><td></td><td class="s">Note that you need to store the resultset object, and call C<next> on it.</td></tr>
+<tr><td class="h"><a name="1186"></a>1186</td><td></td><td></td><td></td><td></td><td class="s">Calling C<< resultset('Table')->next >> repeatedly will always return the</td></tr>
+<tr><td class="h"><a name="1187"></a>1187</td><td></td><td></td><td></td><td></td><td class="s">first record from the resultset.</td></tr>
+<tr><td class="h"><a name="1188"></a>1188</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1189"></a>1189</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="1190"></a>1190</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1191"></a>1191</td><td></td><td></td><td></td><td></td><td class="s">sub next {</td></tr>
+<tr><td class="h"><a name="1192"></a>1192</td><td></td><td></td><td></td><td></td><td class="s"> my ($self) = @_;</td></tr>
+<tr><td class="h"><a name="1193"></a>1193</td><td></td><td></td><td></td><td></td><td class="s"> if (my $cache = $self->get_cache) {</td></tr>
+<tr><td class="h"><a name="1194"></a>1194</td><td></td><td></td><td></td><td></td><td class="s"> $self->{all_cache_position} ||= 0;</td></tr>
+<tr><td class="h"><a name="1195"></a>1195</td><td></td><td></td><td></td><td></td><td class="s"> return $cache->[$self->{all_cache_position}++];</td></tr>
+<tr><td class="h"><a name="1196"></a>1196</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1197"></a>1197</td><td></td><td></td><td></td><td></td><td class="s"> if ($self->{attrs}{cache}) {</td></tr>
+<tr><td class="h"><a name="1198"></a>1198</td><td></td><td></td><td></td><td></td><td class="s"> delete $self->{pager};</td></tr>
+<tr><td class="h"><a name="1199"></a>1199</td><td></td><td></td><td></td><td></td><td class="s"> $self->{all_cache_position} = 1;</td></tr>
+<tr><td class="h"><a name="1200"></a>1200</td><td></td><td></td><td></td><td></td><td class="s"> return ($self->all)[0];</td></tr>
+<tr><td class="h"><a name="1201"></a>1201</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1202"></a>1202</td><td></td><td></td><td></td><td></td><td class="s"> if ($self->{stashed_objects}) {</td></tr>
+<tr><td class="h"><a name="1203"></a>1203</td><td></td><td></td><td></td><td></td><td class="s"> my $obj = shift(@{$self->{stashed_objects}});</td></tr>
+<tr><td class="h"><a name="1204"></a>1204</td><td></td><td></td><td></td><td></td><td class="s"> delete $self->{stashed_objects} unless @{$self->{stashed_objects}};</td></tr>
+<tr><td class="h"><a name="1205"></a>1205</td><td></td><td></td><td></td><td></td><td class="s"> return $obj;</td></tr>
+<tr><td class="h"><a name="1206"></a>1206</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1207"></a>1207</td><td></td><td></td><td></td><td></td><td class="s"> my @row = (</td></tr>
+<tr><td class="h"><a name="1208"></a>1208</td><td></td><td></td><td></td><td></td><td class="s"> exists $self->{stashed_row}</td></tr>
+<tr><td class="h"><a name="1209"></a>1209</td><td></td><td></td><td></td><td></td><td class="s"> ? @{delete $self->{stashed_row}}</td></tr>
+<tr><td class="h"><a name="1210"></a>1210</td><td></td><td></td><td></td><td></td><td class="s"> : $self->cursor->next</td></tr>
+<tr><td class="h"><a name="1211"></a>1211</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="1212"></a>1212</td><td></td><td></td><td></td><td></td><td class="s"> return undef unless (@row);</td></tr>
+<tr><td class="h"><a name="1213"></a>1213</td><td></td><td></td><td></td><td></td><td class="s"> my ($row, @more) = $self->_construct_object(@row);</td></tr>
+<tr><td class="h"><a name="1214"></a>1214</td><td></td><td></td><td></td><td></td><td class="s"> $self->{stashed_objects} = \@more if @more;</td></tr>
+<tr><td class="h"><a name="1215"></a>1215</td><td></td><td></td><td></td><td></td><td class="s"> return $row;</td></tr>
+<tr><td class="h"><a name="1216"></a>1216</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="1217"></a>1217</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1218"></a>1218</td><td></td><td></td><td></td><td></td><td class="s">sub _construct_object {</td></tr>
+<tr><td class="h"><a name="1219"></a>1219</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, @row) = @_;</td></tr>
+<tr><td class="h"><a name="1220"></a>1220</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1221"></a>1221</td><td></td><td></td><td></td><td></td><td class="s"> my $info = $self->_collapse_result($self->{_attrs}{as}, \@row)</td></tr>
+<tr><td class="h"><a name="1222"></a>1222</td><td></td><td></td><td></td><td></td><td class="s"> or return ();</td></tr>
+<tr><td class="h"><a name="1223"></a>1223</td><td></td><td></td><td></td><td></td><td class="s"> my @new = $self->result_class->inflate_result($self->result_source, @$info);</td></tr>
+<tr><td class="h"><a name="1224"></a>1224</td><td></td><td></td><td></td><td></td><td class="s"> @new = $self->{_attrs}{record_filter}->(@new)</td></tr>
+<tr><td class="h"><a name="1225"></a>1225</td><td></td><td></td><td></td><td></td><td class="s"> if exists $self->{_attrs}{record_filter};</td></tr>
+<tr><td class="h"><a name="1226"></a>1226</td><td></td><td></td><td></td><td></td><td class="s"> return @new;</td></tr>
+<tr><td class="h"><a name="1227"></a>1227</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="1228"></a>1228</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1229"></a>1229</td><td></td><td></td><td></td><td></td><td class="s">sub _collapse_result {</td></tr>
+<tr><td class="h"><a name="1230"></a>1230</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $as_proto, $row) = @_;</td></tr>
+<tr><td class="h"><a name="1231"></a>1231</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1232"></a>1232</td><td></td><td></td><td></td><td></td><td class="s"> my @copy = @$row;</td></tr>
+<tr><td class="h"><a name="1233"></a>1233</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1234"></a>1234</td><td></td><td></td><td></td><td></td><td class="s"> # 'foo' => [ undef, 'foo' ]</td></tr>
+<tr><td class="h"><a name="1235"></a>1235</td><td></td><td></td><td></td><td></td><td class="s"> # 'foo.bar' => [ 'foo', 'bar' ]</td></tr>
+<tr><td class="h"><a name="1236"></a>1236</td><td></td><td></td><td></td><td></td><td class="s"> # 'foo.bar.baz' => [ 'foo.bar', 'baz' ]</td></tr>
+<tr><td class="h"><a name="1237"></a>1237</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1238"></a>1238</td><td></td><td></td><td></td><td></td><td class="s"> my @construct_as = map { [ (/^(?:(.*)\.)?([^.]+)$/) ] } @$as_proto;</td></tr>
+<tr><td class="h"><a name="1239"></a>1239</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1240"></a>1240</td><td></td><td></td><td></td><td></td><td class="s"> my %collapse = %{$self->{_attrs}{collapse}||{}};</td></tr>
+<tr><td class="h"><a name="1241"></a>1241</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1242"></a>1242</td><td></td><td></td><td></td><td></td><td class="s"> my @pri_index;</td></tr>
+<tr><td class="h"><a name="1243"></a>1243</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1244"></a>1244</td><td></td><td></td><td></td><td></td><td class="s"> # if we're doing collapsing (has_many prefetch) we need to grab records</td></tr>
+<tr><td class="h"><a name="1245"></a>1245</td><td></td><td></td><td></td><td></td><td class="s"> # until the PK changes, so fill @pri_index. if not, we leave it empty so</td></tr>
+<tr><td class="h"><a name="1246"></a>1246</td><td></td><td></td><td></td><td></td><td class="s"> # we know we don't have to bother.</td></tr>
+<tr><td class="h"><a name="1247"></a>1247</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1248"></a>1248</td><td></td><td></td><td></td><td></td><td class="s"> # the reason for not using the collapse stuff directly is because if you</td></tr>
+<tr><td class="h"><a name="1249"></a>1249</td><td></td><td></td><td></td><td></td><td class="s"> # had for e.g. two artists in a row with no cds, the collapse info for</td></tr>
+<tr><td class="h"><a name="1250"></a>1250</td><td></td><td></td><td></td><td></td><td class="s"> # both would be NULL (undef) so you'd lose the second artist</td></tr>
+<tr><td class="h"><a name="1251"></a>1251</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1252"></a>1252</td><td></td><td></td><td></td><td></td><td class="s"> # store just the index so we can check the array positions from the row</td></tr>
+<tr><td class="h"><a name="1253"></a>1253</td><td></td><td></td><td></td><td></td><td class="s"> # without having to contruct the full hash</td></tr>
+<tr><td class="h"><a name="1254"></a>1254</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1255"></a>1255</td><td></td><td></td><td></td><td></td><td class="s"> if (keys %collapse) {</td></tr>
+<tr><td class="h"><a name="1256"></a>1256</td><td></td><td></td><td></td><td></td><td class="s"> my %pri = map { ($_ => 1) } $self->result_source->_pri_cols;</td></tr>
+<tr><td class="h"><a name="1257"></a>1257</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $i (0 .. $#construct_as) {</td></tr>
+<tr><td class="h"><a name="1258"></a>1258</td><td></td><td></td><td></td><td></td><td class="s"> next if defined($construct_as[$i][0]); # only self table</td></tr>
+<tr><td class="h"><a name="1259"></a>1259</td><td></td><td></td><td></td><td></td><td class="s"> if (delete $pri{$construct_as[$i][1]}) {</td></tr>
+<tr><td class="h"><a name="1260"></a>1260</td><td></td><td></td><td></td><td></td><td class="s"> push(@pri_index, $i);</td></tr>
+<tr><td class="h"><a name="1261"></a>1261</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1262"></a>1262</td><td></td><td></td><td></td><td></td><td class="s"> last unless keys %pri; # short circuit (Johnny Five Is Alive!)</td></tr>
+<tr><td class="h"><a name="1263"></a>1263</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1264"></a>1264</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1265"></a>1265</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1266"></a>1266</td><td></td><td></td><td></td><td></td><td class="s"> # no need to do an if, it'll be empty if @pri_index is empty anyway</td></tr>
+<tr><td class="h"><a name="1267"></a>1267</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1268"></a>1268</td><td></td><td></td><td></td><td></td><td class="s"> my %pri_vals = map { ($_ => $copy[$_]) } @pri_index;</td></tr>
+<tr><td class="h"><a name="1269"></a>1269</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1270"></a>1270</td><td></td><td></td><td></td><td></td><td class="s"> my @const_rows;</td></tr>
+<tr><td class="h"><a name="1271"></a>1271</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1272"></a>1272</td><td></td><td></td><td></td><td></td><td class="s"> do { # no need to check anything at the front, we always want the first row</td></tr>
+<tr><td class="h"><a name="1273"></a>1273</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1274"></a>1274</td><td></td><td></td><td></td><td></td><td class="s"> my %const;</td></tr>
+<tr><td class="h"><a name="1275"></a>1275</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1276"></a>1276</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $this_as (@construct_as) {</td></tr>
+<tr><td class="h"><a name="1277"></a>1277</td><td></td><td></td><td></td><td></td><td class="s"> $const{$this_as->[0]||''}{$this_as->[1]} = shift(@copy);</td></tr>
+<tr><td class="h"><a name="1278"></a>1278</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1279"></a>1279</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1280"></a>1280</td><td></td><td></td><td></td><td></td><td class="s"> push(@const_rows, \%const);</td></tr>
+<tr><td class="h"><a name="1281"></a>1281</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1282"></a>1282</td><td></td><td></td><td></td><td></td><td class="s"> } until ( # no pri_index => no collapse => drop straight out</td></tr>
+<tr><td class="h"><a name="1283"></a>1283</td><td></td><td></td><td></td><td></td><td class="s"> !@pri_index</td></tr>
+<tr><td class="h"><a name="1284"></a>1284</td><td></td><td></td><td></td><td></td><td class="s"> or</td></tr>
+<tr><td class="h"><a name="1285"></a>1285</td><td></td><td></td><td></td><td></td><td class="s"> do { # get another row, stash it, drop out if different PK</td></tr>
+<tr><td class="h"><a name="1286"></a>1286</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1287"></a>1287</td><td></td><td></td><td></td><td></td><td class="s"> @copy = $self->cursor->next;</td></tr>
+<tr><td class="h"><a name="1288"></a>1288</td><td></td><td></td><td></td><td></td><td class="s"> $self->{stashed_row} = \@copy;</td></tr>
+<tr><td class="h"><a name="1289"></a>1289</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1290"></a>1290</td><td></td><td></td><td></td><td></td><td class="s"> # last thing in do block, counts as true if anything doesn't match</td></tr>
+<tr><td class="h"><a name="1291"></a>1291</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1292"></a>1292</td><td></td><td></td><td></td><td></td><td class="s"> # check xor defined first for NULL vs. NOT NULL then if one is</td></tr>
+<tr><td class="h"><a name="1293"></a>1293</td><td></td><td></td><td></td><td></td><td class="s"> # defined the other must be so check string equality</td></tr>
+<tr><td class="h"><a name="1294"></a>1294</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1295"></a>1295</td><td></td><td></td><td></td><td></td><td class="s"> grep {</td></tr>
+<tr><td class="h"><a name="1296"></a>1296</td><td></td><td></td><td></td><td></td><td class="s"> (defined $pri_vals{$_} ^ defined $copy[$_])</td></tr>
+<tr><td class="h"><a name="1297"></a>1297</td><td></td><td></td><td></td><td></td><td class="s"> || (defined $pri_vals{$_} && ($pri_vals{$_} ne $copy[$_]))</td></tr>
+<tr><td class="h"><a name="1298"></a>1298</td><td></td><td></td><td></td><td></td><td class="s"> } @pri_index;</td></tr>
+<tr><td class="h"><a name="1299"></a>1299</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1300"></a>1300</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="1301"></a>1301</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1302"></a>1302</td><td></td><td></td><td></td><td></td><td class="s"> my $alias = $self->{attrs}{alias};</td></tr>
+<tr><td class="h"><a name="1303"></a>1303</td><td></td><td></td><td></td><td></td><td class="s"> my $info = [];</td></tr>
+<tr><td class="h"><a name="1304"></a>1304</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1305"></a>1305</td><td></td><td></td><td></td><td></td><td class="s"> my %collapse_pos;</td></tr>
+<tr><td class="h"><a name="1306"></a>1306</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1307"></a>1307</td><td></td><td></td><td></td><td></td><td class="s"> my @const_keys;</td></tr>
+<tr><td class="h"><a name="1308"></a>1308</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1309"></a>1309</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $const (@const_rows) {</td></tr>
+<tr><td class="h"><a name="1310"></a>1310</td><td></td><td></td><td></td><td></td><td class="s"> scalar @const_keys or do {</td></tr>
+<tr><td class="h"><a name="1311"></a>1311</td><td></td><td></td><td></td><td></td><td class="s"> @const_keys = sort { length($a) <=> length($b) } keys %$const;</td></tr>
+<tr><td class="h"><a name="1312"></a>1312</td><td></td><td></td><td></td><td></td><td class="s"> };</td></tr>
+<tr><td class="h"><a name="1313"></a>1313</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $key (@const_keys) {</td></tr>
+<tr><td class="h"><a name="1314"></a>1314</td><td></td><td></td><td></td><td></td><td class="s"> if (length $key) {</td></tr>
+<tr><td class="h"><a name="1315"></a>1315</td><td></td><td></td><td></td><td></td><td class="s"> my $target = $info;</td></tr>
+<tr><td class="h"><a name="1316"></a>1316</td><td></td><td></td><td></td><td></td><td class="s"> my @parts = split(/\./, $key);</td></tr>
+<tr><td class="h"><a name="1317"></a>1317</td><td></td><td></td><td></td><td></td><td class="s"> my $cur = '';</td></tr>
+<tr><td class="h"><a name="1318"></a>1318</td><td></td><td></td><td></td><td></td><td class="s"> my $data = $const->{$key};</td></tr>
+<tr><td class="h"><a name="1319"></a>1319</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $p (@parts) {</td></tr>
+<tr><td class="h"><a name="1320"></a>1320</td><td></td><td></td><td></td><td></td><td class="s"> $target = $target->[1]->{$p} ||= [];</td></tr>
+<tr><td class="h"><a name="1321"></a>1321</td><td></td><td></td><td></td><td></td><td class="s"> $cur .= ".${p}";</td></tr>
+<tr><td class="h"><a name="1322"></a>1322</td><td></td><td></td><td></td><td></td><td class="s"> if ($cur eq ".${key}" && (my @ckey = @{$collapse{$cur}||[]})) {</td></tr>
+<tr><td class="h"><a name="1323"></a>1323</td><td></td><td></td><td></td><td></td><td class="s"> # collapsing at this point and on final part</td></tr>
+<tr><td class="h"><a name="1324"></a>1324</td><td></td><td></td><td></td><td></td><td class="s"> my $pos = $collapse_pos{$cur};</td></tr>
+<tr><td class="h"><a name="1325"></a>1325</td><td></td><td></td><td></td><td></td><td class="s"> CK: foreach my $ck (@ckey) {</td></tr>
+<tr><td class="h"><a name="1326"></a>1326</td><td></td><td></td><td></td><td></td><td class="s"> if (!defined $pos->{$ck} || $pos->{$ck} ne $data->{$ck}) {</td></tr>
+<tr><td class="h"><a name="1327"></a>1327</td><td></td><td></td><td></td><td></td><td class="s"> $collapse_pos{$cur} = $data;</td></tr>
+<tr><td class="h"><a name="1328"></a>1328</td><td></td><td></td><td></td><td></td><td class="s"> delete @collapse_pos{ # clear all positioning for sub-entries</td></tr>
+<tr><td class="h"><a name="1329"></a>1329</td><td></td><td></td><td></td><td></td><td class="s"> grep { m/^\Q${cur}.\E/ } keys %collapse_pos</td></tr>
+<tr><td class="h"><a name="1330"></a>1330</td><td></td><td></td><td></td><td></td><td class="s"> };</td></tr>
+<tr><td class="h"><a name="1331"></a>1331</td><td></td><td></td><td></td><td></td><td class="s"> push(@$target, []);</td></tr>
+<tr><td class="h"><a name="1332"></a>1332</td><td></td><td></td><td></td><td></td><td class="s"> last CK;</td></tr>
+<tr><td class="h"><a name="1333"></a>1333</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1334"></a>1334</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1335"></a>1335</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1336"></a>1336</td><td></td><td></td><td></td><td></td><td class="s"> if (exists $collapse{$cur}) {</td></tr>
+<tr><td class="h"><a name="1337"></a>1337</td><td></td><td></td><td></td><td></td><td class="s"> $target = $target->[-1];</td></tr>
+<tr><td class="h"><a name="1338"></a>1338</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1339"></a>1339</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1340"></a>1340</td><td></td><td></td><td></td><td></td><td class="s"> $target->[0] = $data;</td></tr>
+<tr><td class="h"><a name="1341"></a>1341</td><td></td><td></td><td></td><td></td><td class="s"> } else {</td></tr>
+<tr><td class="h"><a name="1342"></a>1342</td><td></td><td></td><td></td><td></td><td class="s"> $info->[0] = $const->{$key};</td></tr>
+<tr><td class="h"><a name="1343"></a>1343</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1344"></a>1344</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1345"></a>1345</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1346"></a>1346</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1347"></a>1347</td><td></td><td></td><td></td><td></td><td class="s"> return $info;</td></tr>
+<tr><td class="h"><a name="1348"></a>1348</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="1349"></a>1349</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1350"></a>1350</td><td></td><td></td><td></td><td></td><td class="s">=head2 result_source</td></tr>
+<tr><td class="h"><a name="1351"></a>1351</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1352"></a>1352</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="1353"></a>1353</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1354"></a>1354</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: $result_source?</td></tr>
+<tr><td class="h"><a name="1355"></a>1355</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1356"></a>1356</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $result_source</td></tr>
+<tr><td class="h"><a name="1357"></a>1357</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1358"></a>1358</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="1359"></a>1359</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1360"></a>1360</td><td></td><td></td><td></td><td></td><td class="s">An accessor for the primary ResultSource object from which this ResultSet</td></tr>
+<tr><td class="h"><a name="1361"></a>1361</td><td></td><td></td><td></td><td></td><td class="s">is derived.</td></tr>
+<tr><td class="h"><a name="1362"></a>1362</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1363"></a>1363</td><td></td><td></td><td></td><td></td><td class="s">=head2 result_class</td></tr>
+<tr><td class="h"><a name="1364"></a>1364</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1365"></a>1365</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="1366"></a>1366</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1367"></a>1367</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: $result_class?</td></tr>
+<tr><td class="h"><a name="1368"></a>1368</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1369"></a>1369</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $result_class</td></tr>
+<tr><td class="h"><a name="1370"></a>1370</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1371"></a>1371</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="1372"></a>1372</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1373"></a>1373</td><td></td><td></td><td></td><td></td><td class="s">An accessor for the class to use when creating row objects. Defaults to</td></tr>
+<tr><td class="h"><a name="1374"></a>1374</td><td></td><td></td><td></td><td></td><td class="s">C<< result_source->result_class >> - which in most cases is the name of the</td></tr>
+<tr><td class="h"><a name="1375"></a>1375</td><td></td><td></td><td></td><td></td><td class="s">L<"table"|DBIx::Class::Manual::Glossary/"ResultSource"> class.</td></tr>
+<tr><td class="h"><a name="1376"></a>1376</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1377"></a>1377</td><td></td><td></td><td></td><td></td><td class="s">Note that changing the result_class will also remove any components</td></tr>
+<tr><td class="h"><a name="1378"></a>1378</td><td></td><td></td><td></td><td></td><td class="s">that were originally loaded in the source class via</td></tr>
+<tr><td class="h"><a name="1379"></a>1379</td><td></td><td></td><td></td><td></td><td class="s">L<DBIx::Class::ResultSource/load_components>. Any overloaded methods</td></tr>
+<tr><td class="h"><a name="1380"></a>1380</td><td></td><td></td><td></td><td></td><td class="s">in the original source class will not run.</td></tr>
+<tr><td class="h"><a name="1381"></a>1381</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1382"></a>1382</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="1383"></a>1383</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1384"></a>1384</td><td></td><td></td><td></td><td></td><td class="s">sub result_class {</td></tr>
+<tr><td class="h"><a name="1385"></a>1385</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $result_class) = @_;</td></tr>
+<tr><td class="h"><a name="1386"></a>1386</td><td></td><td></td><td></td><td></td><td class="s"> if ($result_class) {</td></tr>
+<tr><td class="h"><a name="1387"></a>1387</td><td></td><td></td><td></td><td></td><td class="s"> unless (ref $result_class) { # don't fire this for an object</td></tr>
+<tr><td class="h"><a name="1388"></a>1388</td><td></td><td></td><td></td><td></td><td class="s"> $self->ensure_class_loaded($result_class);</td></tr>
+<tr><td class="h"><a name="1389"></a>1389</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1390"></a>1390</td><td></td><td></td><td></td><td></td><td class="s"> $self->_result_class($result_class);</td></tr>
+<tr><td class="h"><a name="1391"></a>1391</td><td></td><td></td><td></td><td></td><td class="s"> # THIS LINE WOULD BE A BUG - this accessor specifically exists to</td></tr>
+<tr><td class="h"><a name="1392"></a>1392</td><td></td><td></td><td></td><td></td><td class="s"> # permit the user to set result class on one result set only; it only</td></tr>
+<tr><td class="h"><a name="1393"></a>1393</td><td></td><td></td><td></td><td></td><td class="s"> # chains if provided to search()</td></tr>
+<tr><td class="h"><a name="1394"></a>1394</td><td></td><td></td><td></td><td></td><td class="s"> #$self->{attrs}{result_class} = $result_class if ref $self;</td></tr>
+<tr><td class="h"><a name="1395"></a>1395</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1396"></a>1396</td><td></td><td></td><td></td><td></td><td class="s"> $self->_result_class;</td></tr>
+<tr><td class="h"><a name="1397"></a>1397</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="1398"></a>1398</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1399"></a>1399</td><td></td><td></td><td></td><td></td><td class="s">=head2 count</td></tr>
+<tr><td class="h"><a name="1400"></a>1400</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1401"></a>1401</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="1402"></a>1402</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1403"></a>1403</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: $cond, \%attrs??</td></tr>
+<tr><td class="h"><a name="1404"></a>1404</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1405"></a>1405</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $count</td></tr>
+<tr><td class="h"><a name="1406"></a>1406</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1407"></a>1407</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="1408"></a>1408</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1409"></a>1409</td><td></td><td></td><td></td><td></td><td class="s">Performs an SQL C<COUNT> with the same query as the resultset was built</td></tr>
+<tr><td class="h"><a name="1410"></a>1410</td><td></td><td></td><td></td><td></td><td class="s">with to find the number of elements. Passing arguments is equivalent to</td></tr>
+<tr><td class="h"><a name="1411"></a>1411</td><td></td><td></td><td></td><td></td><td class="s">C<< $rs->search ($cond, \%attrs)->count >></td></tr>
+<tr><td class="h"><a name="1412"></a>1412</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1413"></a>1413</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="1414"></a>1414</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1415"></a>1415</td><td></td><td></td><td></td><td></td><td class="s">sub count {</td></tr>
+<tr><td class="h"><a name="1416"></a>1416</td><td></td><td></td><td></td><td></td><td class="s"> my $self = shift;</td></tr>
+<tr><td class="h"><a name="1417"></a>1417</td><td></td><td></td><td></td><td></td><td class="s"> return $self->search(@_)->count if @_ and defined $_[0];</td></tr>
+<tr><td class="h"><a name="1418"></a>1418</td><td></td><td></td><td></td><td></td><td class="s"> return scalar @{ $self->get_cache } if $self->get_cache;</td></tr>
+<tr><td class="h"><a name="1419"></a>1419</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1420"></a>1420</td><td></td><td></td><td></td><td></td><td class="s"> my $attrs = $self->_resolved_attrs_copy;</td></tr>
+<tr><td class="h"><a name="1421"></a>1421</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1422"></a>1422</td><td></td><td></td><td></td><td></td><td class="s"> # this is a little optimization - it is faster to do the limit</td></tr>
+<tr><td class="h"><a name="1423"></a>1423</td><td></td><td></td><td></td><td></td><td class="s"> # adjustments in software, instead of a subquery</td></tr>
+<tr><td class="h"><a name="1424"></a>1424</td><td></td><td></td><td></td><td></td><td class="s"> my $rows = delete $attrs->{rows};</td></tr>
+<tr><td class="h"><a name="1425"></a>1425</td><td></td><td></td><td></td><td></td><td class="s"> my $offset = delete $attrs->{offset};</td></tr>
+<tr><td class="h"><a name="1426"></a>1426</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1427"></a>1427</td><td></td><td></td><td></td><td></td><td class="s"> my $crs;</td></tr>
+<tr><td class="h"><a name="1428"></a>1428</td><td></td><td></td><td></td><td></td><td class="s"> if ($self->_has_resolved_attr (qw/collapse group_by/)) {</td></tr>
+<tr><td class="h"><a name="1429"></a>1429</td><td></td><td></td><td></td><td></td><td class="s"> $crs = $self->_count_subq_rs ($attrs);</td></tr>
+<tr><td class="h"><a name="1430"></a>1430</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1431"></a>1431</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="1432"></a>1432</td><td></td><td></td><td></td><td></td><td class="s"> $crs = $self->_count_rs ($attrs);</td></tr>
+<tr><td class="h"><a name="1433"></a>1433</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1434"></a>1434</td><td></td><td></td><td></td><td></td><td class="s"> my $count = $crs->next;</td></tr>
+<tr><td class="h"><a name="1435"></a>1435</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1436"></a>1436</td><td></td><td></td><td></td><td></td><td class="s"> $count -= $offset if $offset;</td></tr>
+<tr><td class="h"><a name="1437"></a>1437</td><td></td><td></td><td></td><td></td><td class="s"> $count = $rows if $rows and $rows < $count;</td></tr>
+<tr><td class="h"><a name="1438"></a>1438</td><td></td><td></td><td></td><td></td><td class="s"> $count = 0 if ($count < 0);</td></tr>
+<tr><td class="h"><a name="1439"></a>1439</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1440"></a>1440</td><td></td><td></td><td></td><td></td><td class="s"> return $count;</td></tr>
+<tr><td class="h"><a name="1441"></a>1441</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="1442"></a>1442</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1443"></a>1443</td><td></td><td></td><td></td><td></td><td class="s">=head2 count_rs</td></tr>
+<tr><td class="h"><a name="1444"></a>1444</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1445"></a>1445</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="1446"></a>1446</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1447"></a>1447</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: $cond, \%attrs??</td></tr>
+<tr><td class="h"><a name="1448"></a>1448</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1449"></a>1449</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $count_rs</td></tr>
+<tr><td class="h"><a name="1450"></a>1450</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1451"></a>1451</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="1452"></a>1452</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1453"></a>1453</td><td></td><td></td><td></td><td></td><td class="s">Same as L</count> but returns a L<DBIx::Class::ResultSetColumn> object.</td></tr>
+<tr><td class="h"><a name="1454"></a>1454</td><td></td><td></td><td></td><td></td><td class="s">This can be very handy for subqueries:</td></tr>
+<tr><td class="h"><a name="1455"></a>1455</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1456"></a>1456</td><td></td><td></td><td></td><td></td><td class="s"> ->search( { amount => $some_rs->count_rs->as_query } )</td></tr>
+<tr><td class="h"><a name="1457"></a>1457</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1458"></a>1458</td><td></td><td></td><td></td><td></td><td class="s">As with regular resultsets the SQL query will be executed only after</td></tr>
+<tr><td class="h"><a name="1459"></a>1459</td><td></td><td></td><td></td><td></td><td class="s">the resultset is accessed via L</next> or L</all>. That would return</td></tr>
+<tr><td class="h"><a name="1460"></a>1460</td><td></td><td></td><td></td><td></td><td class="s">the same single value obtainable via L</count>.</td></tr>
+<tr><td class="h"><a name="1461"></a>1461</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1462"></a>1462</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="1463"></a>1463</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1464"></a>1464</td><td></td><td></td><td></td><td></td><td class="s">sub count_rs {</td></tr>
+<tr><td class="h"><a name="1465"></a>1465</td><td></td><td></td><td></td><td></td><td class="s"> my $self = shift;</td></tr>
+<tr><td class="h"><a name="1466"></a>1466</td><td></td><td></td><td></td><td></td><td class="s"> return $self->search(@_)->count_rs if @_;</td></tr>
+<tr><td class="h"><a name="1467"></a>1467</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1468"></a>1468</td><td></td><td></td><td></td><td></td><td class="s"> # this may look like a lack of abstraction (count() does about the same)</td></tr>
+<tr><td class="h"><a name="1469"></a>1469</td><td></td><td></td><td></td><td></td><td class="s"> # but in fact an _rs *must* use a subquery for the limits, as the</td></tr>
+<tr><td class="h"><a name="1470"></a>1470</td><td></td><td></td><td></td><td></td><td class="s"> # software based limiting can not be ported if this $rs is to be used</td></tr>
+<tr><td class="h"><a name="1471"></a>1471</td><td></td><td></td><td></td><td></td><td class="s"> # in a subquery itself (i.e. ->as_query)</td></tr>
+<tr><td class="h"><a name="1472"></a>1472</td><td></td><td></td><td></td><td></td><td class="s"> if ($self->_has_resolved_attr (qw/collapse group_by offset rows/)) {</td></tr>
+<tr><td class="h"><a name="1473"></a>1473</td><td></td><td></td><td></td><td></td><td class="s"> return $self->_count_subq_rs;</td></tr>
+<tr><td class="h"><a name="1474"></a>1474</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1475"></a>1475</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="1476"></a>1476</td><td></td><td></td><td></td><td></td><td class="s"> return $self->_count_rs;</td></tr>
+<tr><td class="h"><a name="1477"></a>1477</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1478"></a>1478</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="1479"></a>1479</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1480"></a>1480</td><td></td><td></td><td></td><td></td><td class="s">#</td></tr>
+<tr><td class="h"><a name="1481"></a>1481</td><td></td><td></td><td></td><td></td><td class="s"># returns a ResultSetColumn object tied to the count query</td></tr>
+<tr><td class="h"><a name="1482"></a>1482</td><td></td><td></td><td></td><td></td><td class="s">#</td></tr>
+<tr><td class="h"><a name="1483"></a>1483</td><td></td><td></td><td></td><td></td><td class="s">sub _count_rs {</td></tr>
+<tr><td class="h"><a name="1484"></a>1484</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $attrs) = @_;</td></tr>
+<tr><td class="h"><a name="1485"></a>1485</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1486"></a>1486</td><td></td><td></td><td></td><td></td><td class="s"> my $rsrc = $self->result_source;</td></tr>
+<tr><td class="h"><a name="1487"></a>1487</td><td></td><td></td><td></td><td></td><td class="s"> $attrs ||= $self->_resolved_attrs;</td></tr>
+<tr><td class="h"><a name="1488"></a>1488</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1489"></a>1489</td><td></td><td></td><td></td><td></td><td class="s"> my $tmp_attrs = { %$attrs };</td></tr>
+<tr><td class="h"><a name="1490"></a>1490</td><td></td><td></td><td></td><td></td><td class="s"> # take off any limits, record_filter is cdbi, and no point of ordering nor locking a count</td></tr>
+<tr><td class="h"><a name="1491"></a>1491</td><td></td><td></td><td></td><td></td><td class="s"> delete @{$tmp_attrs}{qw/rows offset order_by record_filter for/};</td></tr>
+<tr><td class="h"><a name="1492"></a>1492</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1493"></a>1493</td><td></td><td></td><td></td><td></td><td class="s"> # overwrite the selector (supplied by the storage)</td></tr>
+<tr><td class="h"><a name="1494"></a>1494</td><td></td><td></td><td></td><td></td><td class="s"> $tmp_attrs->{select} = $rsrc->storage->_count_select ($rsrc, $attrs);</td></tr>
+<tr><td class="h"><a name="1495"></a>1495</td><td></td><td></td><td></td><td></td><td class="s"> $tmp_attrs->{as} = 'count';</td></tr>
+<tr><td class="h"><a name="1496"></a>1496</td><td></td><td></td><td></td><td></td><td class="s"> delete @{$tmp_attrs}{qw/columns/};</td></tr>
+<tr><td class="h"><a name="1497"></a>1497</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1498"></a>1498</td><td></td><td></td><td></td><td></td><td class="s"> my $tmp_rs = $rsrc->resultset_class->new($rsrc, $tmp_attrs)->get_column ('count');</td></tr>
+<tr><td class="h"><a name="1499"></a>1499</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1500"></a>1500</td><td></td><td></td><td></td><td></td><td class="s"> return $tmp_rs;</td></tr>
+<tr><td class="h"><a name="1501"></a>1501</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="1502"></a>1502</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1503"></a>1503</td><td></td><td></td><td></td><td></td><td class="s">#</td></tr>
+<tr><td class="h"><a name="1504"></a>1504</td><td></td><td></td><td></td><td></td><td class="s"># same as above but uses a subquery</td></tr>
+<tr><td class="h"><a name="1505"></a>1505</td><td></td><td></td><td></td><td></td><td class="s">#</td></tr>
+<tr><td class="h"><a name="1506"></a>1506</td><td></td><td></td><td></td><td></td><td class="s">sub _count_subq_rs {</td></tr>
+<tr><td class="h"><a name="1507"></a>1507</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $attrs) = @_;</td></tr>
+<tr><td class="h"><a name="1508"></a>1508</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1509"></a>1509</td><td></td><td></td><td></td><td></td><td class="s"> my $rsrc = $self->result_source;</td></tr>
+<tr><td class="h"><a name="1510"></a>1510</td><td></td><td></td><td></td><td></td><td class="s"> $attrs ||= $self->_resolved_attrs;</td></tr>
+<tr><td class="h"><a name="1511"></a>1511</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1512"></a>1512</td><td></td><td></td><td></td><td></td><td class="s"> my $sub_attrs = { %$attrs };</td></tr>
+<tr><td class="h"><a name="1513"></a>1513</td><td></td><td></td><td></td><td></td><td class="s"> # extra selectors do not go in the subquery and there is no point of ordering it, nor locking it</td></tr>
+<tr><td class="h"><a name="1514"></a>1514</td><td></td><td></td><td></td><td></td><td class="s"> delete @{$sub_attrs}{qw/collapse columns as select _prefetch_selector_range order_by for/};</td></tr>
+<tr><td class="h"><a name="1515"></a>1515</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1516"></a>1516</td><td></td><td></td><td></td><td></td><td class="s"> # if we multi-prefetch we group_by primary keys only as this is what we would</td></tr>
+<tr><td class="h"><a name="1517"></a>1517</td><td></td><td></td><td></td><td></td><td class="s"> # get out of the rs via ->next/->all. We *DO WANT* to clobber old group_by regardless</td></tr>
+<tr><td class="h"><a name="1518"></a>1518</td><td></td><td></td><td></td><td></td><td class="s"> if ( keys %{$attrs->{collapse}} ) {</td></tr>
+<tr><td class="h"><a name="1519"></a>1519</td><td></td><td></td><td></td><td></td><td class="s"> $sub_attrs->{group_by} = [ map { "$attrs->{alias}.$_" } ($rsrc->_pri_cols) ]</td></tr>
+<tr><td class="h"><a name="1520"></a>1520</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1521"></a>1521</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1522"></a>1522</td><td></td><td></td><td></td><td></td><td class="s"> # Calculate subquery selector</td></tr>
+<tr><td class="h"><a name="1523"></a>1523</td><td></td><td></td><td></td><td></td><td class="s"> if (my $g = $sub_attrs->{group_by}) {</td></tr>
+<tr><td class="h"><a name="1524"></a>1524</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1525"></a>1525</td><td></td><td></td><td></td><td></td><td class="s"> my $sql_maker = $rsrc->storage->sql_maker;</td></tr>
+<tr><td class="h"><a name="1526"></a>1526</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1527"></a>1527</td><td></td><td></td><td></td><td></td><td class="s"> # necessary as the group_by may refer to aliased functions</td></tr>
+<tr><td class="h"><a name="1528"></a>1528</td><td></td><td></td><td></td><td></td><td class="s"> my $sel_index;</td></tr>
+<tr><td class="h"><a name="1529"></a>1529</td><td></td><td></td><td></td><td></td><td class="s"> for my $sel (@{$attrs->{select}}) {</td></tr>
+<tr><td class="h"><a name="1530"></a>1530</td><td></td><td></td><td></td><td></td><td class="s"> $sel_index->{$sel->{-as}} = $sel</td></tr>
+<tr><td class="h"><a name="1531"></a>1531</td><td></td><td></td><td></td><td></td><td class="s"> if (ref $sel eq 'HASH' and $sel->{-as});</td></tr>
+<tr><td class="h"><a name="1532"></a>1532</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1533"></a>1533</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1534"></a>1534</td><td></td><td></td><td></td><td></td><td class="s"> # anything from the original select mentioned on the group-by needs to make it to the inner selector</td></tr>
+<tr><td class="h"><a name="1535"></a>1535</td><td></td><td></td><td></td><td></td><td class="s"> # also look for named aggregates referred in the having clause</td></tr>
+<tr><td class="h"><a name="1536"></a>1536</td><td></td><td></td><td></td><td></td><td class="s"> # having often contains scalarrefs - thus parse it out entirely</td></tr>
+<tr><td class="h"><a name="1537"></a>1537</td><td></td><td></td><td></td><td></td><td class="s"> my @parts = @$g;</td></tr>
+<tr><td class="h"><a name="1538"></a>1538</td><td></td><td></td><td></td><td></td><td class="s"> if ($attrs->{having}) {</td></tr>
+<tr><td class="h"><a name="1539"></a>1539</td><td></td><td></td><td></td><td></td><td class="s"> local $sql_maker->{having_bind};</td></tr>
+<tr><td class="h"><a name="1540"></a>1540</td><td></td><td></td><td></td><td></td><td class="s"> local $sql_maker->{quote_char} = $sql_maker->{quote_char};</td></tr>
+<tr><td class="h"><a name="1541"></a>1541</td><td></td><td></td><td></td><td></td><td class="s"> local $sql_maker->{name_sep} = $sql_maker->{name_sep};</td></tr>
+<tr><td class="h"><a name="1542"></a>1542</td><td></td><td></td><td></td><td></td><td class="s"> unless (defined $sql_maker->{quote_char} and length $sql_maker->{quote_char}) {</td></tr>
+<tr><td class="h"><a name="1543"></a>1543</td><td></td><td></td><td></td><td></td><td class="s"> $sql_maker->{quote_char} = [ "\x00", "\xFF" ];</td></tr>
+<tr><td class="h"><a name="1544"></a>1544</td><td></td><td></td><td></td><td></td><td class="s"> # if we don't unset it we screw up retarded but unfortunately working</td></tr>
+<tr><td class="h"><a name="1545"></a>1545</td><td></td><td></td><td></td><td></td><td class="s"> # 'MAX(foo.bar)' => { '>', 3 }</td></tr>
+<tr><td class="h"><a name="1546"></a>1546</td><td></td><td></td><td></td><td></td><td class="s"> $sql_maker->{name_sep} = '';</td></tr>
+<tr><td class="h"><a name="1547"></a>1547</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1548"></a>1548</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1549"></a>1549</td><td></td><td></td><td></td><td></td><td class="s"> my ($lquote, $rquote, $sep) = map { quotemeta $_ } ($sql_maker->_quote_chars, $sql_maker->name_sep);</td></tr>
+<tr><td class="h"><a name="1550"></a>1550</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1551"></a>1551</td><td></td><td></td><td></td><td></td><td class="s"> my $sql = $sql_maker->_parse_rs_attrs ({ having => $attrs->{having} });</td></tr>
+<tr><td class="h"><a name="1552"></a>1552</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1553"></a>1553</td><td></td><td></td><td></td><td></td><td class="s"> # search for both a proper quoted qualified string, for a naive unquoted scalarref</td></tr>
+<tr><td class="h"><a name="1554"></a>1554</td><td></td><td></td><td></td><td></td><td class="s"> # and if all fails for an utterly naive quoted scalar-with-function</td></tr>
+<tr><td class="h"><a name="1555"></a>1555</td><td></td><td></td><td></td><td></td><td class="s"> while ($sql =~ /</td></tr>
+<tr><td class="h"><a name="1556"></a>1556</td><td></td><td></td><td></td><td></td><td class="s"> $rquote $sep $lquote (.+?) $rquote</td></tr>
+<tr><td class="h"><a name="1557"></a>1557</td><td></td><td></td><td></td><td></td><td class="s"> |</td></tr>
+<tr><td class="h"><a name="1558"></a>1558</td><td></td><td></td><td></td><td></td><td class="s"> [\s,] \w+ \. (\w+) [\s,]</td></tr>
+<tr><td class="h"><a name="1559"></a>1559</td><td></td><td></td><td></td><td></td><td class="s"> |</td></tr>
+<tr><td class="h"><a name="1560"></a>1560</td><td></td><td></td><td></td><td></td><td class="s"> [\s,] $lquote (.+?) $rquote [\s,]</td></tr>
+<tr><td class="h"><a name="1561"></a>1561</td><td></td><td></td><td></td><td></td><td class="s"> /gx) {</td></tr>
+<tr><td class="h"><a name="1562"></a>1562</td><td></td><td></td><td></td><td></td><td class="s"> push @parts, ($1 || $2 || $3); # one of them matched if we got here</td></tr>
+<tr><td class="h"><a name="1563"></a>1563</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1564"></a>1564</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1565"></a>1565</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1566"></a>1566</td><td></td><td></td><td></td><td></td><td class="s"> for (@parts) {</td></tr>
+<tr><td class="h"><a name="1567"></a>1567</td><td></td><td></td><td></td><td></td><td class="s"> my $colpiece = $sel_index->{$_} || $_;</td></tr>
+<tr><td class="h"><a name="1568"></a>1568</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1569"></a>1569</td><td></td><td></td><td></td><td></td><td class="s"> # unqualify join-based group_by's. Arcane but possible query</td></tr>
+<tr><td class="h"><a name="1570"></a>1570</td><td></td><td></td><td></td><td></td><td class="s"> # also horrible horrible hack to alias a column (not a func.)</td></tr>
+<tr><td class="h"><a name="1571"></a>1571</td><td></td><td></td><td></td><td></td><td class="s"> # (probably need to introduce SQLA syntax)</td></tr>
+<tr><td class="h"><a name="1572"></a>1572</td><td></td><td></td><td></td><td></td><td class="s"> if ($colpiece =~ /\./ && $colpiece !~ /^$attrs->{alias}\./) {</td></tr>
+<tr><td class="h"><a name="1573"></a>1573</td><td></td><td></td><td></td><td></td><td class="s"> my $as = $colpiece;</td></tr>
+<tr><td class="h"><a name="1574"></a>1574</td><td></td><td></td><td></td><td></td><td class="s"> $as =~ s/\./__/;</td></tr>
+<tr><td class="h"><a name="1575"></a>1575</td><td></td><td></td><td></td><td></td><td class="s"> $colpiece = \ sprintf ('%s AS %s', map { $sql_maker->_quote ($_) } ($colpiece, $as) );</td></tr>
+<tr><td class="h"><a name="1576"></a>1576</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1577"></a>1577</td><td></td><td></td><td></td><td></td><td class="s"> push @{$sub_attrs->{select}}, $colpiece;</td></tr>
+<tr><td class="h"><a name="1578"></a>1578</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1579"></a>1579</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1580"></a>1580</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="1581"></a>1581</td><td></td><td></td><td></td><td></td><td class="s"> my @pcols = map { "$attrs->{alias}.$_" } ($rsrc->primary_columns);</td></tr>
+<tr><td class="h"><a name="1582"></a>1582</td><td></td><td></td><td></td><td></td><td class="s"> $sub_attrs->{select} = @pcols ? \@pcols : [ 1 ];</td></tr>
+<tr><td class="h"><a name="1583"></a>1583</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1584"></a>1584</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1585"></a>1585</td><td></td><td></td><td></td><td></td><td class="s"> return $rsrc->resultset_class</td></tr>
+<tr><td class="h"><a name="1586"></a>1586</td><td></td><td></td><td></td><td></td><td class="s"> ->new ($rsrc, $sub_attrs)</td></tr>
+<tr><td class="h"><a name="1587"></a>1587</td><td></td><td></td><td></td><td></td><td class="s"> ->as_subselect_rs</td></tr>
+<tr><td class="h"><a name="1588"></a>1588</td><td></td><td></td><td></td><td></td><td class="s"> ->search ({}, { columns => { count => $rsrc->storage->_count_select ($rsrc, $attrs) } })</td></tr>
+<tr><td class="h"><a name="1589"></a>1589</td><td></td><td></td><td></td><td></td><td class="s"> ->get_column ('count');</td></tr>
+<tr><td class="h"><a name="1590"></a>1590</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="1591"></a>1591</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1592"></a>1592</td><td></td><td></td><td></td><td></td><td class="s">sub _bool {</td></tr>
+<tr><td class="h"><a name="1593"></a>1593</td><td></td><td></td><td></td><td></td><td class="s"> return 1;</td></tr>
+<tr><td class="h"><a name="1594"></a>1594</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="1595"></a>1595</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1596"></a>1596</td><td></td><td></td><td></td><td></td><td class="s">=head2 count_literal</td></tr>
+<tr><td class="h"><a name="1597"></a>1597</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1598"></a>1598</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="1599"></a>1599</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1600"></a>1600</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: $sql_fragment, @bind_values</td></tr>
+<tr><td class="h"><a name="1601"></a>1601</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1602"></a>1602</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $count</td></tr>
+<tr><td class="h"><a name="1603"></a>1603</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1604"></a>1604</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="1605"></a>1605</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1606"></a>1606</td><td></td><td></td><td></td><td></td><td class="s">Counts the results in a literal query. Equivalent to calling L</search_literal></td></tr>
+<tr><td class="h"><a name="1607"></a>1607</td><td></td><td></td><td></td><td></td><td class="s">with the passed arguments, then L</count>.</td></tr>
+<tr><td class="h"><a name="1608"></a>1608</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1609"></a>1609</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="1610"></a>1610</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1611"></a>1611</td><td></td><td></td><td></td><td></td><td class="s">sub count_literal { shift->search_literal(@_)->count; }</td></tr>
+<tr><td class="h"><a name="1612"></a>1612</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1613"></a>1613</td><td></td><td></td><td></td><td></td><td class="s">=head2 all</td></tr>
+<tr><td class="h"><a name="1614"></a>1614</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1615"></a>1615</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="1616"></a>1616</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1617"></a>1617</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: none</td></tr>
+<tr><td class="h"><a name="1618"></a>1618</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1619"></a>1619</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: @objects</td></tr>
+<tr><td class="h"><a name="1620"></a>1620</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1621"></a>1621</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="1622"></a>1622</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1623"></a>1623</td><td></td><td></td><td></td><td></td><td class="s">Returns all elements in the resultset.</td></tr>
+<tr><td class="h"><a name="1624"></a>1624</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1625"></a>1625</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="1626"></a>1626</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1627"></a>1627</td><td></td><td></td><td></td><td></td><td class="s">sub all {</td></tr>
+<tr><td class="h"><a name="1628"></a>1628</td><td></td><td></td><td></td><td></td><td class="s"> my $self = shift;</td></tr>
+<tr><td class="h"><a name="1629"></a>1629</td><td></td><td></td><td></td><td></td><td class="s"> if(@_) {</td></tr>
+<tr><td class="h"><a name="1630"></a>1630</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception("all() doesn't take any arguments, you probably wanted ->search(...)->all()");</td></tr>
+<tr><td class="h"><a name="1631"></a>1631</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1632"></a>1632</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1633"></a>1633</td><td></td><td></td><td></td><td></td><td class="s"> return @{ $self->get_cache } if $self->get_cache;</td></tr>
+<tr><td class="h"><a name="1634"></a>1634</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1635"></a>1635</td><td></td><td></td><td></td><td></td><td class="s"> my @obj;</td></tr>
+<tr><td class="h"><a name="1636"></a>1636</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1637"></a>1637</td><td></td><td></td><td></td><td></td><td class="s"> if (keys %{$self->_resolved_attrs->{collapse}}) {</td></tr>
+<tr><td class="h"><a name="1638"></a>1638</td><td></td><td></td><td></td><td></td><td class="s"> # Using $self->cursor->all is really just an optimisation.</td></tr>
+<tr><td class="h"><a name="1639"></a>1639</td><td></td><td></td><td></td><td></td><td class="s"> # If we're collapsing has_many prefetches it probably makes</td></tr>
+<tr><td class="h"><a name="1640"></a>1640</td><td></td><td></td><td></td><td></td><td class="s"> # very little difference, and this is cleaner than hacking</td></tr>
+<tr><td class="h"><a name="1641"></a>1641</td><td></td><td></td><td></td><td></td><td class="s"> # _construct_object to survive the approach</td></tr>
+<tr><td class="h"><a name="1642"></a>1642</td><td></td><td></td><td></td><td></td><td class="s"> $self->cursor->reset;</td></tr>
+<tr><td class="h"><a name="1643"></a>1643</td><td></td><td></td><td></td><td></td><td class="s"> my @row = $self->cursor->next;</td></tr>
+<tr><td class="h"><a name="1644"></a>1644</td><td></td><td></td><td></td><td></td><td class="s"> while (@row) {</td></tr>
+<tr><td class="h"><a name="1645"></a>1645</td><td></td><td></td><td></td><td></td><td class="s"> push(@obj, $self->_construct_object(@row));</td></tr>
+<tr><td class="h"><a name="1646"></a>1646</td><td></td><td></td><td></td><td></td><td class="s"> @row = (exists $self->{stashed_row}</td></tr>
+<tr><td class="h"><a name="1647"></a>1647</td><td></td><td></td><td></td><td></td><td class="s"> ? @{delete $self->{stashed_row}}</td></tr>
+<tr><td class="h"><a name="1648"></a>1648</td><td></td><td></td><td></td><td></td><td class="s"> : $self->cursor->next);</td></tr>
+<tr><td class="h"><a name="1649"></a>1649</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1650"></a>1650</td><td></td><td></td><td></td><td></td><td class="s"> } else {</td></tr>
+<tr><td class="h"><a name="1651"></a>1651</td><td></td><td></td><td></td><td></td><td class="s"> @obj = map { $self->_construct_object(@$_) } $self->cursor->all;</td></tr>
+<tr><td class="h"><a name="1652"></a>1652</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1653"></a>1653</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1654"></a>1654</td><td></td><td></td><td></td><td></td><td class="s"> $self->set_cache(\@obj) if $self->{attrs}{cache};</td></tr>
+<tr><td class="h"><a name="1655"></a>1655</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1656"></a>1656</td><td></td><td></td><td></td><td></td><td class="s"> return @obj;</td></tr>
+<tr><td class="h"><a name="1657"></a>1657</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="1658"></a>1658</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1659"></a>1659</td><td></td><td></td><td></td><td></td><td class="s">=head2 reset</td></tr>
+<tr><td class="h"><a name="1660"></a>1660</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1661"></a>1661</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="1662"></a>1662</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1663"></a>1663</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: none</td></tr>
+<tr><td class="h"><a name="1664"></a>1664</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1665"></a>1665</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $self</td></tr>
+<tr><td class="h"><a name="1666"></a>1666</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1667"></a>1667</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="1668"></a>1668</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1669"></a>1669</td><td></td><td></td><td></td><td></td><td class="s">Resets the resultset's cursor, so you can iterate through the elements again.</td></tr>
+<tr><td class="h"><a name="1670"></a>1670</td><td></td><td></td><td></td><td></td><td class="s">Implicitly resets the storage cursor, so a subsequent L</next> will trigger</td></tr>
+<tr><td class="h"><a name="1671"></a>1671</td><td></td><td></td><td></td><td></td><td class="s">another query.</td></tr>
+<tr><td class="h"><a name="1672"></a>1672</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1673"></a>1673</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="1674"></a>1674</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1675"></a>1675</td><td></td><td></td><td></td><td></td><td class="s">sub reset {</td></tr>
+<tr><td class="h"><a name="1676"></a>1676</td><td></td><td></td><td></td><td></td><td class="s"> my ($self) = @_;</td></tr>
+<tr><td class="h"><a name="1677"></a>1677</td><td></td><td></td><td></td><td></td><td class="s"> delete $self->{_attrs} if exists $self->{_attrs};</td></tr>
+<tr><td class="h"><a name="1678"></a>1678</td><td></td><td></td><td></td><td></td><td class="s"> $self->{all_cache_position} = 0;</td></tr>
+<tr><td class="h"><a name="1679"></a>1679</td><td></td><td></td><td></td><td></td><td class="s"> $self->cursor->reset;</td></tr>
+<tr><td class="h"><a name="1680"></a>1680</td><td></td><td></td><td></td><td></td><td class="s"> return $self;</td></tr>
+<tr><td class="h"><a name="1681"></a>1681</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="1682"></a>1682</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1683"></a>1683</td><td></td><td></td><td></td><td></td><td class="s">=head2 first</td></tr>
+<tr><td class="h"><a name="1684"></a>1684</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1685"></a>1685</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="1686"></a>1686</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1687"></a>1687</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: none</td></tr>
+<tr><td class="h"><a name="1688"></a>1688</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1689"></a>1689</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $object | undef</td></tr>
+<tr><td class="h"><a name="1690"></a>1690</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1691"></a>1691</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="1692"></a>1692</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1693"></a>1693</td><td></td><td></td><td></td><td></td><td class="s">Resets the resultset and returns an object for the first result (or C<undef></td></tr>
+<tr><td class="h"><a name="1694"></a>1694</td><td></td><td></td><td></td><td></td><td class="s">if the resultset is empty).</td></tr>
+<tr><td class="h"><a name="1695"></a>1695</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1696"></a>1696</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="1697"></a>1697</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1698"></a>1698</td><td></td><td></td><td></td><td></td><td class="s">sub first {</td></tr>
+<tr><td class="h"><a name="1699"></a>1699</td><td></td><td></td><td></td><td></td><td class="s"> return $_[0]->reset->next;</td></tr>
+<tr><td class="h"><a name="1700"></a>1700</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="1701"></a>1701</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1702"></a>1702</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1703"></a>1703</td><td></td><td></td><td></td><td></td><td class="s"># _rs_update_delete</td></tr>
+<tr><td class="h"><a name="1704"></a>1704</td><td></td><td></td><td></td><td></td><td class="s">#</td></tr>
+<tr><td class="h"><a name="1705"></a>1705</td><td></td><td></td><td></td><td></td><td class="s"># Determines whether and what type of subquery is required for the $rs operation.</td></tr>
+<tr><td class="h"><a name="1706"></a>1706</td><td></td><td></td><td></td><td></td><td class="s"># If grouping is necessary either supplies its own, or verifies the current one</td></tr>
+<tr><td class="h"><a name="1707"></a>1707</td><td></td><td></td><td></td><td></td><td class="s"># After all is done delegates to the proper storage method.</td></tr>
+<tr><td class="h"><a name="1708"></a>1708</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1709"></a>1709</td><td></td><td></td><td></td><td></td><td class="s">sub _rs_update_delete {</td></tr>
+<tr><td class="h"><a name="1710"></a>1710</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $op, $values) = @_;</td></tr>
+<tr><td class="h"><a name="1711"></a>1711</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1712"></a>1712</td><td></td><td></td><td></td><td></td><td class="s"> my $rsrc = $self->result_source;</td></tr>
+<tr><td class="h"><a name="1713"></a>1713</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1714"></a>1714</td><td></td><td></td><td></td><td></td><td class="s"> my $needs_group_by_subq = $self->_has_resolved_attr (qw/collapse group_by -join/);</td></tr>
+<tr><td class="h"><a name="1715"></a>1715</td><td></td><td></td><td></td><td></td><td class="s"> my $needs_subq = $needs_group_by_subq || $self->_has_resolved_attr(qw/rows offset/);</td></tr>
+<tr><td class="h"><a name="1716"></a>1716</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1717"></a>1717</td><td></td><td></td><td></td><td></td><td class="s"> if ($needs_group_by_subq or $needs_subq) {</td></tr>
+<tr><td class="h"><a name="1718"></a>1718</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1719"></a>1719</td><td></td><td></td><td></td><td></td><td class="s"> # make a new $rs selecting only the PKs (that's all we really need)</td></tr>
+<tr><td class="h"><a name="1720"></a>1720</td><td></td><td></td><td></td><td></td><td class="s"> my $attrs = $self->_resolved_attrs_copy;</td></tr>
+<tr><td class="h"><a name="1721"></a>1721</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1722"></a>1722</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1723"></a>1723</td><td></td><td></td><td></td><td></td><td class="s"> delete $attrs->{$_} for qw/collapse _collapse_order_by select _prefetch_selector_range as/;</td></tr>
+<tr><td class="h"><a name="1724"></a>1724</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{columns} = [ map { "$attrs->{alias}.$_" } ($self->result_source->_pri_cols) ];</td></tr>
+<tr><td class="h"><a name="1725"></a>1725</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1726"></a>1726</td><td></td><td></td><td></td><td></td><td class="s"> if ($needs_group_by_subq) {</td></tr>
+<tr><td class="h"><a name="1727"></a>1727</td><td></td><td></td><td></td><td></td><td class="s"> # make sure no group_by was supplied, or if there is one - make sure it matches</td></tr>
+<tr><td class="h"><a name="1728"></a>1728</td><td></td><td></td><td></td><td></td><td class="s"> # the columns compiled above perfectly. Anything else can not be sanely executed</td></tr>
+<tr><td class="h"><a name="1729"></a>1729</td><td></td><td></td><td></td><td></td><td class="s"> # on most databases so croak right then and there</td></tr>
+<tr><td class="h"><a name="1730"></a>1730</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1731"></a>1731</td><td></td><td></td><td></td><td></td><td class="s"> if (my $g = $attrs->{group_by}) {</td></tr>
+<tr><td class="h"><a name="1732"></a>1732</td><td></td><td></td><td></td><td></td><td class="s"> my @current_group_by = map</td></tr>
+<tr><td class="h"><a name="1733"></a>1733</td><td></td><td></td><td></td><td></td><td class="s"> { $_ =~ /\./ ? $_ : "$attrs->{alias}.$_" }</td></tr>
+<tr><td class="h"><a name="1734"></a>1734</td><td></td><td></td><td></td><td></td><td class="s"> @$g</td></tr>
+<tr><td class="h"><a name="1735"></a>1735</td><td></td><td></td><td></td><td></td><td class="s"> ;</td></tr>
+<tr><td class="h"><a name="1736"></a>1736</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1737"></a>1737</td><td></td><td></td><td></td><td></td><td class="s"> if (</td></tr>
+<tr><td class="h"><a name="1738"></a>1738</td><td></td><td></td><td></td><td></td><td class="s"> join ("\x00", sort @current_group_by)</td></tr>
+<tr><td class="h"><a name="1739"></a>1739</td><td></td><td></td><td></td><td></td><td class="s"> ne</td></tr>
+<tr><td class="h"><a name="1740"></a>1740</td><td></td><td></td><td></td><td></td><td class="s"> join ("\x00", sort @{$attrs->{columns}} )</td></tr>
+<tr><td class="h"><a name="1741"></a>1741</td><td></td><td></td><td></td><td></td><td class="s"> ) {</td></tr>
+<tr><td class="h"><a name="1742"></a>1742</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception (</td></tr>
+<tr><td class="h"><a name="1743"></a>1743</td><td></td><td></td><td></td><td></td><td class="s"> "You have just attempted a $op operation on a resultset which does group_by"</td></tr>
+<tr><td class="h"><a name="1744"></a>1744</td><td></td><td></td><td></td><td></td><td class="s"> . ' on columns other than the primary keys, while DBIC internally needs to retrieve'</td></tr>
+<tr><td class="h"><a name="1745"></a>1745</td><td></td><td></td><td></td><td></td><td class="s"> . ' the primary keys in a subselect. All sane RDBMS engines do not support this'</td></tr>
+<tr><td class="h"><a name="1746"></a>1746</td><td></td><td></td><td></td><td></td><td class="s"> . ' kind of queries. Please retry the operation with a modified group_by or'</td></tr>
+<tr><td class="h"><a name="1747"></a>1747</td><td></td><td></td><td></td><td></td><td class="s"> . ' without using one at all.'</td></tr>
+<tr><td class="h"><a name="1748"></a>1748</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="1749"></a>1749</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1750"></a>1750</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1751"></a>1751</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="1752"></a>1752</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{group_by} = $attrs->{columns};</td></tr>
+<tr><td class="h"><a name="1753"></a>1753</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1754"></a>1754</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1755"></a>1755</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1756"></a>1756</td><td></td><td></td><td></td><td></td><td class="s"> my $subrs = (ref $self)->new($rsrc, $attrs);</td></tr>
+<tr><td class="h"><a name="1757"></a>1757</td><td></td><td></td><td></td><td></td><td class="s"> return $self->result_source->storage->_subq_update_delete($subrs, $op, $values);</td></tr>
+<tr><td class="h"><a name="1758"></a>1758</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1759"></a>1759</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="1760"></a>1760</td><td></td><td></td><td></td><td></td><td class="s"> # Most databases do not allow aliasing of tables in UPDATE/DELETE. Thus</td></tr>
+<tr><td class="h"><a name="1761"></a>1761</td><td></td><td></td><td></td><td></td><td class="s"> # a condition containing 'me' or other table prefixes will not work</td></tr>
+<tr><td class="h"><a name="1762"></a>1762</td><td></td><td></td><td></td><td></td><td class="s"> # at all. What this code tries to do (badly) is to generate a condition</td></tr>
+<tr><td class="h"><a name="1763"></a>1763</td><td></td><td></td><td></td><td></td><td class="s"> # with the qualifiers removed, by exploiting the quote mechanism of sqla</td></tr>
+<tr><td class="h"><a name="1764"></a>1764</td><td></td><td></td><td></td><td></td><td class="s"> #</td></tr>
+<tr><td class="h"><a name="1765"></a>1765</td><td></td><td></td><td></td><td></td><td class="s"> # this is atrocious and should be replaced by normal sqla introspection</td></tr>
+<tr><td class="h"><a name="1766"></a>1766</td><td></td><td></td><td></td><td></td><td class="s"> # one sunny day</td></tr>
+<tr><td class="h"><a name="1767"></a>1767</td><td></td><td></td><td></td><td></td><td class="s"> my ($sql, @bind) = do {</td></tr>
+<tr><td class="h"><a name="1768"></a>1768</td><td></td><td></td><td></td><td></td><td class="s"> my $sqla = $rsrc->storage->sql_maker;</td></tr>
+<tr><td class="h"><a name="1769"></a>1769</td><td></td><td></td><td></td><td></td><td class="s"> local $sqla->{_dequalify_idents} = 1;</td></tr>
+<tr><td class="h"><a name="1770"></a>1770</td><td></td><td></td><td></td><td></td><td class="s"> $sqla->_recurse_where($self->{cond});</td></tr>
+<tr><td class="h"><a name="1771"></a>1771</td><td></td><td></td><td></td><td></td><td class="s"> } if $self->{cond};</td></tr>
+<tr><td class="h"><a name="1772"></a>1772</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1773"></a>1773</td><td></td><td></td><td></td><td></td><td class="s"> return $rsrc->storage->$op(</td></tr>
+<tr><td class="h"><a name="1774"></a>1774</td><td></td><td></td><td></td><td></td><td class="s"> $rsrc,</td></tr>
+<tr><td class="h"><a name="1775"></a>1775</td><td></td><td></td><td></td><td></td><td class="s"> $op eq 'update' ? $values : (),</td></tr>
+<tr><td class="h"><a name="1776"></a>1776</td><td></td><td></td><td></td><td></td><td class="s"> $self->{cond} ? \[$sql, @bind] : (),</td></tr>
+<tr><td class="h"><a name="1777"></a>1777</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="1778"></a>1778</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1779"></a>1779</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="1780"></a>1780</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1781"></a>1781</td><td></td><td></td><td></td><td></td><td class="s">=head2 update</td></tr>
+<tr><td class="h"><a name="1782"></a>1782</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1783"></a>1783</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="1784"></a>1784</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1785"></a>1785</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: \%values</td></tr>
+<tr><td class="h"><a name="1786"></a>1786</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1787"></a>1787</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $storage_rv</td></tr>
+<tr><td class="h"><a name="1788"></a>1788</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1789"></a>1789</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="1790"></a>1790</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1791"></a>1791</td><td></td><td></td><td></td><td></td><td class="s">Sets the specified columns in the resultset to the supplied values in a</td></tr>
+<tr><td class="h"><a name="1792"></a>1792</td><td></td><td></td><td></td><td></td><td class="s">single query. Note that this will not run any accessor/set_column/update</td></tr>
+<tr><td class="h"><a name="1793"></a>1793</td><td></td><td></td><td></td><td></td><td class="s">triggers, nor will it update any row object instances derived from this</td></tr>
+<tr><td class="h"><a name="1794"></a>1794</td><td></td><td></td><td></td><td></td><td class="s">resultset (this includes the contents of the L<resultset cache|/set_cache></td></tr>
+<tr><td class="h"><a name="1795"></a>1795</td><td></td><td></td><td></td><td></td><td class="s">if any). See L</update_all> if you need to execute any on-update</td></tr>
+<tr><td class="h"><a name="1796"></a>1796</td><td></td><td></td><td></td><td></td><td class="s">triggers or cascades defined either by you or a</td></tr>
+<tr><td class="h"><a name="1797"></a>1797</td><td></td><td></td><td></td><td></td><td class="s">L<result component|DBIx::Class::Manual::Component/WHAT_IS_A_COMPONENT>.</td></tr>
+<tr><td class="h"><a name="1798"></a>1798</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1799"></a>1799</td><td></td><td></td><td></td><td></td><td class="s">The return value is a pass through of what the underlying</td></tr>
+<tr><td class="h"><a name="1800"></a>1800</td><td></td><td></td><td></td><td></td><td class="s">storage backend returned, and may vary. See L<DBI/execute> for the most</td></tr>
+<tr><td class="h"><a name="1801"></a>1801</td><td></td><td></td><td></td><td></td><td class="s">common case.</td></tr>
+<tr><td class="h"><a name="1802"></a>1802</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1803"></a>1803</td><td></td><td></td><td></td><td></td><td class="s">=head3 CAVEAT</td></tr>
+<tr><td class="h"><a name="1804"></a>1804</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1805"></a>1805</td><td></td><td></td><td></td><td></td><td class="s">Note that L</update> does not process/deflate any of the values passed in.</td></tr>
+<tr><td class="h"><a name="1806"></a>1806</td><td></td><td></td><td></td><td></td><td class="s">This is unlike the corresponding L<DBIx::Class::Row/update>. The user must</td></tr>
+<tr><td class="h"><a name="1807"></a>1807</td><td></td><td></td><td></td><td></td><td class="s">ensure manually that any value passed to this method will stringify to</td></tr>
+<tr><td class="h"><a name="1808"></a>1808</td><td></td><td></td><td></td><td></td><td class="s">something the RDBMS knows how to deal with. A notable example is the</td></tr>
+<tr><td class="h"><a name="1809"></a>1809</td><td></td><td></td><td></td><td></td><td class="s">handling of L<DateTime> objects, for more info see:</td></tr>
+<tr><td class="h"><a name="1810"></a>1810</td><td></td><td></td><td></td><td></td><td class="s">L<DBIx::Class::Manual::Cookbook/Formatting_DateTime_objects_in_queries>.</td></tr>
+<tr><td class="h"><a name="1811"></a>1811</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1812"></a>1812</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="1813"></a>1813</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1814"></a>1814</td><td></td><td></td><td></td><td></td><td class="s">sub update {</td></tr>
+<tr><td class="h"><a name="1815"></a>1815</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $values) = @_;</td></tr>
+<tr><td class="h"><a name="1816"></a>1816</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception('Values for update must be a hash')</td></tr>
+<tr><td class="h"><a name="1817"></a>1817</td><td></td><td></td><td></td><td></td><td class="s"> unless ref $values eq 'HASH';</td></tr>
+<tr><td class="h"><a name="1818"></a>1818</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1819"></a>1819</td><td></td><td></td><td></td><td></td><td class="s"> return $self->_rs_update_delete ('update', $values);</td></tr>
+<tr><td class="h"><a name="1820"></a>1820</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="1821"></a>1821</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1822"></a>1822</td><td></td><td></td><td></td><td></td><td class="s">=head2 update_all</td></tr>
+<tr><td class="h"><a name="1823"></a>1823</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1824"></a>1824</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="1825"></a>1825</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1826"></a>1826</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: \%values</td></tr>
+<tr><td class="h"><a name="1827"></a>1827</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1828"></a>1828</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: 1</td></tr>
+<tr><td class="h"><a name="1829"></a>1829</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1830"></a>1830</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="1831"></a>1831</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1832"></a>1832</td><td></td><td></td><td></td><td></td><td class="s">Fetches all objects and updates them one at a time via</td></tr>
+<tr><td class="h"><a name="1833"></a>1833</td><td></td><td></td><td></td><td></td><td class="s">L<DBIx::Class::Row/update>. Note that C<update_all> will run DBIC defined</td></tr>
+<tr><td class="h"><a name="1834"></a>1834</td><td></td><td></td><td></td><td></td><td class="s">triggers, while L</update> will not.</td></tr>
+<tr><td class="h"><a name="1835"></a>1835</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1836"></a>1836</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="1837"></a>1837</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1838"></a>1838</td><td></td><td></td><td></td><td></td><td class="s">sub update_all {</td></tr>
+<tr><td class="h"><a name="1839"></a>1839</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $values) = @_;</td></tr>
+<tr><td class="h"><a name="1840"></a>1840</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception('Values for update_all must be a hash')</td></tr>
+<tr><td class="h"><a name="1841"></a>1841</td><td></td><td></td><td></td><td></td><td class="s"> unless ref $values eq 'HASH';</td></tr>
+<tr><td class="h"><a name="1842"></a>1842</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1843"></a>1843</td><td></td><td></td><td></td><td></td><td class="s"> my $guard = $self->result_source->schema->txn_scope_guard;</td></tr>
+<tr><td class="h"><a name="1844"></a>1844</td><td></td><td></td><td></td><td></td><td class="s"> $_->update({%$values}) for $self->all; # shallow copy - update will mangle it</td></tr>
+<tr><td class="h"><a name="1845"></a>1845</td><td></td><td></td><td></td><td></td><td class="s"> $guard->commit;</td></tr>
+<tr><td class="h"><a name="1846"></a>1846</td><td></td><td></td><td></td><td></td><td class="s"> return 1;</td></tr>
+<tr><td class="h"><a name="1847"></a>1847</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="1848"></a>1848</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1849"></a>1849</td><td></td><td></td><td></td><td></td><td class="s">=head2 delete</td></tr>
+<tr><td class="h"><a name="1850"></a>1850</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1851"></a>1851</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="1852"></a>1852</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1853"></a>1853</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: none</td></tr>
+<tr><td class="h"><a name="1854"></a>1854</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1855"></a>1855</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $storage_rv</td></tr>
+<tr><td class="h"><a name="1856"></a>1856</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1857"></a>1857</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="1858"></a>1858</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1859"></a>1859</td><td></td><td></td><td></td><td></td><td class="s">Deletes the rows matching this resultset in a single query. Note that this</td></tr>
+<tr><td class="h"><a name="1860"></a>1860</td><td></td><td></td><td></td><td></td><td class="s">will not run any delete triggers, nor will it alter the</td></tr>
+<tr><td class="h"><a name="1861"></a>1861</td><td></td><td></td><td></td><td></td><td class="s">L<in_storage|DBIx::Class::Row/in_storage> status of any row object instances</td></tr>
+<tr><td class="h"><a name="1862"></a>1862</td><td></td><td></td><td></td><td></td><td class="s">derived from this resultset (this includes the contents of the</td></tr>
+<tr><td class="h"><a name="1863"></a>1863</td><td></td><td></td><td></td><td></td><td class="s">L<resultset cache|/set_cache> if any). See L</delete_all> if you need to</td></tr>
+<tr><td class="h"><a name="1864"></a>1864</td><td></td><td></td><td></td><td></td><td class="s">execute any on-delete triggers or cascades defined either by you or a</td></tr>
+<tr><td class="h"><a name="1865"></a>1865</td><td></td><td></td><td></td><td></td><td class="s">L<result component|DBIx::Class::Manual::Component/WHAT_IS_A_COMPONENT>.</td></tr>
+<tr><td class="h"><a name="1866"></a>1866</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1867"></a>1867</td><td></td><td></td><td></td><td></td><td class="s">The return value is a pass through of what the underlying storage backend</td></tr>
+<tr><td class="h"><a name="1868"></a>1868</td><td></td><td></td><td></td><td></td><td class="s">returned, and may vary. See L<DBI/execute> for the most common case.</td></tr>
+<tr><td class="h"><a name="1869"></a>1869</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1870"></a>1870</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="1871"></a>1871</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1872"></a>1872</td><td></td><td></td><td></td><td></td><td class="s">sub delete {</td></tr>
+<tr><td class="h"><a name="1873"></a>1873</td><td></td><td></td><td></td><td></td><td class="s"> my $self = shift;</td></tr>
+<tr><td class="h"><a name="1874"></a>1874</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception('delete does not accept any arguments')</td></tr>
+<tr><td class="h"><a name="1875"></a>1875</td><td></td><td></td><td></td><td></td><td class="s"> if @_;</td></tr>
+<tr><td class="h"><a name="1876"></a>1876</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1877"></a>1877</td><td></td><td></td><td></td><td></td><td class="s"> return $self->_rs_update_delete ('delete');</td></tr>
+<tr><td class="h"><a name="1878"></a>1878</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="1879"></a>1879</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1880"></a>1880</td><td></td><td></td><td></td><td></td><td class="s">=head2 delete_all</td></tr>
+<tr><td class="h"><a name="1881"></a>1881</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1882"></a>1882</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="1883"></a>1883</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1884"></a>1884</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: none</td></tr>
+<tr><td class="h"><a name="1885"></a>1885</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1886"></a>1886</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: 1</td></tr>
+<tr><td class="h"><a name="1887"></a>1887</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1888"></a>1888</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="1889"></a>1889</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1890"></a>1890</td><td></td><td></td><td></td><td></td><td class="s">Fetches all objects and deletes them one at a time via</td></tr>
+<tr><td class="h"><a name="1891"></a>1891</td><td></td><td></td><td></td><td></td><td class="s">L<DBIx::Class::Row/delete>. Note that C<delete_all> will run DBIC defined</td></tr>
+<tr><td class="h"><a name="1892"></a>1892</td><td></td><td></td><td></td><td></td><td class="s">triggers, while L</delete> will not.</td></tr>
+<tr><td class="h"><a name="1893"></a>1893</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1894"></a>1894</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="1895"></a>1895</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1896"></a>1896</td><td></td><td></td><td></td><td></td><td class="s">sub delete_all {</td></tr>
+<tr><td class="h"><a name="1897"></a>1897</td><td></td><td></td><td></td><td></td><td class="s"> my $self = shift;</td></tr>
+<tr><td class="h"><a name="1898"></a>1898</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception('delete_all does not accept any arguments')</td></tr>
+<tr><td class="h"><a name="1899"></a>1899</td><td></td><td></td><td></td><td></td><td class="s"> if @_;</td></tr>
+<tr><td class="h"><a name="1900"></a>1900</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1901"></a>1901</td><td></td><td></td><td></td><td></td><td class="s"> my $guard = $self->result_source->schema->txn_scope_guard;</td></tr>
+<tr><td class="h"><a name="1902"></a>1902</td><td></td><td></td><td></td><td></td><td class="s"> $_->delete for $self->all;</td></tr>
+<tr><td class="h"><a name="1903"></a>1903</td><td></td><td></td><td></td><td></td><td class="s"> $guard->commit;</td></tr>
+<tr><td class="h"><a name="1904"></a>1904</td><td></td><td></td><td></td><td></td><td class="s"> return 1;</td></tr>
+<tr><td class="h"><a name="1905"></a>1905</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="1906"></a>1906</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1907"></a>1907</td><td></td><td></td><td></td><td></td><td class="s">=head2 populate</td></tr>
+<tr><td class="h"><a name="1908"></a>1908</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1909"></a>1909</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="1910"></a>1910</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1911"></a>1911</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: \@data;</td></tr>
+<tr><td class="h"><a name="1912"></a>1912</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1913"></a>1913</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="1914"></a>1914</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1915"></a>1915</td><td></td><td></td><td></td><td></td><td class="s">Accepts either an arrayref of hashrefs or alternatively an arrayref of arrayrefs.</td></tr>
+<tr><td class="h"><a name="1916"></a>1916</td><td></td><td></td><td></td><td></td><td class="s">For the arrayref of hashrefs style each hashref should be a structure suitable</td></tr>
+<tr><td class="h"><a name="1917"></a>1917</td><td></td><td></td><td></td><td></td><td class="s">for submitting to a $resultset->create(...) method.</td></tr>
+<tr><td class="h"><a name="1918"></a>1918</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1919"></a>1919</td><td></td><td></td><td></td><td></td><td class="s">In void context, C<insert_bulk> in L<DBIx::Class::Storage::DBI> is used</td></tr>
+<tr><td class="h"><a name="1920"></a>1920</td><td></td><td></td><td></td><td></td><td class="s">to insert the data, as this is a faster method.</td></tr>
+<tr><td class="h"><a name="1921"></a>1921</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1922"></a>1922</td><td></td><td></td><td></td><td></td><td class="s">Otherwise, each set of data is inserted into the database using</td></tr>
+<tr><td class="h"><a name="1923"></a>1923</td><td></td><td></td><td></td><td></td><td class="s">L<DBIx::Class::ResultSet/create>, and the resulting objects are</td></tr>
+<tr><td class="h"><a name="1924"></a>1924</td><td></td><td></td><td></td><td></td><td class="s">accumulated into an array. The array itself, or an array reference</td></tr>
+<tr><td class="h"><a name="1925"></a>1925</td><td></td><td></td><td></td><td></td><td class="s">is returned depending on scalar or list context.</td></tr>
+<tr><td class="h"><a name="1926"></a>1926</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1927"></a>1927</td><td></td><td></td><td></td><td></td><td class="s">Example: Assuming an Artist Class that has many CDs Classes relating:</td></tr>
+<tr><td class="h"><a name="1928"></a>1928</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1929"></a>1929</td><td></td><td></td><td></td><td></td><td class="s"> my $Artist_rs = $schema->resultset("Artist");</td></tr>
+<tr><td class="h"><a name="1930"></a>1930</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1931"></a>1931</td><td></td><td></td><td></td><td></td><td class="s"> ## Void Context Example</td></tr>
+<tr><td class="h"><a name="1932"></a>1932</td><td></td><td></td><td></td><td></td><td class="s"> $Artist_rs->populate([</td></tr>
+<tr><td class="h"><a name="1933"></a>1933</td><td></td><td></td><td></td><td></td><td class="s"> { artistid => 4, name => 'Manufactured Crap', cds => [</td></tr>
+<tr><td class="h"><a name="1934"></a>1934</td><td></td><td></td><td></td><td></td><td class="s"> { title => 'My First CD', year => 2006 },</td></tr>
+<tr><td class="h"><a name="1935"></a>1935</td><td></td><td></td><td></td><td></td><td class="s"> { title => 'Yet More Tweeny-Pop crap', year => 2007 },</td></tr>
+<tr><td class="h"><a name="1936"></a>1936</td><td></td><td></td><td></td><td></td><td class="s"> ],</td></tr>
+<tr><td class="h"><a name="1937"></a>1937</td><td></td><td></td><td></td><td></td><td class="s"> },</td></tr>
+<tr><td class="h"><a name="1938"></a>1938</td><td></td><td></td><td></td><td></td><td class="s"> { artistid => 5, name => 'Angsty-Whiny Girl', cds => [</td></tr>
+<tr><td class="h"><a name="1939"></a>1939</td><td></td><td></td><td></td><td></td><td class="s"> { title => 'My parents sold me to a record company', year => 2005 },</td></tr>
+<tr><td class="h"><a name="1940"></a>1940</td><td></td><td></td><td></td><td></td><td class="s"> { title => 'Why Am I So Ugly?', year => 2006 },</td></tr>
+<tr><td class="h"><a name="1941"></a>1941</td><td></td><td></td><td></td><td></td><td class="s"> { title => 'I Got Surgery and am now Popular', year => 2007 }</td></tr>
+<tr><td class="h"><a name="1942"></a>1942</td><td></td><td></td><td></td><td></td><td class="s"> ],</td></tr>
+<tr><td class="h"><a name="1943"></a>1943</td><td></td><td></td><td></td><td></td><td class="s"> },</td></tr>
+<tr><td class="h"><a name="1944"></a>1944</td><td></td><td></td><td></td><td></td><td class="s"> ]);</td></tr>
+<tr><td class="h"><a name="1945"></a>1945</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1946"></a>1946</td><td></td><td></td><td></td><td></td><td class="s"> ## Array Context Example</td></tr>
+<tr><td class="h"><a name="1947"></a>1947</td><td></td><td></td><td></td><td></td><td class="s"> my ($ArtistOne, $ArtistTwo, $ArtistThree) = $Artist_rs->populate([</td></tr>
+<tr><td class="h"><a name="1948"></a>1948</td><td></td><td></td><td></td><td></td><td class="s"> { name => "Artist One"},</td></tr>
+<tr><td class="h"><a name="1949"></a>1949</td><td></td><td></td><td></td><td></td><td class="s"> { name => "Artist Two"},</td></tr>
+<tr><td class="h"><a name="1950"></a>1950</td><td></td><td></td><td></td><td></td><td class="s"> { name => "Artist Three", cds=> [</td></tr>
+<tr><td class="h"><a name="1951"></a>1951</td><td></td><td></td><td></td><td></td><td class="s"> { title => "First CD", year => 2007},</td></tr>
+<tr><td class="h"><a name="1952"></a>1952</td><td></td><td></td><td></td><td></td><td class="s"> { title => "Second CD", year => 2008},</td></tr>
+<tr><td class="h"><a name="1953"></a>1953</td><td></td><td></td><td></td><td></td><td class="s"> ]}</td></tr>
+<tr><td class="h"><a name="1954"></a>1954</td><td></td><td></td><td></td><td></td><td class="s"> ]);</td></tr>
+<tr><td class="h"><a name="1955"></a>1955</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1956"></a>1956</td><td></td><td></td><td></td><td></td><td class="s"> print $ArtistOne->name; ## response is 'Artist One'</td></tr>
+<tr><td class="h"><a name="1957"></a>1957</td><td></td><td></td><td></td><td></td><td class="s"> print $ArtistThree->cds->count ## reponse is '2'</td></tr>
+<tr><td class="h"><a name="1958"></a>1958</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1959"></a>1959</td><td></td><td></td><td></td><td></td><td class="s">For the arrayref of arrayrefs style, the first element should be a list of the</td></tr>
+<tr><td class="h"><a name="1960"></a>1960</td><td></td><td></td><td></td><td></td><td class="s">fieldsnames to which the remaining elements are rows being inserted. For</td></tr>
+<tr><td class="h"><a name="1961"></a>1961</td><td></td><td></td><td></td><td></td><td class="s">example:</td></tr>
+<tr><td class="h"><a name="1962"></a>1962</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1963"></a>1963</td><td></td><td></td><td></td><td></td><td class="s"> $Arstist_rs->populate([</td></tr>
+<tr><td class="h"><a name="1964"></a>1964</td><td></td><td></td><td></td><td></td><td class="s"> [qw/artistid name/],</td></tr>
+<tr><td class="h"><a name="1965"></a>1965</td><td></td><td></td><td></td><td></td><td class="s"> [100, 'A Formally Unknown Singer'],</td></tr>
+<tr><td class="h"><a name="1966"></a>1966</td><td></td><td></td><td></td><td></td><td class="s"> [101, 'A singer that jumped the shark two albums ago'],</td></tr>
+<tr><td class="h"><a name="1967"></a>1967</td><td></td><td></td><td></td><td></td><td class="s"> [102, 'An actually cool singer'],</td></tr>
+<tr><td class="h"><a name="1968"></a>1968</td><td></td><td></td><td></td><td></td><td class="s"> ]);</td></tr>
+<tr><td class="h"><a name="1969"></a>1969</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1970"></a>1970</td><td></td><td></td><td></td><td></td><td class="s">Please note an important effect on your data when choosing between void and</td></tr>
+<tr><td class="h"><a name="1971"></a>1971</td><td></td><td></td><td></td><td></td><td class="s">wantarray context. Since void context goes straight to C<insert_bulk> in</td></tr>
+<tr><td class="h"><a name="1972"></a>1972</td><td></td><td></td><td></td><td></td><td class="s">L<DBIx::Class::Storage::DBI> this will skip any component that is overriding</td></tr>
+<tr><td class="h"><a name="1973"></a>1973</td><td></td><td></td><td></td><td></td><td class="s">C<insert>. So if you are using something like L<DBIx-Class-UUIDColumns> to</td></tr>
+<tr><td class="h"><a name="1974"></a>1974</td><td></td><td></td><td></td><td></td><td class="s">create primary keys for you, you will find that your PKs are empty. In this</td></tr>
+<tr><td class="h"><a name="1975"></a>1975</td><td></td><td></td><td></td><td></td><td class="s">case you will have to use the wantarray context in order to create those</td></tr>
+<tr><td class="h"><a name="1976"></a>1976</td><td></td><td></td><td></td><td></td><td class="s">values.</td></tr>
+<tr><td class="h"><a name="1977"></a>1977</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1978"></a>1978</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="1979"></a>1979</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1980"></a>1980</td><td></td><td></td><td></td><td></td><td class="s">sub populate {</td></tr>
+<tr><td class="h"><a name="1981"></a>1981</td><td></td><td></td><td></td><td></td><td class="s"> my $self = shift;</td></tr>
+<tr><td class="h"><a name="1982"></a>1982</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1983"></a>1983</td><td></td><td></td><td></td><td></td><td class="s"> # cruft placed in standalone method</td></tr>
+<tr><td class="h"><a name="1984"></a>1984</td><td></td><td></td><td></td><td></td><td class="s"> my $data = $self->_normalize_populate_args(@_);</td></tr>
+<tr><td class="h"><a name="1985"></a>1985</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1986"></a>1986</td><td></td><td></td><td></td><td></td><td class="s"> return unless @$data;</td></tr>
+<tr><td class="h"><a name="1987"></a>1987</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1988"></a>1988</td><td></td><td></td><td></td><td></td><td class="s"> if(defined wantarray) {</td></tr>
+<tr><td class="h"><a name="1989"></a>1989</td><td></td><td></td><td></td><td></td><td class="s"> my @created;</td></tr>
+<tr><td class="h"><a name="1990"></a>1990</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $item (@$data) {</td></tr>
+<tr><td class="h"><a name="1991"></a>1991</td><td></td><td></td><td></td><td></td><td class="s"> push(@created, $self->create($item));</td></tr>
+<tr><td class="h"><a name="1992"></a>1992</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="1993"></a>1993</td><td></td><td></td><td></td><td></td><td class="s"> return wantarray ? @created : \@created;</td></tr>
+<tr><td class="h"><a name="1994"></a>1994</td><td></td><td></td><td></td><td></td><td class="s"> } </td></tr>
+<tr><td class="h"><a name="1995"></a>1995</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="1996"></a>1996</td><td></td><td></td><td></td><td></td><td class="s"> my $first = $data->[0];</td></tr>
+<tr><td class="h"><a name="1997"></a>1997</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="1998"></a>1998</td><td></td><td></td><td></td><td></td><td class="s"> # if a column is a registered relationship, and is a non-blessed hash/array, consider</td></tr>
+<tr><td class="h"><a name="1999"></a>1999</td><td></td><td></td><td></td><td></td><td class="s"> # it relationship data</td></tr>
+<tr><td class="h"><a name="2000"></a>2000</td><td></td><td></td><td></td><td></td><td class="s"> my (@rels, @columns);</td></tr>
+<tr><td class="h"><a name="2001"></a>2001</td><td></td><td></td><td></td><td></td><td class="s"> my $rsrc = $self->result_source;</td></tr>
+<tr><td class="h"><a name="2002"></a>2002</td><td></td><td></td><td></td><td></td><td class="s"> my $rels = { map { $_ => $rsrc->relationship_info($_) } $rsrc->relationships };</td></tr>
+<tr><td class="h"><a name="2003"></a>2003</td><td></td><td></td><td></td><td></td><td class="s"> for (keys %$first) {</td></tr>
+<tr><td class="h"><a name="2004"></a>2004</td><td></td><td></td><td></td><td></td><td class="s"> my $ref = ref $first->{$_};</td></tr>
+<tr><td class="h"><a name="2005"></a>2005</td><td></td><td></td><td></td><td></td><td class="s"> $rels->{$_} && ($ref eq 'ARRAY' or $ref eq 'HASH')</td></tr>
+<tr><td class="h"><a name="2006"></a>2006</td><td></td><td></td><td></td><td></td><td class="s"> ? push @rels, $_</td></tr>
+<tr><td class="h"><a name="2007"></a>2007</td><td></td><td></td><td></td><td></td><td class="s"> : push @columns, $_</td></tr>
+<tr><td class="h"><a name="2008"></a>2008</td><td></td><td></td><td></td><td></td><td class="s"> ;</td></tr>
+<tr><td class="h"><a name="2009"></a>2009</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2010"></a>2010</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2011"></a>2011</td><td></td><td></td><td></td><td></td><td class="s"> my @pks = $rsrc->primary_columns;</td></tr>
+<tr><td class="h"><a name="2012"></a>2012</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2013"></a>2013</td><td></td><td></td><td></td><td></td><td class="s"> ## do the belongs_to relationships</td></tr>
+<tr><td class="h"><a name="2014"></a>2014</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $index (0..$#$data) {</td></tr>
+<tr><td class="h"><a name="2015"></a>2015</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2016"></a>2016</td><td></td><td></td><td></td><td></td><td class="s"> # delegate to create() for any dataset without primary keys with specified relationships</td></tr>
+<tr><td class="h"><a name="2017"></a>2017</td><td></td><td></td><td></td><td></td><td class="s"> if (grep { !defined $data->[$index]->{$_} } @pks ) {</td></tr>
+<tr><td class="h"><a name="2018"></a>2018</td><td></td><td></td><td></td><td></td><td class="s"> for my $r (@rels) {</td></tr>
+<tr><td class="h"><a name="2019"></a>2019</td><td></td><td></td><td></td><td></td><td class="s"> if (grep { ref $data->[$index]{$r} eq $_ } qw/HASH ARRAY/) { # a related set must be a HASH or AoH</td></tr>
+<tr><td class="h"><a name="2020"></a>2020</td><td></td><td></td><td></td><td></td><td class="s"> my @ret = $self->populate($data);</td></tr>
+<tr><td class="h"><a name="2021"></a>2021</td><td></td><td></td><td></td><td></td><td class="s"> return;</td></tr>
+<tr><td class="h"><a name="2022"></a>2022</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2023"></a>2023</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2024"></a>2024</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2025"></a>2025</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2026"></a>2026</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $rel (@rels) {</td></tr>
+<tr><td class="h"><a name="2027"></a>2027</td><td></td><td></td><td></td><td></td><td class="s"> next unless ref $data->[$index]->{$rel} eq "HASH";</td></tr>
+<tr><td class="h"><a name="2028"></a>2028</td><td></td><td></td><td></td><td></td><td class="s"> my $result = $self->related_resultset($rel)->create($data->[$index]->{$rel});</td></tr>
+<tr><td class="h"><a name="2029"></a>2029</td><td></td><td></td><td></td><td></td><td class="s"> my ($reverse_relname, $reverse_relinfo) = %{$rsrc->reverse_relationship_info($rel)};</td></tr>
+<tr><td class="h"><a name="2030"></a>2030</td><td></td><td></td><td></td><td></td><td class="s"> my $related = $result->result_source->_resolve_condition(</td></tr>
+<tr><td class="h"><a name="2031"></a>2031</td><td></td><td></td><td></td><td></td><td class="s"> $reverse_relinfo->{cond},</td></tr>
+<tr><td class="h"><a name="2032"></a>2032</td><td></td><td></td><td></td><td></td><td class="s"> $self,</td></tr>
+<tr><td class="h"><a name="2033"></a>2033</td><td></td><td></td><td></td><td></td><td class="s"> $result,</td></tr>
+<tr><td class="h"><a name="2034"></a>2034</td><td></td><td></td><td></td><td></td><td class="s"> $rel,</td></tr>
+<tr><td class="h"><a name="2035"></a>2035</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="2036"></a>2036</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2037"></a>2037</td><td></td><td></td><td></td><td></td><td class="s"> delete $data->[$index]->{$rel};</td></tr>
+<tr><td class="h"><a name="2038"></a>2038</td><td></td><td></td><td></td><td></td><td class="s"> $data->[$index] = {%{$data->[$index]}, %$related};</td></tr>
+<tr><td class="h"><a name="2039"></a>2039</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2040"></a>2040</td><td></td><td></td><td></td><td></td><td class="s"> push @columns, keys %$related if $index == 0;</td></tr>
+<tr><td class="h"><a name="2041"></a>2041</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2042"></a>2042</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2043"></a>2043</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2044"></a>2044</td><td></td><td></td><td></td><td></td><td class="s"> ## inherit the data locked in the conditions of the resultset</td></tr>
+<tr><td class="h"><a name="2045"></a>2045</td><td></td><td></td><td></td><td></td><td class="s"> my ($rs_data) = $self->_merge_with_rscond({});</td></tr>
+<tr><td class="h"><a name="2046"></a>2046</td><td></td><td></td><td></td><td></td><td class="s"> delete @{$rs_data}{@columns};</td></tr>
+<tr><td class="h"><a name="2047"></a>2047</td><td></td><td></td><td></td><td></td><td class="s"> my @inherit_cols = keys %$rs_data;</td></tr>
+<tr><td class="h"><a name="2048"></a>2048</td><td></td><td></td><td></td><td></td><td class="s"> my @inherit_data = values %$rs_data;</td></tr>
+<tr><td class="h"><a name="2049"></a>2049</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2050"></a>2050</td><td></td><td></td><td></td><td></td><td class="s"> ## do bulk insert on current row</td></tr>
+<tr><td class="h"><a name="2051"></a>2051</td><td></td><td></td><td></td><td></td><td class="s"> $rsrc->storage->insert_bulk(</td></tr>
+<tr><td class="h"><a name="2052"></a>2052</td><td></td><td></td><td></td><td></td><td class="s"> $rsrc,</td></tr>
+<tr><td class="h"><a name="2053"></a>2053</td><td></td><td></td><td></td><td></td><td class="s"> [@columns, @inherit_cols],</td></tr>
+<tr><td class="h"><a name="2054"></a>2054</td><td></td><td></td><td></td><td></td><td class="s"> [ map { [ @$_{@columns}, @inherit_data ] } @$data ],</td></tr>
+<tr><td class="h"><a name="2055"></a>2055</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="2056"></a>2056</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2057"></a>2057</td><td></td><td></td><td></td><td></td><td class="s"> ## do the has_many relationships</td></tr>
+<tr><td class="h"><a name="2058"></a>2058</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $item (@$data) {</td></tr>
+<tr><td class="h"><a name="2059"></a>2059</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2060"></a>2060</td><td></td><td></td><td></td><td></td><td class="s"> my $main_row;</td></tr>
+<tr><td class="h"><a name="2061"></a>2061</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2062"></a>2062</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $rel (@rels) {</td></tr>
+<tr><td class="h"><a name="2063"></a>2063</td><td></td><td></td><td></td><td></td><td class="s"> next unless ref $item->{$rel} eq "ARRAY" && @{ $item->{$rel} };</td></tr>
+<tr><td class="h"><a name="2064"></a>2064</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2065"></a>2065</td><td></td><td></td><td></td><td></td><td class="s"> $main_row ||= $self->new_result({map { $_ => $item->{$_} } @pks});</td></tr>
+<tr><td class="h"><a name="2066"></a>2066</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2067"></a>2067</td><td></td><td></td><td></td><td></td><td class="s"> my $child = $main_row->$rel;</td></tr>
+<tr><td class="h"><a name="2068"></a>2068</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2069"></a>2069</td><td></td><td></td><td></td><td></td><td class="s"> my $related = $child->result_source->_resolve_condition(</td></tr>
+<tr><td class="h"><a name="2070"></a>2070</td><td></td><td></td><td></td><td></td><td class="s"> $rels->{$rel}{cond},</td></tr>
+<tr><td class="h"><a name="2071"></a>2071</td><td></td><td></td><td></td><td></td><td class="s"> $child,</td></tr>
+<tr><td class="h"><a name="2072"></a>2072</td><td></td><td></td><td></td><td></td><td class="s"> $main_row,</td></tr>
+<tr><td class="h"><a name="2073"></a>2073</td><td></td><td></td><td></td><td></td><td class="s"> $rel,</td></tr>
+<tr><td class="h"><a name="2074"></a>2074</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="2075"></a>2075</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2076"></a>2076</td><td></td><td></td><td></td><td></td><td class="s"> my @rows_to_add = ref $item->{$rel} eq 'ARRAY' ? @{$item->{$rel}} : ($item->{$rel});</td></tr>
+<tr><td class="h"><a name="2077"></a>2077</td><td></td><td></td><td></td><td></td><td class="s"> my @populate = map { {%$_, %$related} } @rows_to_add;</td></tr>
+<tr><td class="h"><a name="2078"></a>2078</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2079"></a>2079</td><td></td><td></td><td></td><td></td><td class="s"> $child->populate( \@populate );</td></tr>
+<tr><td class="h"><a name="2080"></a>2080</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2081"></a>2081</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2082"></a>2082</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2083"></a>2083</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="2084"></a>2084</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2085"></a>2085</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2086"></a>2086</td><td></td><td></td><td></td><td></td><td class="s"># populate() argumnets went over several incarnations</td></tr>
+<tr><td class="h"><a name="2087"></a>2087</td><td></td><td></td><td></td><td></td><td class="s"># What we ultimately support is AoH</td></tr>
+<tr><td class="h"><a name="2088"></a>2088</td><td></td><td></td><td></td><td></td><td class="s">sub _normalize_populate_args {</td></tr>
+<tr><td class="h"><a name="2089"></a>2089</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $arg) = @_;</td></tr>
+<tr><td class="h"><a name="2090"></a>2090</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2091"></a>2091</td><td></td><td></td><td></td><td></td><td class="s"> if (ref $arg eq 'ARRAY') {</td></tr>
+<tr><td class="h"><a name="2092"></a>2092</td><td></td><td></td><td></td><td></td><td class="s"> if (!@$arg) {</td></tr>
+<tr><td class="h"><a name="2093"></a>2093</td><td></td><td></td><td></td><td></td><td class="s"> return [];</td></tr>
+<tr><td class="h"><a name="2094"></a>2094</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2095"></a>2095</td><td></td><td></td><td></td><td></td><td class="s"> elsif (ref $arg->[0] eq 'HASH') {</td></tr>
+<tr><td class="h"><a name="2096"></a>2096</td><td></td><td></td><td></td><td></td><td class="s"> return $arg;</td></tr>
+<tr><td class="h"><a name="2097"></a>2097</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2098"></a>2098</td><td></td><td></td><td></td><td></td><td class="s"> elsif (ref $arg->[0] eq 'ARRAY') {</td></tr>
+<tr><td class="h"><a name="2099"></a>2099</td><td></td><td></td><td></td><td></td><td class="s"> my @ret;</td></tr>
+<tr><td class="h"><a name="2100"></a>2100</td><td></td><td></td><td></td><td></td><td class="s"> my @colnames = @{$arg->[0]};</td></tr>
+<tr><td class="h"><a name="2101"></a>2101</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $values (@{$arg}[1 .. $#$arg]) {</td></tr>
+<tr><td class="h"><a name="2102"></a>2102</td><td></td><td></td><td></td><td></td><td class="s"> push @ret, { map { $colnames[$_] => $values->[$_] } (0 .. $#colnames) };</td></tr>
+<tr><td class="h"><a name="2103"></a>2103</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2104"></a>2104</td><td></td><td></td><td></td><td></td><td class="s"> return \@ret;</td></tr>
+<tr><td class="h"><a name="2105"></a>2105</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2106"></a>2106</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2107"></a>2107</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2108"></a>2108</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception('Populate expects an arrayref of hashrefs or arrayref of arrayrefs');</td></tr>
+<tr><td class="h"><a name="2109"></a>2109</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="2110"></a>2110</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2111"></a>2111</td><td></td><td></td><td></td><td></td><td class="s">=head2 pager</td></tr>
+<tr><td class="h"><a name="2112"></a>2112</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2113"></a>2113</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="2114"></a>2114</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2115"></a>2115</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: none</td></tr>
+<tr><td class="h"><a name="2116"></a>2116</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2117"></a>2117</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $pager</td></tr>
+<tr><td class="h"><a name="2118"></a>2118</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2119"></a>2119</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="2120"></a>2120</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2121"></a>2121</td><td></td><td></td><td></td><td></td><td class="s">Return Value a L<Data::Page> object for the current resultset. Only makes</td></tr>
+<tr><td class="h"><a name="2122"></a>2122</td><td></td><td></td><td></td><td></td><td class="s">sense for queries with a C<page> attribute.</td></tr>
+<tr><td class="h"><a name="2123"></a>2123</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2124"></a>2124</td><td></td><td></td><td></td><td></td><td class="s">To get the full count of entries for a paged resultset, call</td></tr>
+<tr><td class="h"><a name="2125"></a>2125</td><td></td><td></td><td></td><td></td><td class="s">C<total_entries> on the L<Data::Page> object.</td></tr>
+<tr><td class="h"><a name="2126"></a>2126</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2127"></a>2127</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="2128"></a>2128</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2129"></a>2129</td><td></td><td></td><td></td><td></td><td class="s">sub pager {</td></tr>
+<tr><td class="h"><a name="2130"></a>2130</td><td></td><td></td><td></td><td></td><td class="s"> my ($self) = @_;</td></tr>
+<tr><td class="h"><a name="2131"></a>2131</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2132"></a>2132</td><td></td><td></td><td></td><td></td><td class="s"> return $self->{pager} if $self->{pager};</td></tr>
+<tr><td class="h"><a name="2133"></a>2133</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2134"></a>2134</td><td></td><td></td><td></td><td></td><td class="s"> my $attrs = $self->{attrs};</td></tr>
+<tr><td class="h"><a name="2135"></a>2135</td><td></td><td></td><td></td><td></td><td class="s"> if (!defined $attrs->{page}) {</td></tr>
+<tr><td class="h"><a name="2136"></a>2136</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception("Can't create pager for non-paged rs");</td></tr>
+<tr><td class="h"><a name="2137"></a>2137</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2138"></a>2138</td><td></td><td></td><td></td><td></td><td class="s"> elsif ($attrs->{page} <= 0) {</td></tr>
+<tr><td class="h"><a name="2139"></a>2139</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception('Invalid page number (page-numbers are 1-based)');</td></tr>
+<tr><td class="h"><a name="2140"></a>2140</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2141"></a>2141</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{rows} ||= 10;</td></tr>
+<tr><td class="h"><a name="2142"></a>2142</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2143"></a>2143</td><td></td><td></td><td></td><td></td><td class="s"> # throw away the paging flags and re-run the count (possibly</td></tr>
+<tr><td class="h"><a name="2144"></a>2144</td><td></td><td></td><td></td><td></td><td class="s"> # with a subselect) to get the real total count</td></tr>
+<tr><td class="h"><a name="2145"></a>2145</td><td></td><td></td><td></td><td></td><td class="s"> my $count_attrs = { %$attrs };</td></tr>
+<tr><td class="h"><a name="2146"></a>2146</td><td></td><td></td><td></td><td></td><td class="s"> delete $count_attrs->{$_} for qw/rows offset page pager/;</td></tr>
+<tr><td class="h"><a name="2147"></a>2147</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2148"></a>2148</td><td></td><td></td><td></td><td></td><td class="s"> my $total_rs = (ref $self)->new($self->result_source, $count_attrs);</td></tr>
+<tr><td class="h"><a name="2149"></a>2149</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2150"></a>2150</td><td></td><td></td><td></td><td></td><td class="s"> require DBIx::Class::ResultSet::Pager;</td></tr>
+<tr><td class="h"><a name="2151"></a>2151</td><td></td><td></td><td></td><td></td><td class="s"> return $self->{pager} = DBIx::Class::ResultSet::Pager->new(</td></tr>
+<tr><td class="h"><a name="2152"></a>2152</td><td></td><td></td><td></td><td></td><td class="s"> sub { $total_rs->count }, #lazy-get the total</td></tr>
+<tr><td class="h"><a name="2153"></a>2153</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{rows},</td></tr>
+<tr><td class="h"><a name="2154"></a>2154</td><td></td><td></td><td></td><td></td><td class="s"> $self->{attrs}{page},</td></tr>
+<tr><td class="h"><a name="2155"></a>2155</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="2156"></a>2156</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="2157"></a>2157</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2158"></a>2158</td><td></td><td></td><td></td><td></td><td class="s">=head2 page</td></tr>
+<tr><td class="h"><a name="2159"></a>2159</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2160"></a>2160</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="2161"></a>2161</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2162"></a>2162</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: $page_number</td></tr>
+<tr><td class="h"><a name="2163"></a>2163</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2164"></a>2164</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $rs</td></tr>
+<tr><td class="h"><a name="2165"></a>2165</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2166"></a>2166</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="2167"></a>2167</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2168"></a>2168</td><td></td><td></td><td></td><td></td><td class="s">Returns a resultset for the $page_number page of the resultset on which page</td></tr>
+<tr><td class="h"><a name="2169"></a>2169</td><td></td><td></td><td></td><td></td><td class="s">is called, where each page contains a number of rows equal to the 'rows'</td></tr>
+<tr><td class="h"><a name="2170"></a>2170</td><td></td><td></td><td></td><td></td><td class="s">attribute set on the resultset (10 by default).</td></tr>
+<tr><td class="h"><a name="2171"></a>2171</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2172"></a>2172</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="2173"></a>2173</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2174"></a>2174</td><td></td><td></td><td></td><td></td><td class="s">sub page {</td></tr>
+<tr><td class="h"><a name="2175"></a>2175</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $page) = @_;</td></tr>
+<tr><td class="h"><a name="2176"></a>2176</td><td></td><td></td><td></td><td></td><td class="s"> return (ref $self)->new($self->result_source, { %{$self->{attrs}}, page => $page });</td></tr>
+<tr><td class="h"><a name="2177"></a>2177</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="2178"></a>2178</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2179"></a>2179</td><td></td><td></td><td></td><td></td><td class="s">=head2 new_result</td></tr>
+<tr><td class="h"><a name="2180"></a>2180</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2181"></a>2181</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="2182"></a>2182</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2183"></a>2183</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: \%vals</td></tr>
+<tr><td class="h"><a name="2184"></a>2184</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2185"></a>2185</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $rowobject</td></tr>
+<tr><td class="h"><a name="2186"></a>2186</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2187"></a>2187</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="2188"></a>2188</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2189"></a>2189</td><td></td><td></td><td></td><td></td><td class="s">Creates a new row object in the resultset's result class and returns</td></tr>
+<tr><td class="h"><a name="2190"></a>2190</td><td></td><td></td><td></td><td></td><td class="s">it. The row is not inserted into the database at this point, call</td></tr>
+<tr><td class="h"><a name="2191"></a>2191</td><td></td><td></td><td></td><td></td><td class="s">L<DBIx::Class::Row/insert> to do that. Calling L<DBIx::Class::Row/in_storage></td></tr>
+<tr><td class="h"><a name="2192"></a>2192</td><td></td><td></td><td></td><td></td><td class="s">will tell you whether the row object has been inserted or not.</td></tr>
+<tr><td class="h"><a name="2193"></a>2193</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2194"></a>2194</td><td></td><td></td><td></td><td></td><td class="s">Passes the hashref of input on to L<DBIx::Class::Row/new>.</td></tr>
+<tr><td class="h"><a name="2195"></a>2195</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2196"></a>2196</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="2197"></a>2197</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2198"></a>2198</td><td></td><td></td><td></td><td></td><td class="s">sub new_result {</td></tr>
+<tr><td class="h"><a name="2199"></a>2199</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $values) = @_;</td></tr>
+<tr><td class="h"><a name="2200"></a>2200</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception( "new_result needs a hash" )</td></tr>
+<tr><td class="h"><a name="2201"></a>2201</td><td></td><td></td><td></td><td></td><td class="s"> unless (ref $values eq 'HASH');</td></tr>
+<tr><td class="h"><a name="2202"></a>2202</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2203"></a>2203</td><td></td><td></td><td></td><td></td><td class="s"> my ($merged_cond, $cols_from_relations) = $self->_merge_with_rscond($values);</td></tr>
+<tr><td class="h"><a name="2204"></a>2204</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2205"></a>2205</td><td></td><td></td><td></td><td></td><td class="s"> my %new = (</td></tr>
+<tr><td class="h"><a name="2206"></a>2206</td><td></td><td></td><td></td><td></td><td class="s"> %$merged_cond,</td></tr>
+<tr><td class="h"><a name="2207"></a>2207</td><td></td><td></td><td></td><td></td><td class="s"> @$cols_from_relations</td></tr>
+<tr><td class="h"><a name="2208"></a>2208</td><td></td><td></td><td></td><td></td><td class="s"> ? (-cols_from_relations => $cols_from_relations)</td></tr>
+<tr><td class="h"><a name="2209"></a>2209</td><td></td><td></td><td></td><td></td><td class="s"> : (),</td></tr>
+<tr><td class="h"><a name="2210"></a>2210</td><td></td><td></td><td></td><td></td><td class="s"> -result_source => $self->result_source, # DO NOT REMOVE THIS, REQUIRED</td></tr>
+<tr><td class="h"><a name="2211"></a>2211</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="2212"></a>2212</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2213"></a>2213</td><td></td><td></td><td></td><td></td><td class="s"> return $self->result_class->new(\%new);</td></tr>
+<tr><td class="h"><a name="2214"></a>2214</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="2215"></a>2215</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2216"></a>2216</td><td></td><td></td><td></td><td></td><td class="s"># _merge_with_rscond</td></tr>
+<tr><td class="h"><a name="2217"></a>2217</td><td></td><td></td><td></td><td></td><td class="s">#</td></tr>
+<tr><td class="h"><a name="2218"></a>2218</td><td></td><td></td><td></td><td></td><td class="s"># Takes a simple hash of K/V data and returns its copy merged with the</td></tr>
+<tr><td class="h"><a name="2219"></a>2219</td><td></td><td></td><td></td><td></td><td class="s"># condition already present on the resultset. Additionally returns an</td></tr>
+<tr><td class="h"><a name="2220"></a>2220</td><td></td><td></td><td></td><td></td><td class="s"># arrayref of value/condition names, which were inferred from related</td></tr>
+<tr><td class="h"><a name="2221"></a>2221</td><td></td><td></td><td></td><td></td><td class="s"># objects (this is needed for in-memory related objects)</td></tr>
+<tr><td class="h"><a name="2222"></a>2222</td><td></td><td></td><td></td><td></td><td class="s">sub _merge_with_rscond {</td></tr>
+<tr><td class="h"><a name="2223"></a>2223</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $data) = @_;</td></tr>
+<tr><td class="h"><a name="2224"></a>2224</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2225"></a>2225</td><td></td><td></td><td></td><td></td><td class="s"> my (%new_data, @cols_from_relations);</td></tr>
+<tr><td class="h"><a name="2226"></a>2226</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2227"></a>2227</td><td></td><td></td><td></td><td></td><td class="s"> my $alias = $self->{attrs}{alias};</td></tr>
+<tr><td class="h"><a name="2228"></a>2228</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2229"></a>2229</td><td></td><td></td><td></td><td></td><td class="s"> if (! defined $self->{cond}) {</td></tr>
+<tr><td class="h"><a name="2230"></a>2230</td><td></td><td></td><td></td><td></td><td class="s"> # just massage $data below</td></tr>
+<tr><td class="h"><a name="2231"></a>2231</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2232"></a>2232</td><td></td><td></td><td></td><td></td><td class="s"> elsif ($self->{cond} eq $DBIx::Class::ResultSource::UNRESOLVABLE_CONDITION) {</td></tr>
+<tr><td class="h"><a name="2233"></a>2233</td><td></td><td></td><td></td><td></td><td class="s"> %new_data = %{ $self->{attrs}{related_objects} || {} }; # nothing might have been inserted yet</td></tr>
+<tr><td class="h"><a name="2234"></a>2234</td><td></td><td></td><td></td><td></td><td class="s"> @cols_from_relations = keys %new_data;</td></tr>
+<tr><td class="h"><a name="2235"></a>2235</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2236"></a>2236</td><td></td><td></td><td></td><td></td><td class="s"> elsif (ref $self->{cond} ne 'HASH') {</td></tr>
+<tr><td class="h"><a name="2237"></a>2237</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception(</td></tr>
+<tr><td class="h"><a name="2238"></a>2238</td><td></td><td></td><td></td><td></td><td class="s"> "Can't abstract implicit construct, resultset condition not a hash"</td></tr>
+<tr><td class="h"><a name="2239"></a>2239</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="2240"></a>2240</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2241"></a>2241</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="2242"></a>2242</td><td></td><td></td><td></td><td></td><td class="s"> # precendence must be given to passed values over values inherited from</td></tr>
+<tr><td class="h"><a name="2243"></a>2243</td><td></td><td></td><td></td><td></td><td class="s"> # the cond, so the order here is important.</td></tr>
+<tr><td class="h"><a name="2244"></a>2244</td><td></td><td></td><td></td><td></td><td class="s"> my $collapsed_cond = $self->_collapse_cond($self->{cond});</td></tr>
+<tr><td class="h"><a name="2245"></a>2245</td><td></td><td></td><td></td><td></td><td class="s"> my %implied = %{$self->_remove_alias($collapsed_cond, $alias)};</td></tr>
+<tr><td class="h"><a name="2246"></a>2246</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2247"></a>2247</td><td></td><td></td><td></td><td></td><td class="s"> while ( my($col, $value) = each %implied ) {</td></tr>
+<tr><td class="h"><a name="2248"></a>2248</td><td></td><td></td><td></td><td></td><td class="s"> my $vref = ref $value;</td></tr>
+<tr><td class="h"><a name="2249"></a>2249</td><td></td><td></td><td></td><td></td><td class="s"> if (</td></tr>
+<tr><td class="h"><a name="2250"></a>2250</td><td></td><td></td><td></td><td></td><td class="s"> $vref eq 'HASH'</td></tr>
+<tr><td class="h"><a name="2251"></a>2251</td><td></td><td></td><td></td><td></td><td class="s"> and</td></tr>
+<tr><td class="h"><a name="2252"></a>2252</td><td></td><td></td><td></td><td></td><td class="s"> keys(%$value) == 1</td></tr>
+<tr><td class="h"><a name="2253"></a>2253</td><td></td><td></td><td></td><td></td><td class="s"> and</td></tr>
+<tr><td class="h"><a name="2254"></a>2254</td><td></td><td></td><td></td><td></td><td class="s"> (keys %$value)[0] eq '='</td></tr>
+<tr><td class="h"><a name="2255"></a>2255</td><td></td><td></td><td></td><td></td><td class="s"> ) {</td></tr>
+<tr><td class="h"><a name="2256"></a>2256</td><td></td><td></td><td></td><td></td><td class="s"> $new_data{$col} = $value->{'='};</td></tr>
+<tr><td class="h"><a name="2257"></a>2257</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2258"></a>2258</td><td></td><td></td><td></td><td></td><td class="s"> elsif( !$vref or $vref eq 'SCALAR' or blessed($value) ) {</td></tr>
+<tr><td class="h"><a name="2259"></a>2259</td><td></td><td></td><td></td><td></td><td class="s"> $new_data{$col} = $value;</td></tr>
+<tr><td class="h"><a name="2260"></a>2260</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2261"></a>2261</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2262"></a>2262</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2263"></a>2263</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2264"></a>2264</td><td></td><td></td><td></td><td></td><td class="s"> %new_data = (</td></tr>
+<tr><td class="h"><a name="2265"></a>2265</td><td></td><td></td><td></td><td></td><td class="s"> %new_data,</td></tr>
+<tr><td class="h"><a name="2266"></a>2266</td><td></td><td></td><td></td><td></td><td class="s"> %{ $self->_remove_alias($data, $alias) },</td></tr>
+<tr><td class="h"><a name="2267"></a>2267</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="2268"></a>2268</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2269"></a>2269</td><td></td><td></td><td></td><td></td><td class="s"> return (\%new_data, \@cols_from_relations);</td></tr>
+<tr><td class="h"><a name="2270"></a>2270</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="2271"></a>2271</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2272"></a>2272</td><td></td><td></td><td></td><td></td><td class="s"># _has_resolved_attr</td></tr>
+<tr><td class="h"><a name="2273"></a>2273</td><td></td><td></td><td></td><td></td><td class="s">#</td></tr>
+<tr><td class="h"><a name="2274"></a>2274</td><td></td><td></td><td></td><td></td><td class="s"># determines if the resultset defines at least one</td></tr>
+<tr><td class="h"><a name="2275"></a>2275</td><td></td><td></td><td></td><td></td><td class="s"># of the attributes supplied</td></tr>
+<tr><td class="h"><a name="2276"></a>2276</td><td></td><td></td><td></td><td></td><td class="s">#</td></tr>
+<tr><td class="h"><a name="2277"></a>2277</td><td></td><td></td><td></td><td></td><td class="s"># used to determine if a subquery is neccessary</td></tr>
+<tr><td class="h"><a name="2278"></a>2278</td><td></td><td></td><td></td><td></td><td class="s">#</td></tr>
+<tr><td class="h"><a name="2279"></a>2279</td><td></td><td></td><td></td><td></td><td class="s"># supports some virtual attributes:</td></tr>
+<tr><td class="h"><a name="2280"></a>2280</td><td></td><td></td><td></td><td></td><td class="s"># -join</td></tr>
+<tr><td class="h"><a name="2281"></a>2281</td><td></td><td></td><td></td><td></td><td class="s"># This will scan for any joins being present on the resultset.</td></tr>
+<tr><td class="h"><a name="2282"></a>2282</td><td></td><td></td><td></td><td></td><td class="s"># It is not a mere key-search but a deep inspection of {from}</td></tr>
+<tr><td class="h"><a name="2283"></a>2283</td><td></td><td></td><td></td><td></td><td class="s">#</td></tr>
+<tr><td class="h"><a name="2284"></a>2284</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2285"></a>2285</td><td></td><td></td><td></td><td></td><td class="s">sub _has_resolved_attr {</td></tr>
+<tr><td class="h"><a name="2286"></a>2286</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, @attr_names) = @_;</td></tr>
+<tr><td class="h"><a name="2287"></a>2287</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2288"></a>2288</td><td></td><td></td><td></td><td></td><td class="s"> my $attrs = $self->_resolved_attrs;</td></tr>
+<tr><td class="h"><a name="2289"></a>2289</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2290"></a>2290</td><td></td><td></td><td></td><td></td><td class="s"> my %extra_checks;</td></tr>
+<tr><td class="h"><a name="2291"></a>2291</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2292"></a>2292</td><td></td><td></td><td></td><td></td><td class="s"> for my $n (@attr_names) {</td></tr>
+<tr><td class="h"><a name="2293"></a>2293</td><td></td><td></td><td></td><td></td><td class="s"> if (grep { $n eq $_ } (qw/-join/) ) {</td></tr>
+<tr><td class="h"><a name="2294"></a>2294</td><td></td><td></td><td></td><td></td><td class="s"> $extra_checks{$n}++;</td></tr>
+<tr><td class="h"><a name="2295"></a>2295</td><td></td><td></td><td></td><td></td><td class="s"> next;</td></tr>
+<tr><td class="h"><a name="2296"></a>2296</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2297"></a>2297</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2298"></a>2298</td><td></td><td></td><td></td><td></td><td class="s"> my $attr = $attrs->{$n};</td></tr>
+<tr><td class="h"><a name="2299"></a>2299</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2300"></a>2300</td><td></td><td></td><td></td><td></td><td class="s"> next if not defined $attr;</td></tr>
+<tr><td class="h"><a name="2301"></a>2301</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2302"></a>2302</td><td></td><td></td><td></td><td></td><td class="s"> if (ref $attr eq 'HASH') {</td></tr>
+<tr><td class="h"><a name="2303"></a>2303</td><td></td><td></td><td></td><td></td><td class="s"> return 1 if keys %$attr;</td></tr>
+<tr><td class="h"><a name="2304"></a>2304</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2305"></a>2305</td><td></td><td></td><td></td><td></td><td class="s"> elsif (ref $attr eq 'ARRAY') {</td></tr>
+<tr><td class="h"><a name="2306"></a>2306</td><td></td><td></td><td></td><td></td><td class="s"> return 1 if @$attr;</td></tr>
+<tr><td class="h"><a name="2307"></a>2307</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2308"></a>2308</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="2309"></a>2309</td><td></td><td></td><td></td><td></td><td class="s"> return 1 if $attr;</td></tr>
+<tr><td class="h"><a name="2310"></a>2310</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2311"></a>2311</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2312"></a>2312</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2313"></a>2313</td><td></td><td></td><td></td><td></td><td class="s"> # a resolved join is expressed as a multi-level from</td></tr>
+<tr><td class="h"><a name="2314"></a>2314</td><td></td><td></td><td></td><td></td><td class="s"> return 1 if (</td></tr>
+<tr><td class="h"><a name="2315"></a>2315</td><td></td><td></td><td></td><td></td><td class="s"> $extra_checks{-join}</td></tr>
+<tr><td class="h"><a name="2316"></a>2316</td><td></td><td></td><td></td><td></td><td class="s"> and</td></tr>
+<tr><td class="h"><a name="2317"></a>2317</td><td></td><td></td><td></td><td></td><td class="s"> ref $attrs->{from} eq 'ARRAY'</td></tr>
+<tr><td class="h"><a name="2318"></a>2318</td><td></td><td></td><td></td><td></td><td class="s"> and</td></tr>
+<tr><td class="h"><a name="2319"></a>2319</td><td></td><td></td><td></td><td></td><td class="s"> @{$attrs->{from}} > 1</td></tr>
+<tr><td class="h"><a name="2320"></a>2320</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="2321"></a>2321</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2322"></a>2322</td><td></td><td></td><td></td><td></td><td class="s"> return 0;</td></tr>
+<tr><td class="h"><a name="2323"></a>2323</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="2324"></a>2324</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2325"></a>2325</td><td></td><td></td><td></td><td></td><td class="s"># _collapse_cond</td></tr>
+<tr><td class="h"><a name="2326"></a>2326</td><td></td><td></td><td></td><td></td><td class="s">#</td></tr>
+<tr><td class="h"><a name="2327"></a>2327</td><td></td><td></td><td></td><td></td><td class="s"># Recursively collapse the condition.</td></tr>
+<tr><td class="h"><a name="2328"></a>2328</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2329"></a>2329</td><td></td><td></td><td></td><td></td><td class="s">sub _collapse_cond {</td></tr>
+<tr><td class="h"><a name="2330"></a>2330</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $cond, $collapsed) = @_;</td></tr>
+<tr><td class="h"><a name="2331"></a>2331</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2332"></a>2332</td><td></td><td></td><td></td><td></td><td class="s"> $collapsed ||= {};</td></tr>
+<tr><td class="h"><a name="2333"></a>2333</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2334"></a>2334</td><td></td><td></td><td></td><td></td><td class="s"> if (ref $cond eq 'ARRAY') {</td></tr>
+<tr><td class="h"><a name="2335"></a>2335</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $subcond (@$cond) {</td></tr>
+<tr><td class="h"><a name="2336"></a>2336</td><td></td><td></td><td></td><td></td><td class="s"> next unless ref $subcond; # -or</td></tr>
+<tr><td class="h"><a name="2337"></a>2337</td><td></td><td></td><td></td><td></td><td class="s"> $collapsed = $self->_collapse_cond($subcond, $collapsed);</td></tr>
+<tr><td class="h"><a name="2338"></a>2338</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2339"></a>2339</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2340"></a>2340</td><td></td><td></td><td></td><td></td><td class="s"> elsif (ref $cond eq 'HASH') {</td></tr>
+<tr><td class="h"><a name="2341"></a>2341</td><td></td><td></td><td></td><td></td><td class="s"> if (keys %$cond and (keys %$cond)[0] eq '-and') {</td></tr>
+<tr><td class="h"><a name="2342"></a>2342</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $subcond (@{$cond->{-and}}) {</td></tr>
+<tr><td class="h"><a name="2343"></a>2343</td><td></td><td></td><td></td><td></td><td class="s"> $collapsed = $self->_collapse_cond($subcond, $collapsed);</td></tr>
+<tr><td class="h"><a name="2344"></a>2344</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2345"></a>2345</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2346"></a>2346</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="2347"></a>2347</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $col (keys %$cond) {</td></tr>
+<tr><td class="h"><a name="2348"></a>2348</td><td></td><td></td><td></td><td></td><td class="s"> my $value = $cond->{$col};</td></tr>
+<tr><td class="h"><a name="2349"></a>2349</td><td></td><td></td><td></td><td></td><td class="s"> $collapsed->{$col} = $value;</td></tr>
+<tr><td class="h"><a name="2350"></a>2350</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2351"></a>2351</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2352"></a>2352</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2353"></a>2353</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2354"></a>2354</td><td></td><td></td><td></td><td></td><td class="s"> return $collapsed;</td></tr>
+<tr><td class="h"><a name="2355"></a>2355</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="2356"></a>2356</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2357"></a>2357</td><td></td><td></td><td></td><td></td><td class="s"># _remove_alias</td></tr>
+<tr><td class="h"><a name="2358"></a>2358</td><td></td><td></td><td></td><td></td><td class="s">#</td></tr>
+<tr><td class="h"><a name="2359"></a>2359</td><td></td><td></td><td></td><td></td><td class="s"># Remove the specified alias from the specified query hash. A copy is made so</td></tr>
+<tr><td class="h"><a name="2360"></a>2360</td><td></td><td></td><td></td><td></td><td class="s"># the original query is not modified.</td></tr>
+<tr><td class="h"><a name="2361"></a>2361</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2362"></a>2362</td><td></td><td></td><td></td><td></td><td class="s">sub _remove_alias {</td></tr>
+<tr><td class="h"><a name="2363"></a>2363</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $query, $alias) = @_;</td></tr>
+<tr><td class="h"><a name="2364"></a>2364</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2365"></a>2365</td><td></td><td></td><td></td><td></td><td class="s"> my %orig = %{ $query || {} };</td></tr>
+<tr><td class="h"><a name="2366"></a>2366</td><td></td><td></td><td></td><td></td><td class="s"> my %unaliased;</td></tr>
+<tr><td class="h"><a name="2367"></a>2367</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2368"></a>2368</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $key (keys %orig) {</td></tr>
+<tr><td class="h"><a name="2369"></a>2369</td><td></td><td></td><td></td><td></td><td class="s"> if ($key !~ /\./) {</td></tr>
+<tr><td class="h"><a name="2370"></a>2370</td><td></td><td></td><td></td><td></td><td class="s"> $unaliased{$key} = $orig{$key};</td></tr>
+<tr><td class="h"><a name="2371"></a>2371</td><td></td><td></td><td></td><td></td><td class="s"> next;</td></tr>
+<tr><td class="h"><a name="2372"></a>2372</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2373"></a>2373</td><td></td><td></td><td></td><td></td><td class="s"> $unaliased{$1} = $orig{$key}</td></tr>
+<tr><td class="h"><a name="2374"></a>2374</td><td></td><td></td><td></td><td></td><td class="s"> if $key =~ m/^(?:\Q$alias\E\.)?([^.]+)$/;</td></tr>
+<tr><td class="h"><a name="2375"></a>2375</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2376"></a>2376</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2377"></a>2377</td><td></td><td></td><td></td><td></td><td class="s"> return \%unaliased;</td></tr>
+<tr><td class="h"><a name="2378"></a>2378</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="2379"></a>2379</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2380"></a>2380</td><td></td><td></td><td></td><td></td><td class="s">=head2 as_query</td></tr>
+<tr><td class="h"><a name="2381"></a>2381</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2382"></a>2382</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="2383"></a>2383</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2384"></a>2384</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: none</td></tr>
+<tr><td class="h"><a name="2385"></a>2385</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2386"></a>2386</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: \[ $sql, @bind ]</td></tr>
+<tr><td class="h"><a name="2387"></a>2387</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2388"></a>2388</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="2389"></a>2389</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2390"></a>2390</td><td></td><td></td><td></td><td></td><td class="s">Returns the SQL query and bind vars associated with the invocant.</td></tr>
+<tr><td class="h"><a name="2391"></a>2391</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2392"></a>2392</td><td></td><td></td><td></td><td></td><td class="s">This is generally used as the RHS for a subquery.</td></tr>
+<tr><td class="h"><a name="2393"></a>2393</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2394"></a>2394</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="2395"></a>2395</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2396"></a>2396</td><td></td><td></td><td></td><td></td><td class="s">sub as_query {</td></tr>
+<tr><td class="h"><a name="2397"></a>2397</td><td></td><td></td><td></td><td></td><td class="s"> my $self = shift;</td></tr>
+<tr><td class="h"><a name="2398"></a>2398</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2399"></a>2399</td><td></td><td></td><td></td><td></td><td class="s"> my $attrs = $self->_resolved_attrs_copy;</td></tr>
+<tr><td class="h"><a name="2400"></a>2400</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2401"></a>2401</td><td></td><td></td><td></td><td></td><td class="s"> # For future use:</td></tr>
+<tr><td class="h"><a name="2402"></a>2402</td><td></td><td></td><td></td><td></td><td class="s"> #</td></tr>
+<tr><td class="h"><a name="2403"></a>2403</td><td></td><td></td><td></td><td></td><td class="s"> # in list ctx:</td></tr>
+<tr><td class="h"><a name="2404"></a>2404</td><td></td><td></td><td></td><td></td><td class="s"> # my ($sql, \@bind, \%dbi_bind_attrs) = _select_args_to_query (...)</td></tr>
+<tr><td class="h"><a name="2405"></a>2405</td><td></td><td></td><td></td><td></td><td class="s"> # $sql also has no wrapping parenthesis in list ctx</td></tr>
+<tr><td class="h"><a name="2406"></a>2406</td><td></td><td></td><td></td><td></td><td class="s"> #</td></tr>
+<tr><td class="h"><a name="2407"></a>2407</td><td></td><td></td><td></td><td></td><td class="s"> my $sqlbind = $self->result_source->storage</td></tr>
+<tr><td class="h"><a name="2408"></a>2408</td><td></td><td></td><td></td><td></td><td class="s"> ->_select_args_to_query ($attrs->{from}, $attrs->{select}, $attrs->{where}, $attrs);</td></tr>
+<tr><td class="h"><a name="2409"></a>2409</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2410"></a>2410</td><td></td><td></td><td></td><td></td><td class="s"> return $sqlbind;</td></tr>
+<tr><td class="h"><a name="2411"></a>2411</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="2412"></a>2412</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2413"></a>2413</td><td></td><td></td><td></td><td></td><td class="s">=head2 find_or_new</td></tr>
+<tr><td class="h"><a name="2414"></a>2414</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2415"></a>2415</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="2416"></a>2416</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2417"></a>2417</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: \%vals, \%attrs?</td></tr>
+<tr><td class="h"><a name="2418"></a>2418</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2419"></a>2419</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $rowobject</td></tr>
+<tr><td class="h"><a name="2420"></a>2420</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2421"></a>2421</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="2422"></a>2422</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2423"></a>2423</td><td></td><td></td><td></td><td></td><td class="s"> my $artist = $schema->resultset('Artist')->find_or_new(</td></tr>
+<tr><td class="h"><a name="2424"></a>2424</td><td></td><td></td><td></td><td></td><td class="s"> { artist => 'fred' }, { key => 'artists' });</td></tr>
+<tr><td class="h"><a name="2425"></a>2425</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2426"></a>2426</td><td></td><td></td><td></td><td></td><td class="s"> $cd->cd_to_producer->find_or_new({ producer => $producer },</td></tr>
+<tr><td class="h"><a name="2427"></a>2427</td><td></td><td></td><td></td><td></td><td class="s"> { key => 'primary });</td></tr>
+<tr><td class="h"><a name="2428"></a>2428</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2429"></a>2429</td><td></td><td></td><td></td><td></td><td class="s">Find an existing record from this resultset using L</find>. if none exists,</td></tr>
+<tr><td class="h"><a name="2430"></a>2430</td><td></td><td></td><td></td><td></td><td class="s">instantiate a new result object and return it. The object will not be saved</td></tr>
+<tr><td class="h"><a name="2431"></a>2431</td><td></td><td></td><td></td><td></td><td class="s">into your storage until you call L<DBIx::Class::Row/insert> on it.</td></tr>
+<tr><td class="h"><a name="2432"></a>2432</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2433"></a>2433</td><td></td><td></td><td></td><td></td><td class="s">You most likely want this method when looking for existing rows using a unique</td></tr>
+<tr><td class="h"><a name="2434"></a>2434</td><td></td><td></td><td></td><td></td><td class="s">constraint that is not the primary key, or looking for related rows.</td></tr>
+<tr><td class="h"><a name="2435"></a>2435</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2436"></a>2436</td><td></td><td></td><td></td><td></td><td class="s">If you want objects to be saved immediately, use L</find_or_create> instead.</td></tr>
+<tr><td class="h"><a name="2437"></a>2437</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2438"></a>2438</td><td></td><td></td><td></td><td></td><td class="s">B<Note>: Make sure to read the documentation of L</find> and understand the</td></tr>
+<tr><td class="h"><a name="2439"></a>2439</td><td></td><td></td><td></td><td></td><td class="s">significance of the C<key> attribute, as its lack may skew your search, and</td></tr>
+<tr><td class="h"><a name="2440"></a>2440</td><td></td><td></td><td></td><td></td><td class="s">subsequently result in spurious new objects.</td></tr>
+<tr><td class="h"><a name="2441"></a>2441</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2442"></a>2442</td><td></td><td></td><td></td><td></td><td class="s">B<Note>: Take care when using C<find_or_new> with a table having</td></tr>
+<tr><td class="h"><a name="2443"></a>2443</td><td></td><td></td><td></td><td></td><td class="s">columns with default values that you intend to be automatically</td></tr>
+<tr><td class="h"><a name="2444"></a>2444</td><td></td><td></td><td></td><td></td><td class="s">supplied by the database (e.g. an auto_increment primary key column).</td></tr>
+<tr><td class="h"><a name="2445"></a>2445</td><td></td><td></td><td></td><td></td><td class="s">In normal usage, the value of such columns should NOT be included at</td></tr>
+<tr><td class="h"><a name="2446"></a>2446</td><td></td><td></td><td></td><td></td><td class="s">all in the call to C<find_or_new>, even when set to C<undef>.</td></tr>
+<tr><td class="h"><a name="2447"></a>2447</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2448"></a>2448</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="2449"></a>2449</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2450"></a>2450</td><td></td><td></td><td></td><td></td><td class="s">sub find_or_new {</td></tr>
+<tr><td class="h"><a name="2451"></a>2451</td><td></td><td></td><td></td><td></td><td class="s"> my $self = shift;</td></tr>
+<tr><td class="h"><a name="2452"></a>2452</td><td></td><td></td><td></td><td></td><td class="s"> my $attrs = (@_ > 1 && ref $_[$#_] eq 'HASH' ? pop(@_) : {});</td></tr>
+<tr><td class="h"><a name="2453"></a>2453</td><td></td><td></td><td></td><td></td><td class="s"> my $hash = ref $_[0] eq 'HASH' ? shift : {@_};</td></tr>
+<tr><td class="h"><a name="2454"></a>2454</td><td></td><td></td><td></td><td></td><td class="s"> if (keys %$hash and my $row = $self->find($hash, $attrs) ) {</td></tr>
+<tr><td class="h"><a name="2455"></a>2455</td><td></td><td></td><td></td><td></td><td class="s"> return $row;</td></tr>
+<tr><td class="h"><a name="2456"></a>2456</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2457"></a>2457</td><td></td><td></td><td></td><td></td><td class="s"> return $self->new_result($hash);</td></tr>
+<tr><td class="h"><a name="2458"></a>2458</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="2459"></a>2459</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2460"></a>2460</td><td></td><td></td><td></td><td></td><td class="s">=head2 create</td></tr>
+<tr><td class="h"><a name="2461"></a>2461</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2462"></a>2462</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="2463"></a>2463</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2464"></a>2464</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: \%vals</td></tr>
+<tr><td class="h"><a name="2465"></a>2465</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2466"></a>2466</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: a L<DBIx::Class::Row> $object</td></tr>
+<tr><td class="h"><a name="2467"></a>2467</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2468"></a>2468</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="2469"></a>2469</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2470"></a>2470</td><td></td><td></td><td></td><td></td><td class="s">Attempt to create a single new row or a row with multiple related rows</td></tr>
+<tr><td class="h"><a name="2471"></a>2471</td><td></td><td></td><td></td><td></td><td class="s">in the table represented by the resultset (and related tables). This</td></tr>
+<tr><td class="h"><a name="2472"></a>2472</td><td></td><td></td><td></td><td></td><td class="s">will not check for duplicate rows before inserting, use</td></tr>
+<tr><td class="h"><a name="2473"></a>2473</td><td></td><td></td><td></td><td></td><td class="s">L</find_or_create> to do that.</td></tr>
+<tr><td class="h"><a name="2474"></a>2474</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2475"></a>2475</td><td></td><td></td><td></td><td></td><td class="s">To create one row for this resultset, pass a hashref of key/value</td></tr>
+<tr><td class="h"><a name="2476"></a>2476</td><td></td><td></td><td></td><td></td><td class="s">pairs representing the columns of the table and the values you wish to</td></tr>
+<tr><td class="h"><a name="2477"></a>2477</td><td></td><td></td><td></td><td></td><td class="s">store. If the appropriate relationships are set up, foreign key fields</td></tr>
+<tr><td class="h"><a name="2478"></a>2478</td><td></td><td></td><td></td><td></td><td class="s">can also be passed an object representing the foreign row, and the</td></tr>
+<tr><td class="h"><a name="2479"></a>2479</td><td></td><td></td><td></td><td></td><td class="s">value will be set to its primary key.</td></tr>
+<tr><td class="h"><a name="2480"></a>2480</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2481"></a>2481</td><td></td><td></td><td></td><td></td><td class="s">To create related objects, pass a hashref of related-object column values</td></tr>
+<tr><td class="h"><a name="2482"></a>2482</td><td></td><td></td><td></td><td></td><td class="s">B<keyed on the relationship name>. If the relationship is of type C<multi></td></tr>
+<tr><td class="h"><a name="2483"></a>2483</td><td></td><td></td><td></td><td></td><td class="s">(L<DBIx::Class::Relationship/has_many>) - pass an arrayref of hashrefs.</td></tr>
+<tr><td class="h"><a name="2484"></a>2484</td><td></td><td></td><td></td><td></td><td class="s">The process will correctly identify columns holding foreign keys, and will</td></tr>
+<tr><td class="h"><a name="2485"></a>2485</td><td></td><td></td><td></td><td></td><td class="s">transparently populate them from the keys of the corresponding relation.</td></tr>
+<tr><td class="h"><a name="2486"></a>2486</td><td></td><td></td><td></td><td></td><td class="s">This can be applied recursively, and will work correctly for a structure</td></tr>
+<tr><td class="h"><a name="2487"></a>2487</td><td></td><td></td><td></td><td></td><td class="s">with an arbitrary depth and width, as long as the relationships actually</td></tr>
+<tr><td class="h"><a name="2488"></a>2488</td><td></td><td></td><td></td><td></td><td class="s">exists and the correct column data has been supplied.</td></tr>
+<tr><td class="h"><a name="2489"></a>2489</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2490"></a>2490</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2491"></a>2491</td><td></td><td></td><td></td><td></td><td class="s">Instead of hashrefs of plain related data (key/value pairs), you may</td></tr>
+<tr><td class="h"><a name="2492"></a>2492</td><td></td><td></td><td></td><td></td><td class="s">also pass new or inserted objects. New objects (not inserted yet, see</td></tr>
+<tr><td class="h"><a name="2493"></a>2493</td><td></td><td></td><td></td><td></td><td class="s">L</new>), will be inserted into their appropriate tables.</td></tr>
+<tr><td class="h"><a name="2494"></a>2494</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2495"></a>2495</td><td></td><td></td><td></td><td></td><td class="s">Effectively a shortcut for C<< ->new_result(\%vals)->insert >>.</td></tr>
+<tr><td class="h"><a name="2496"></a>2496</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2497"></a>2497</td><td></td><td></td><td></td><td></td><td class="s">Example of creating a new row.</td></tr>
+<tr><td class="h"><a name="2498"></a>2498</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2499"></a>2499</td><td></td><td></td><td></td><td></td><td class="s"> $person_rs->create({</td></tr>
+<tr><td class="h"><a name="2500"></a>2500</td><td></td><td></td><td></td><td></td><td class="s"> name=>"Some Person",</td></tr>
+<tr><td class="h"><a name="2501"></a>2501</td><td></td><td></td><td></td><td></td><td class="s"> email=>"somebody@someplace.com"</td></tr>
+<tr><td class="h"><a name="2502"></a>2502</td><td></td><td></td><td></td><td></td><td class="s"> });</td></tr>
+<tr><td class="h"><a name="2503"></a>2503</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2504"></a>2504</td><td></td><td></td><td></td><td></td><td class="s">Example of creating a new row and also creating rows in a related C<has_many></td></tr>
+<tr><td class="h"><a name="2505"></a>2505</td><td></td><td></td><td></td><td></td><td class="s">or C<has_one> resultset. Note Arrayref.</td></tr>
+<tr><td class="h"><a name="2506"></a>2506</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2507"></a>2507</td><td></td><td></td><td></td><td></td><td class="s"> $artist_rs->create(</td></tr>
+<tr><td class="h"><a name="2508"></a>2508</td><td></td><td></td><td></td><td></td><td class="s"> { artistid => 4, name => 'Manufactured Crap', cds => [</td></tr>
+<tr><td class="h"><a name="2509"></a>2509</td><td></td><td></td><td></td><td></td><td class="s"> { title => 'My First CD', year => 2006 },</td></tr>
+<tr><td class="h"><a name="2510"></a>2510</td><td></td><td></td><td></td><td></td><td class="s"> { title => 'Yet More Tweeny-Pop crap', year => 2007 },</td></tr>
+<tr><td class="h"><a name="2511"></a>2511</td><td></td><td></td><td></td><td></td><td class="s"> ],</td></tr>
+<tr><td class="h"><a name="2512"></a>2512</td><td></td><td></td><td></td><td></td><td class="s"> },</td></tr>
+<tr><td class="h"><a name="2513"></a>2513</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="2514"></a>2514</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2515"></a>2515</td><td></td><td></td><td></td><td></td><td class="s">Example of creating a new row and also creating a row in a related</td></tr>
+<tr><td class="h"><a name="2516"></a>2516</td><td></td><td></td><td></td><td></td><td class="s">C<belongs_to> resultset. Note Hashref.</td></tr>
+<tr><td class="h"><a name="2517"></a>2517</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2518"></a>2518</td><td></td><td></td><td></td><td></td><td class="s"> $cd_rs->create({</td></tr>
+<tr><td class="h"><a name="2519"></a>2519</td><td></td><td></td><td></td><td></td><td class="s"> title=>"Music for Silly Walks",</td></tr>
+<tr><td class="h"><a name="2520"></a>2520</td><td></td><td></td><td></td><td></td><td class="s"> year=>2000,</td></tr>
+<tr><td class="h"><a name="2521"></a>2521</td><td></td><td></td><td></td><td></td><td class="s"> artist => {</td></tr>
+<tr><td class="h"><a name="2522"></a>2522</td><td></td><td></td><td></td><td></td><td class="s"> name=>"Silly Musician",</td></tr>
+<tr><td class="h"><a name="2523"></a>2523</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2524"></a>2524</td><td></td><td></td><td></td><td></td><td class="s"> });</td></tr>
+<tr><td class="h"><a name="2525"></a>2525</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2526"></a>2526</td><td></td><td></td><td></td><td></td><td class="s">=over</td></tr>
+<tr><td class="h"><a name="2527"></a>2527</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2528"></a>2528</td><td></td><td></td><td></td><td></td><td class="s">=item WARNING</td></tr>
+<tr><td class="h"><a name="2529"></a>2529</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2530"></a>2530</td><td></td><td></td><td></td><td></td><td class="s">When subclassing ResultSet never attempt to override this method. Since</td></tr>
+<tr><td class="h"><a name="2531"></a>2531</td><td></td><td></td><td></td><td></td><td class="s">it is a simple shortcut for C<< $self->new_result($attrs)->insert >>, a</td></tr>
+<tr><td class="h"><a name="2532"></a>2532</td><td></td><td></td><td></td><td></td><td class="s">lot of the internals simply never call it, so your override will be</td></tr>
+<tr><td class="h"><a name="2533"></a>2533</td><td></td><td></td><td></td><td></td><td class="s">bypassed more often than not. Override either L<new|DBIx::Class::Row/new></td></tr>
+<tr><td class="h"><a name="2534"></a>2534</td><td></td><td></td><td></td><td></td><td class="s">or L<insert|DBIx::Class::Row/insert> depending on how early in the</td></tr>
+<tr><td class="h"><a name="2535"></a>2535</td><td></td><td></td><td></td><td></td><td class="s">L</create> process you need to intervene.</td></tr>
+<tr><td class="h"><a name="2536"></a>2536</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2537"></a>2537</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="2538"></a>2538</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2539"></a>2539</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="2540"></a>2540</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2541"></a>2541</td><td></td><td></td><td></td><td></td><td class="s">sub create {</td></tr>
+<tr><td class="h"><a name="2542"></a>2542</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $attrs) = @_;</td></tr>
+<tr><td class="h"><a name="2543"></a>2543</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception( "create needs a hashref" )</td></tr>
+<tr><td class="h"><a name="2544"></a>2544</td><td></td><td></td><td></td><td></td><td class="s"> unless ref $attrs eq 'HASH';</td></tr>
+<tr><td class="h"><a name="2545"></a>2545</td><td></td><td></td><td></td><td></td><td class="s"> return $self->new_result($attrs)->insert;</td></tr>
+<tr><td class="h"><a name="2546"></a>2546</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="2547"></a>2547</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2548"></a>2548</td><td></td><td></td><td></td><td></td><td class="s">=head2 find_or_create</td></tr>
+<tr><td class="h"><a name="2549"></a>2549</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2550"></a>2550</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="2551"></a>2551</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2552"></a>2552</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: \%vals, \%attrs?</td></tr>
+<tr><td class="h"><a name="2553"></a>2553</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2554"></a>2554</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $rowobject</td></tr>
+<tr><td class="h"><a name="2555"></a>2555</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2556"></a>2556</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="2557"></a>2557</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2558"></a>2558</td><td></td><td></td><td></td><td></td><td class="s"> $cd->cd_to_producer->find_or_create({ producer => $producer },</td></tr>
+<tr><td class="h"><a name="2559"></a>2559</td><td></td><td></td><td></td><td></td><td class="s"> { key => 'primary' });</td></tr>
+<tr><td class="h"><a name="2560"></a>2560</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2561"></a>2561</td><td></td><td></td><td></td><td></td><td class="s">Tries to find a record based on its primary key or unique constraints; if none</td></tr>
+<tr><td class="h"><a name="2562"></a>2562</td><td></td><td></td><td></td><td></td><td class="s">is found, creates one and returns that instead.</td></tr>
+<tr><td class="h"><a name="2563"></a>2563</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2564"></a>2564</td><td></td><td></td><td></td><td></td><td class="s"> my $cd = $schema->resultset('CD')->find_or_create({</td></tr>
+<tr><td class="h"><a name="2565"></a>2565</td><td></td><td></td><td></td><td></td><td class="s"> cdid => 5,</td></tr>
+<tr><td class="h"><a name="2566"></a>2566</td><td></td><td></td><td></td><td></td><td class="s"> artist => 'Massive Attack',</td></tr>
+<tr><td class="h"><a name="2567"></a>2567</td><td></td><td></td><td></td><td></td><td class="s"> title => 'Mezzanine',</td></tr>
+<tr><td class="h"><a name="2568"></a>2568</td><td></td><td></td><td></td><td></td><td class="s"> year => 2005,</td></tr>
+<tr><td class="h"><a name="2569"></a>2569</td><td></td><td></td><td></td><td></td><td class="s"> });</td></tr>
+<tr><td class="h"><a name="2570"></a>2570</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2571"></a>2571</td><td></td><td></td><td></td><td></td><td class="s">Also takes an optional C<key> attribute, to search by a specific key or unique</td></tr>
+<tr><td class="h"><a name="2572"></a>2572</td><td></td><td></td><td></td><td></td><td class="s">constraint. For example:</td></tr>
+<tr><td class="h"><a name="2573"></a>2573</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2574"></a>2574</td><td></td><td></td><td></td><td></td><td class="s"> my $cd = $schema->resultset('CD')->find_or_create(</td></tr>
+<tr><td class="h"><a name="2575"></a>2575</td><td></td><td></td><td></td><td></td><td class="s"> {</td></tr>
+<tr><td class="h"><a name="2576"></a>2576</td><td></td><td></td><td></td><td></td><td class="s"> artist => 'Massive Attack',</td></tr>
+<tr><td class="h"><a name="2577"></a>2577</td><td></td><td></td><td></td><td></td><td class="s"> title => 'Mezzanine',</td></tr>
+<tr><td class="h"><a name="2578"></a>2578</td><td></td><td></td><td></td><td></td><td class="s"> },</td></tr>
+<tr><td class="h"><a name="2579"></a>2579</td><td></td><td></td><td></td><td></td><td class="s"> { key => 'cd_artist_title' }</td></tr>
+<tr><td class="h"><a name="2580"></a>2580</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="2581"></a>2581</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2582"></a>2582</td><td></td><td></td><td></td><td></td><td class="s">B<Note>: Make sure to read the documentation of L</find> and understand the</td></tr>
+<tr><td class="h"><a name="2583"></a>2583</td><td></td><td></td><td></td><td></td><td class="s">significance of the C<key> attribute, as its lack may skew your search, and</td></tr>
+<tr><td class="h"><a name="2584"></a>2584</td><td></td><td></td><td></td><td></td><td class="s">subsequently result in spurious row creation.</td></tr>
+<tr><td class="h"><a name="2585"></a>2585</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2586"></a>2586</td><td></td><td></td><td></td><td></td><td class="s">B<Note>: Because find_or_create() reads from the database and then</td></tr>
+<tr><td class="h"><a name="2587"></a>2587</td><td></td><td></td><td></td><td></td><td class="s">possibly inserts based on the result, this method is subject to a race</td></tr>
+<tr><td class="h"><a name="2588"></a>2588</td><td></td><td></td><td></td><td></td><td class="s">condition. Another process could create a record in the table after</td></tr>
+<tr><td class="h"><a name="2589"></a>2589</td><td></td><td></td><td></td><td></td><td class="s">the find has completed and before the create has started. To avoid</td></tr>
+<tr><td class="h"><a name="2590"></a>2590</td><td></td><td></td><td></td><td></td><td class="s">this problem, use find_or_create() inside a transaction.</td></tr>
+<tr><td class="h"><a name="2591"></a>2591</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2592"></a>2592</td><td></td><td></td><td></td><td></td><td class="s">B<Note>: Take care when using C<find_or_create> with a table having</td></tr>
+<tr><td class="h"><a name="2593"></a>2593</td><td></td><td></td><td></td><td></td><td class="s">columns with default values that you intend to be automatically</td></tr>
+<tr><td class="h"><a name="2594"></a>2594</td><td></td><td></td><td></td><td></td><td class="s">supplied by the database (e.g. an auto_increment primary key column).</td></tr>
+<tr><td class="h"><a name="2595"></a>2595</td><td></td><td></td><td></td><td></td><td class="s">In normal usage, the value of such columns should NOT be included at</td></tr>
+<tr><td class="h"><a name="2596"></a>2596</td><td></td><td></td><td></td><td></td><td class="s">all in the call to C<find_or_create>, even when set to C<undef>.</td></tr>
+<tr><td class="h"><a name="2597"></a>2597</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2598"></a>2598</td><td></td><td></td><td></td><td></td><td class="s">See also L</find> and L</update_or_create>. For information on how to declare</td></tr>
+<tr><td class="h"><a name="2599"></a>2599</td><td></td><td></td><td></td><td></td><td class="s">unique constraints, see L<DBIx::Class::ResultSource/add_unique_constraint>.</td></tr>
+<tr><td class="h"><a name="2600"></a>2600</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2601"></a>2601</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="2602"></a>2602</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2603"></a>2603</td><td></td><td></td><td></td><td></td><td class="s">sub find_or_create {</td></tr>
+<tr><td class="h"><a name="2604"></a>2604</td><td></td><td></td><td></td><td></td><td class="s"> my $self = shift;</td></tr>
+<tr><td class="h"><a name="2605"></a>2605</td><td></td><td></td><td></td><td></td><td class="s"> my $attrs = (@_ > 1 && ref $_[$#_] eq 'HASH' ? pop(@_) : {});</td></tr>
+<tr><td class="h"><a name="2606"></a>2606</td><td></td><td></td><td></td><td></td><td class="s"> my $hash = ref $_[0] eq 'HASH' ? shift : {@_};</td></tr>
+<tr><td class="h"><a name="2607"></a>2607</td><td></td><td></td><td></td><td></td><td class="s"> if (keys %$hash and my $row = $self->find($hash, $attrs) ) {</td></tr>
+<tr><td class="h"><a name="2608"></a>2608</td><td></td><td></td><td></td><td></td><td class="s"> return $row;</td></tr>
+<tr><td class="h"><a name="2609"></a>2609</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2610"></a>2610</td><td></td><td></td><td></td><td></td><td class="s"> return $self->create($hash);</td></tr>
+<tr><td class="h"><a name="2611"></a>2611</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="2612"></a>2612</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2613"></a>2613</td><td></td><td></td><td></td><td></td><td class="s">=head2 update_or_create</td></tr>
+<tr><td class="h"><a name="2614"></a>2614</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2615"></a>2615</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="2616"></a>2616</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2617"></a>2617</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: \%col_values, { key => $unique_constraint }?</td></tr>
+<tr><td class="h"><a name="2618"></a>2618</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2619"></a>2619</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $row_object</td></tr>
+<tr><td class="h"><a name="2620"></a>2620</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2621"></a>2621</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="2622"></a>2622</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2623"></a>2623</td><td></td><td></td><td></td><td></td><td class="s"> $resultset->update_or_create({ col => $val, ... });</td></tr>
+<tr><td class="h"><a name="2624"></a>2624</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2625"></a>2625</td><td></td><td></td><td></td><td></td><td class="s">Like L</find_or_create>, but if a row is found it is immediately updated via</td></tr>
+<tr><td class="h"><a name="2626"></a>2626</td><td></td><td></td><td></td><td></td><td class="s">C<< $found_row->update (\%col_values) >>.</td></tr>
+<tr><td class="h"><a name="2627"></a>2627</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2628"></a>2628</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2629"></a>2629</td><td></td><td></td><td></td><td></td><td class="s">Takes an optional C<key> attribute to search on a specific unique constraint.</td></tr>
+<tr><td class="h"><a name="2630"></a>2630</td><td></td><td></td><td></td><td></td><td class="s">For example:</td></tr>
+<tr><td class="h"><a name="2631"></a>2631</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2632"></a>2632</td><td></td><td></td><td></td><td></td><td class="s"> # In your application</td></tr>
+<tr><td class="h"><a name="2633"></a>2633</td><td></td><td></td><td></td><td></td><td class="s"> my $cd = $schema->resultset('CD')->update_or_create(</td></tr>
+<tr><td class="h"><a name="2634"></a>2634</td><td></td><td></td><td></td><td></td><td class="s"> {</td></tr>
+<tr><td class="h"><a name="2635"></a>2635</td><td></td><td></td><td></td><td></td><td class="s"> artist => 'Massive Attack',</td></tr>
+<tr><td class="h"><a name="2636"></a>2636</td><td></td><td></td><td></td><td></td><td class="s"> title => 'Mezzanine',</td></tr>
+<tr><td class="h"><a name="2637"></a>2637</td><td></td><td></td><td></td><td></td><td class="s"> year => 1998,</td></tr>
+<tr><td class="h"><a name="2638"></a>2638</td><td></td><td></td><td></td><td></td><td class="s"> },</td></tr>
+<tr><td class="h"><a name="2639"></a>2639</td><td></td><td></td><td></td><td></td><td class="s"> { key => 'cd_artist_title' }</td></tr>
+<tr><td class="h"><a name="2640"></a>2640</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="2641"></a>2641</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2642"></a>2642</td><td></td><td></td><td></td><td></td><td class="s"> $cd->cd_to_producer->update_or_create({</td></tr>
+<tr><td class="h"><a name="2643"></a>2643</td><td></td><td></td><td></td><td></td><td class="s"> producer => $producer,</td></tr>
+<tr><td class="h"><a name="2644"></a>2644</td><td></td><td></td><td></td><td></td><td class="s"> name => 'harry',</td></tr>
+<tr><td class="h"><a name="2645"></a>2645</td><td></td><td></td><td></td><td></td><td class="s"> }, {</td></tr>
+<tr><td class="h"><a name="2646"></a>2646</td><td></td><td></td><td></td><td></td><td class="s"> key => 'primary',</td></tr>
+<tr><td class="h"><a name="2647"></a>2647</td><td></td><td></td><td></td><td></td><td class="s"> });</td></tr>
+<tr><td class="h"><a name="2648"></a>2648</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2649"></a>2649</td><td></td><td></td><td></td><td></td><td class="s">B<Note>: Make sure to read the documentation of L</find> and understand the</td></tr>
+<tr><td class="h"><a name="2650"></a>2650</td><td></td><td></td><td></td><td></td><td class="s">significance of the C<key> attribute, as its lack may skew your search, and</td></tr>
+<tr><td class="h"><a name="2651"></a>2651</td><td></td><td></td><td></td><td></td><td class="s">subsequently result in spurious row creation.</td></tr>
+<tr><td class="h"><a name="2652"></a>2652</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2653"></a>2653</td><td></td><td></td><td></td><td></td><td class="s">B<Note>: Take care when using C<update_or_create> with a table having</td></tr>
+<tr><td class="h"><a name="2654"></a>2654</td><td></td><td></td><td></td><td></td><td class="s">columns with default values that you intend to be automatically</td></tr>
+<tr><td class="h"><a name="2655"></a>2655</td><td></td><td></td><td></td><td></td><td class="s">supplied by the database (e.g. an auto_increment primary key column).</td></tr>
+<tr><td class="h"><a name="2656"></a>2656</td><td></td><td></td><td></td><td></td><td class="s">In normal usage, the value of such columns should NOT be included at</td></tr>
+<tr><td class="h"><a name="2657"></a>2657</td><td></td><td></td><td></td><td></td><td class="s">all in the call to C<update_or_create>, even when set to C<undef>.</td></tr>
+<tr><td class="h"><a name="2658"></a>2658</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2659"></a>2659</td><td></td><td></td><td></td><td></td><td class="s">See also L</find> and L</find_or_create>. For information on how to declare</td></tr>
+<tr><td class="h"><a name="2660"></a>2660</td><td></td><td></td><td></td><td></td><td class="s">unique constraints, see L<DBIx::Class::ResultSource/add_unique_constraint>.</td></tr>
+<tr><td class="h"><a name="2661"></a>2661</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2662"></a>2662</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="2663"></a>2663</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2664"></a>2664</td><td></td><td></td><td></td><td></td><td class="s">sub update_or_create {</td></tr>
+<tr><td class="h"><a name="2665"></a>2665</td><td></td><td></td><td></td><td></td><td class="s"> my $self = shift;</td></tr>
+<tr><td class="h"><a name="2666"></a>2666</td><td></td><td></td><td></td><td></td><td class="s"> my $attrs = (@_ > 1 && ref $_[$#_] eq 'HASH' ? pop(@_) : {});</td></tr>
+<tr><td class="h"><a name="2667"></a>2667</td><td></td><td></td><td></td><td></td><td class="s"> my $cond = ref $_[0] eq 'HASH' ? shift : {@_};</td></tr>
+<tr><td class="h"><a name="2668"></a>2668</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2669"></a>2669</td><td></td><td></td><td></td><td></td><td class="s"> my $row = $self->find($cond, $attrs);</td></tr>
+<tr><td class="h"><a name="2670"></a>2670</td><td></td><td></td><td></td><td></td><td class="s"> if (defined $row) {</td></tr>
+<tr><td class="h"><a name="2671"></a>2671</td><td></td><td></td><td></td><td></td><td class="s"> $row->update($cond);</td></tr>
+<tr><td class="h"><a name="2672"></a>2672</td><td></td><td></td><td></td><td></td><td class="s"> return $row;</td></tr>
+<tr><td class="h"><a name="2673"></a>2673</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2674"></a>2674</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2675"></a>2675</td><td></td><td></td><td></td><td></td><td class="s"> return $self->create($cond);</td></tr>
+<tr><td class="h"><a name="2676"></a>2676</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="2677"></a>2677</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2678"></a>2678</td><td></td><td></td><td></td><td></td><td class="s">=head2 update_or_new</td></tr>
+<tr><td class="h"><a name="2679"></a>2679</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2680"></a>2680</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="2681"></a>2681</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2682"></a>2682</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: \%col_values, { key => $unique_constraint }?</td></tr>
+<tr><td class="h"><a name="2683"></a>2683</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2684"></a>2684</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $rowobject</td></tr>
+<tr><td class="h"><a name="2685"></a>2685</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2686"></a>2686</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="2687"></a>2687</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2688"></a>2688</td><td></td><td></td><td></td><td></td><td class="s"> $resultset->update_or_new({ col => $val, ... });</td></tr>
+<tr><td class="h"><a name="2689"></a>2689</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2690"></a>2690</td><td></td><td></td><td></td><td></td><td class="s">Like L</find_or_new> but if a row is found it is immediately updated via</td></tr>
+<tr><td class="h"><a name="2691"></a>2691</td><td></td><td></td><td></td><td></td><td class="s">C<< $found_row->update (\%col_values) >>.</td></tr>
+<tr><td class="h"><a name="2692"></a>2692</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2693"></a>2693</td><td></td><td></td><td></td><td></td><td class="s">For example:</td></tr>
+<tr><td class="h"><a name="2694"></a>2694</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2695"></a>2695</td><td></td><td></td><td></td><td></td><td class="s"> # In your application</td></tr>
+<tr><td class="h"><a name="2696"></a>2696</td><td></td><td></td><td></td><td></td><td class="s"> my $cd = $schema->resultset('CD')->update_or_new(</td></tr>
+<tr><td class="h"><a name="2697"></a>2697</td><td></td><td></td><td></td><td></td><td class="s"> {</td></tr>
+<tr><td class="h"><a name="2698"></a>2698</td><td></td><td></td><td></td><td></td><td class="s"> artist => 'Massive Attack',</td></tr>
+<tr><td class="h"><a name="2699"></a>2699</td><td></td><td></td><td></td><td></td><td class="s"> title => 'Mezzanine',</td></tr>
+<tr><td class="h"><a name="2700"></a>2700</td><td></td><td></td><td></td><td></td><td class="s"> year => 1998,</td></tr>
+<tr><td class="h"><a name="2701"></a>2701</td><td></td><td></td><td></td><td></td><td class="s"> },</td></tr>
+<tr><td class="h"><a name="2702"></a>2702</td><td></td><td></td><td></td><td></td><td class="s"> { key => 'cd_artist_title' }</td></tr>
+<tr><td class="h"><a name="2703"></a>2703</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="2704"></a>2704</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2705"></a>2705</td><td></td><td></td><td></td><td></td><td class="s"> if ($cd->in_storage) {</td></tr>
+<tr><td class="h"><a name="2706"></a>2706</td><td></td><td></td><td></td><td></td><td class="s"> # the cd was updated</td></tr>
+<tr><td class="h"><a name="2707"></a>2707</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2708"></a>2708</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="2709"></a>2709</td><td></td><td></td><td></td><td></td><td class="s"> # the cd is not yet in the database, let's insert it</td></tr>
+<tr><td class="h"><a name="2710"></a>2710</td><td></td><td></td><td></td><td></td><td class="s"> $cd->insert;</td></tr>
+<tr><td class="h"><a name="2711"></a>2711</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2712"></a>2712</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2713"></a>2713</td><td></td><td></td><td></td><td></td><td class="s">B<Note>: Make sure to read the documentation of L</find> and understand the</td></tr>
+<tr><td class="h"><a name="2714"></a>2714</td><td></td><td></td><td></td><td></td><td class="s">significance of the C<key> attribute, as its lack may skew your search, and</td></tr>
+<tr><td class="h"><a name="2715"></a>2715</td><td></td><td></td><td></td><td></td><td class="s">subsequently result in spurious new objects.</td></tr>
+<tr><td class="h"><a name="2716"></a>2716</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2717"></a>2717</td><td></td><td></td><td></td><td></td><td class="s">B<Note>: Take care when using C<update_or_new> with a table having</td></tr>
+<tr><td class="h"><a name="2718"></a>2718</td><td></td><td></td><td></td><td></td><td class="s">columns with default values that you intend to be automatically</td></tr>
+<tr><td class="h"><a name="2719"></a>2719</td><td></td><td></td><td></td><td></td><td class="s">supplied by the database (e.g. an auto_increment primary key column).</td></tr>
+<tr><td class="h"><a name="2720"></a>2720</td><td></td><td></td><td></td><td></td><td class="s">In normal usage, the value of such columns should NOT be included at</td></tr>
+<tr><td class="h"><a name="2721"></a>2721</td><td></td><td></td><td></td><td></td><td class="s">all in the call to C<update_or_new>, even when set to C<undef>.</td></tr>
+<tr><td class="h"><a name="2722"></a>2722</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2723"></a>2723</td><td></td><td></td><td></td><td></td><td class="s">See also L</find>, L</find_or_create> and L</find_or_new>. </td></tr>
+<tr><td class="h"><a name="2724"></a>2724</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2725"></a>2725</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="2726"></a>2726</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2727"></a>2727</td><td></td><td></td><td></td><td></td><td class="s">sub update_or_new {</td></tr>
+<tr><td class="h"><a name="2728"></a>2728</td><td></td><td></td><td></td><td></td><td class="s"> my $self = shift;</td></tr>
+<tr><td class="h"><a name="2729"></a>2729</td><td></td><td></td><td></td><td></td><td class="s"> my $attrs = ( @_ > 1 && ref $_[$#_] eq 'HASH' ? pop(@_) : {} );</td></tr>
+<tr><td class="h"><a name="2730"></a>2730</td><td></td><td></td><td></td><td></td><td class="s"> my $cond = ref $_[0] eq 'HASH' ? shift : {@_};</td></tr>
+<tr><td class="h"><a name="2731"></a>2731</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2732"></a>2732</td><td></td><td></td><td></td><td></td><td class="s"> my $row = $self->find( $cond, $attrs );</td></tr>
+<tr><td class="h"><a name="2733"></a>2733</td><td></td><td></td><td></td><td></td><td class="s"> if ( defined $row ) {</td></tr>
+<tr><td class="h"><a name="2734"></a>2734</td><td></td><td></td><td></td><td></td><td class="s"> $row->update($cond);</td></tr>
+<tr><td class="h"><a name="2735"></a>2735</td><td></td><td></td><td></td><td></td><td class="s"> return $row;</td></tr>
+<tr><td class="h"><a name="2736"></a>2736</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2737"></a>2737</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2738"></a>2738</td><td></td><td></td><td></td><td></td><td class="s"> return $self->new_result($cond);</td></tr>
+<tr><td class="h"><a name="2739"></a>2739</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="2740"></a>2740</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2741"></a>2741</td><td></td><td></td><td></td><td></td><td class="s">=head2 get_cache</td></tr>
+<tr><td class="h"><a name="2742"></a>2742</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2743"></a>2743</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="2744"></a>2744</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2745"></a>2745</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: none</td></tr>
+<tr><td class="h"><a name="2746"></a>2746</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2747"></a>2747</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: \@cache_objects | undef</td></tr>
+<tr><td class="h"><a name="2748"></a>2748</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2749"></a>2749</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="2750"></a>2750</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2751"></a>2751</td><td></td><td></td><td></td><td></td><td class="s">Gets the contents of the cache for the resultset, if the cache is set.</td></tr>
+<tr><td class="h"><a name="2752"></a>2752</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2753"></a>2753</td><td></td><td></td><td></td><td></td><td class="s">The cache is populated either by using the L</prefetch> attribute to</td></tr>
+<tr><td class="h"><a name="2754"></a>2754</td><td></td><td></td><td></td><td></td><td class="s">L</search> or by calling L</set_cache>.</td></tr>
+<tr><td class="h"><a name="2755"></a>2755</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2756"></a>2756</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="2757"></a>2757</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2758"></a>2758</td><td></td><td></td><td></td><td></td><td class="s">sub get_cache {</td></tr>
+<tr><td class="h"><a name="2759"></a>2759</td><td></td><td></td><td></td><td></td><td class="s"> shift->{all_cache};</td></tr>
+<tr><td class="h"><a name="2760"></a>2760</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="2761"></a>2761</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2762"></a>2762</td><td></td><td></td><td></td><td></td><td class="s">=head2 set_cache</td></tr>
+<tr><td class="h"><a name="2763"></a>2763</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2764"></a>2764</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="2765"></a>2765</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2766"></a>2766</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: \@cache_objects</td></tr>
+<tr><td class="h"><a name="2767"></a>2767</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2768"></a>2768</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: \@cache_objects</td></tr>
+<tr><td class="h"><a name="2769"></a>2769</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2770"></a>2770</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="2771"></a>2771</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2772"></a>2772</td><td></td><td></td><td></td><td></td><td class="s">Sets the contents of the cache for the resultset. Expects an arrayref</td></tr>
+<tr><td class="h"><a name="2773"></a>2773</td><td></td><td></td><td></td><td></td><td class="s">of objects of the same class as those produced by the resultset. Note that</td></tr>
+<tr><td class="h"><a name="2774"></a>2774</td><td></td><td></td><td></td><td></td><td class="s">if the cache is set the resultset will return the cached objects rather</td></tr>
+<tr><td class="h"><a name="2775"></a>2775</td><td></td><td></td><td></td><td></td><td class="s">than re-querying the database even if the cache attr is not set.</td></tr>
+<tr><td class="h"><a name="2776"></a>2776</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2777"></a>2777</td><td></td><td></td><td></td><td></td><td class="s">The contents of the cache can also be populated by using the</td></tr>
+<tr><td class="h"><a name="2778"></a>2778</td><td></td><td></td><td></td><td></td><td class="s">L</prefetch> attribute to L</search>.</td></tr>
+<tr><td class="h"><a name="2779"></a>2779</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2780"></a>2780</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="2781"></a>2781</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2782"></a>2782</td><td></td><td></td><td></td><td></td><td class="s">sub set_cache {</td></tr>
+<tr><td class="h"><a name="2783"></a>2783</td><td></td><td></td><td></td><td></td><td class="s"> my ( $self, $data ) = @_;</td></tr>
+<tr><td class="h"><a name="2784"></a>2784</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception("set_cache requires an arrayref")</td></tr>
+<tr><td class="h"><a name="2785"></a>2785</td><td></td><td></td><td></td><td></td><td class="s"> if defined($data) && (ref $data ne 'ARRAY');</td></tr>
+<tr><td class="h"><a name="2786"></a>2786</td><td></td><td></td><td></td><td></td><td class="s"> $self->{all_cache} = $data;</td></tr>
+<tr><td class="h"><a name="2787"></a>2787</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="2788"></a>2788</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2789"></a>2789</td><td></td><td></td><td></td><td></td><td class="s">=head2 clear_cache</td></tr>
+<tr><td class="h"><a name="2790"></a>2790</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2791"></a>2791</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="2792"></a>2792</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2793"></a>2793</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: none</td></tr>
+<tr><td class="h"><a name="2794"></a>2794</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2795"></a>2795</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: undef</td></tr>
+<tr><td class="h"><a name="2796"></a>2796</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2797"></a>2797</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="2798"></a>2798</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2799"></a>2799</td><td></td><td></td><td></td><td></td><td class="s">Clears the cache for the resultset.</td></tr>
+<tr><td class="h"><a name="2800"></a>2800</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2801"></a>2801</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="2802"></a>2802</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2803"></a>2803</td><td></td><td></td><td></td><td></td><td class="s">sub clear_cache {</td></tr>
+<tr><td class="h"><a name="2804"></a>2804</td><td></td><td></td><td></td><td></td><td class="s"> shift->set_cache(undef);</td></tr>
+<tr><td class="h"><a name="2805"></a>2805</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="2806"></a>2806</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2807"></a>2807</td><td></td><td></td><td></td><td></td><td class="s">=head2 is_paged</td></tr>
+<tr><td class="h"><a name="2808"></a>2808</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2809"></a>2809</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="2810"></a>2810</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2811"></a>2811</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: none</td></tr>
+<tr><td class="h"><a name="2812"></a>2812</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2813"></a>2813</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: true, if the resultset has been paginated</td></tr>
+<tr><td class="h"><a name="2814"></a>2814</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2815"></a>2815</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="2816"></a>2816</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2817"></a>2817</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="2818"></a>2818</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2819"></a>2819</td><td></td><td></td><td></td><td></td><td class="s">sub is_paged {</td></tr>
+<tr><td class="h"><a name="2820"></a>2820</td><td></td><td></td><td></td><td></td><td class="s"> my ($self) = @_;</td></tr>
+<tr><td class="h"><a name="2821"></a>2821</td><td></td><td></td><td></td><td></td><td class="s"> return !!$self->{attrs}{page};</td></tr>
+<tr><td class="h"><a name="2822"></a>2822</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="2823"></a>2823</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2824"></a>2824</td><td></td><td></td><td></td><td></td><td class="s">=head2 is_ordered</td></tr>
+<tr><td class="h"><a name="2825"></a>2825</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2826"></a>2826</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="2827"></a>2827</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2828"></a>2828</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: none</td></tr>
+<tr><td class="h"><a name="2829"></a>2829</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2830"></a>2830</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: true, if the resultset has been ordered with C<order_by>.</td></tr>
+<tr><td class="h"><a name="2831"></a>2831</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2832"></a>2832</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="2833"></a>2833</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2834"></a>2834</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="2835"></a>2835</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2836"></a>2836</td><td></td><td></td><td></td><td></td><td class="s">sub is_ordered {</td></tr>
+<tr><td class="h"><a name="2837"></a>2837</td><td></td><td></td><td></td><td></td><td class="s"> my ($self) = @_;</td></tr>
+<tr><td class="h"><a name="2838"></a>2838</td><td></td><td></td><td></td><td></td><td class="s"> return scalar $self->result_source->storage->_extract_order_criteria($self->{attrs}{order_by});</td></tr>
+<tr><td class="h"><a name="2839"></a>2839</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="2840"></a>2840</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2841"></a>2841</td><td></td><td></td><td></td><td></td><td class="s">=head2 related_resultset</td></tr>
+<tr><td class="h"><a name="2842"></a>2842</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2843"></a>2843</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="2844"></a>2844</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2845"></a>2845</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: $relationship_name</td></tr>
+<tr><td class="h"><a name="2846"></a>2846</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2847"></a>2847</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $resultset</td></tr>
+<tr><td class="h"><a name="2848"></a>2848</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2849"></a>2849</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="2850"></a>2850</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2851"></a>2851</td><td></td><td></td><td></td><td></td><td class="s">Returns a related resultset for the supplied relationship name.</td></tr>
+<tr><td class="h"><a name="2852"></a>2852</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2853"></a>2853</td><td></td><td></td><td></td><td></td><td class="s"> $artist_rs = $schema->resultset('CD')->related_resultset('Artist');</td></tr>
+<tr><td class="h"><a name="2854"></a>2854</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2855"></a>2855</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="2856"></a>2856</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2857"></a>2857</td><td></td><td></td><td></td><td></td><td class="s">sub related_resultset {</td></tr>
+<tr><td class="h"><a name="2858"></a>2858</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $rel) = @_;</td></tr>
+<tr><td class="h"><a name="2859"></a>2859</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2860"></a>2860</td><td></td><td></td><td></td><td></td><td class="s"> $self->{related_resultsets} ||= {};</td></tr>
+<tr><td class="h"><a name="2861"></a>2861</td><td></td><td></td><td></td><td></td><td class="s"> return $self->{related_resultsets}{$rel} ||= do {</td></tr>
+<tr><td class="h"><a name="2862"></a>2862</td><td></td><td></td><td></td><td></td><td class="s"> my $rsrc = $self->result_source;</td></tr>
+<tr><td class="h"><a name="2863"></a>2863</td><td></td><td></td><td></td><td></td><td class="s"> my $rel_info = $rsrc->relationship_info($rel);</td></tr>
+<tr><td class="h"><a name="2864"></a>2864</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2865"></a>2865</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception(</td></tr>
+<tr><td class="h"><a name="2866"></a>2866</td><td></td><td></td><td></td><td></td><td class="s"> "search_related: result source '" . $rsrc->source_name .</td></tr>
+<tr><td class="h"><a name="2867"></a>2867</td><td></td><td></td><td></td><td></td><td class="s"> "' has no such relationship $rel")</td></tr>
+<tr><td class="h"><a name="2868"></a>2868</td><td></td><td></td><td></td><td></td><td class="s"> unless $rel_info;</td></tr>
+<tr><td class="h"><a name="2869"></a>2869</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2870"></a>2870</td><td></td><td></td><td></td><td></td><td class="s"> my $attrs = $self->_chain_relationship($rel);</td></tr>
+<tr><td class="h"><a name="2871"></a>2871</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2872"></a>2872</td><td></td><td></td><td></td><td></td><td class="s"> my $join_count = $attrs->{seen_join}{$rel};</td></tr>
+<tr><td class="h"><a name="2873"></a>2873</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2874"></a>2874</td><td></td><td></td><td></td><td></td><td class="s"> my $alias = $self->result_source->storage</td></tr>
+<tr><td class="h"><a name="2875"></a>2875</td><td></td><td></td><td></td><td></td><td class="s"> ->relname_to_table_alias($rel, $join_count);</td></tr>
+<tr><td class="h"><a name="2876"></a>2876</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2877"></a>2877</td><td></td><td></td><td></td><td></td><td class="s"> # since this is search_related, and we already slid the select window inwards</td></tr>
+<tr><td class="h"><a name="2878"></a>2878</td><td></td><td></td><td></td><td></td><td class="s"> # (the select/as attrs were deleted in the beginning), we need to flip all</td></tr>
+<tr><td class="h"><a name="2879"></a>2879</td><td></td><td></td><td></td><td></td><td class="s"> # left joins to inner, so we get the expected results</td></tr>
+<tr><td class="h"><a name="2880"></a>2880</td><td></td><td></td><td></td><td></td><td class="s"> # read the comment on top of the actual function to see what this does</td></tr>
+<tr><td class="h"><a name="2881"></a>2881</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{from} = $rsrc->schema->storage->_inner_join_to_node ($attrs->{from}, $alias);</td></tr>
+<tr><td class="h"><a name="2882"></a>2882</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2883"></a>2883</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2884"></a>2884</td><td></td><td></td><td></td><td></td><td class="s"> #XXX - temp fix for result_class bug. There likely is a more elegant fix -groditi</td></tr>
+<tr><td class="h"><a name="2885"></a>2885</td><td></td><td></td><td></td><td></td><td class="s"> delete @{$attrs}{qw(result_class alias)};</td></tr>
+<tr><td class="h"><a name="2886"></a>2886</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2887"></a>2887</td><td></td><td></td><td></td><td></td><td class="s"> my $new_cache;</td></tr>
+<tr><td class="h"><a name="2888"></a>2888</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2889"></a>2889</td><td></td><td></td><td></td><td></td><td class="s"> if (my $cache = $self->get_cache) {</td></tr>
+<tr><td class="h"><a name="2890"></a>2890</td><td></td><td></td><td></td><td></td><td class="s"> if ($cache->[0] && $cache->[0]->related_resultset($rel)->get_cache) {</td></tr>
+<tr><td class="h"><a name="2891"></a>2891</td><td></td><td></td><td></td><td></td><td class="s"> $new_cache = [ map { @{$_->related_resultset($rel)->get_cache} }</td></tr>
+<tr><td class="h"><a name="2892"></a>2892</td><td></td><td></td><td></td><td></td><td class="s"> @$cache ];</td></tr>
+<tr><td class="h"><a name="2893"></a>2893</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2894"></a>2894</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2895"></a>2895</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2896"></a>2896</td><td></td><td></td><td></td><td></td><td class="s"> my $rel_source = $rsrc->related_source($rel);</td></tr>
+<tr><td class="h"><a name="2897"></a>2897</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2898"></a>2898</td><td></td><td></td><td></td><td></td><td class="s"> my $new = do {</td></tr>
+<tr><td class="h"><a name="2899"></a>2899</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2900"></a>2900</td><td></td><td></td><td></td><td></td><td class="s"> # The reason we do this now instead of passing the alias to the</td></tr>
+<tr><td class="h"><a name="2901"></a>2901</td><td></td><td></td><td></td><td></td><td class="s"> # search_rs below is that if you wrap/overload resultset on the</td></tr>
+<tr><td class="h"><a name="2902"></a>2902</td><td></td><td></td><td></td><td></td><td class="s"> # source you need to know what alias it's -going- to have for things</td></tr>
+<tr><td class="h"><a name="2903"></a>2903</td><td></td><td></td><td></td><td></td><td class="s"> # to work sanely (e.g. RestrictWithObject wants to be able to add</td></tr>
+<tr><td class="h"><a name="2904"></a>2904</td><td></td><td></td><td></td><td></td><td class="s"> # extra query restrictions, and these may need to be $alias.)</td></tr>
+<tr><td class="h"><a name="2905"></a>2905</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2906"></a>2906</td><td></td><td></td><td></td><td></td><td class="s"> my $rel_attrs = $rel_source->resultset_attributes;</td></tr>
+<tr><td class="h"><a name="2907"></a>2907</td><td></td><td></td><td></td><td></td><td class="s"> local $rel_attrs->{alias} = $alias;</td></tr>
+<tr><td class="h"><a name="2908"></a>2908</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2909"></a>2909</td><td></td><td></td><td></td><td></td><td class="s"> $rel_source->resultset</td></tr>
+<tr><td class="h"><a name="2910"></a>2910</td><td></td><td></td><td></td><td></td><td class="s"> ->search_rs(</td></tr>
+<tr><td class="h"><a name="2911"></a>2911</td><td></td><td></td><td></td><td></td><td class="s"> undef, {</td></tr>
+<tr><td class="h"><a name="2912"></a>2912</td><td></td><td></td><td></td><td></td><td class="s"> %$attrs,</td></tr>
+<tr><td class="h"><a name="2913"></a>2913</td><td></td><td></td><td></td><td></td><td class="s"> where => $attrs->{where},</td></tr>
+<tr><td class="h"><a name="2914"></a>2914</td><td></td><td></td><td></td><td></td><td class="s"> });</td></tr>
+<tr><td class="h"><a name="2915"></a>2915</td><td></td><td></td><td></td><td></td><td class="s"> };</td></tr>
+<tr><td class="h"><a name="2916"></a>2916</td><td></td><td></td><td></td><td></td><td class="s"> $new->set_cache($new_cache) if $new_cache;</td></tr>
+<tr><td class="h"><a name="2917"></a>2917</td><td></td><td></td><td></td><td></td><td class="s"> $new;</td></tr>
+<tr><td class="h"><a name="2918"></a>2918</td><td></td><td></td><td></td><td></td><td class="s"> };</td></tr>
+<tr><td class="h"><a name="2919"></a>2919</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="2920"></a>2920</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2921"></a>2921</td><td></td><td></td><td></td><td></td><td class="s">=head2 current_source_alias</td></tr>
+<tr><td class="h"><a name="2922"></a>2922</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2923"></a>2923</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="2924"></a>2924</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2925"></a>2925</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: none</td></tr>
+<tr><td class="h"><a name="2926"></a>2926</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2927"></a>2927</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $source_alias</td></tr>
+<tr><td class="h"><a name="2928"></a>2928</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2929"></a>2929</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="2930"></a>2930</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2931"></a>2931</td><td></td><td></td><td></td><td></td><td class="s">Returns the current table alias for the result source this resultset is built</td></tr>
+<tr><td class="h"><a name="2932"></a>2932</td><td></td><td></td><td></td><td></td><td class="s">on, that will be used in the SQL query. Usually it is C<me>.</td></tr>
+<tr><td class="h"><a name="2933"></a>2933</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2934"></a>2934</td><td></td><td></td><td></td><td></td><td class="s">Currently the source alias that refers to the result set returned by a</td></tr>
+<tr><td class="h"><a name="2935"></a>2935</td><td></td><td></td><td></td><td></td><td class="s">L</search>/L</find> family method depends on how you got to the resultset: it's</td></tr>
+<tr><td class="h"><a name="2936"></a>2936</td><td></td><td></td><td></td><td></td><td class="s">C<me> by default, but eg. L</search_related> aliases it to the related result</td></tr>
+<tr><td class="h"><a name="2937"></a>2937</td><td></td><td></td><td></td><td></td><td class="s">source name (and keeps C<me> referring to the original result set). The long</td></tr>
+<tr><td class="h"><a name="2938"></a>2938</td><td></td><td></td><td></td><td></td><td class="s">term goal is to make L<DBIx::Class> always alias the current resultset as C<me></td></tr>
+<tr><td class="h"><a name="2939"></a>2939</td><td></td><td></td><td></td><td></td><td class="s">(and make this method unnecessary).</td></tr>
+<tr><td class="h"><a name="2940"></a>2940</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2941"></a>2941</td><td></td><td></td><td></td><td></td><td class="s">Thus it's currently necessary to use this method in predefined queries (see</td></tr>
+<tr><td class="h"><a name="2942"></a>2942</td><td></td><td></td><td></td><td></td><td class="s">L<DBIx::Class::Manual::Cookbook/Predefined searches>) when referring to the</td></tr>
+<tr><td class="h"><a name="2943"></a>2943</td><td></td><td></td><td></td><td></td><td class="s">source alias of the current result set:</td></tr>
+<tr><td class="h"><a name="2944"></a>2944</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2945"></a>2945</td><td></td><td></td><td></td><td></td><td class="s"> # in a result set class</td></tr>
+<tr><td class="h"><a name="2946"></a>2946</td><td></td><td></td><td></td><td></td><td class="s"> sub modified_by {</td></tr>
+<tr><td class="h"><a name="2947"></a>2947</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $user) = @_;</td></tr>
+<tr><td class="h"><a name="2948"></a>2948</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2949"></a>2949</td><td></td><td></td><td></td><td></td><td class="s"> my $me = $self->current_source_alias;</td></tr>
+<tr><td class="h"><a name="2950"></a>2950</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2951"></a>2951</td><td></td><td></td><td></td><td></td><td class="s"> return $self->search(</td></tr>
+<tr><td class="h"><a name="2952"></a>2952</td><td></td><td></td><td></td><td></td><td class="s"> "$me.modified" => $user->id,</td></tr>
+<tr><td class="h"><a name="2953"></a>2953</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="2954"></a>2954</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="2955"></a>2955</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2956"></a>2956</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="2957"></a>2957</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2958"></a>2958</td><td></td><td></td><td></td><td></td><td class="s">sub current_source_alias {</td></tr>
+<tr><td class="h"><a name="2959"></a>2959</td><td></td><td></td><td></td><td></td><td class="s"> my ($self) = @_;</td></tr>
+<tr><td class="h"><a name="2960"></a>2960</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2961"></a>2961</td><td></td><td></td><td></td><td></td><td class="s"> return ($self->{attrs} || {})->{alias} || 'me';</td></tr>
+<tr><td class="h"><a name="2962"></a>2962</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="2963"></a>2963</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2964"></a>2964</td><td></td><td></td><td></td><td></td><td class="s">=head2 as_subselect_rs</td></tr>
+<tr><td class="h"><a name="2965"></a>2965</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2966"></a>2966</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="2967"></a>2967</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2968"></a>2968</td><td></td><td></td><td></td><td></td><td class="s">=item Arguments: none</td></tr>
+<tr><td class="h"><a name="2969"></a>2969</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2970"></a>2970</td><td></td><td></td><td></td><td></td><td class="s">=item Return Value: $resultset</td></tr>
+<tr><td class="h"><a name="2971"></a>2971</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2972"></a>2972</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="2973"></a>2973</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2974"></a>2974</td><td></td><td></td><td></td><td></td><td class="s">Act as a barrier to SQL symbols. The resultset provided will be made into a</td></tr>
+<tr><td class="h"><a name="2975"></a>2975</td><td></td><td></td><td></td><td></td><td class="s">"virtual view" by including it as a subquery within the from clause. From this</td></tr>
+<tr><td class="h"><a name="2976"></a>2976</td><td></td><td></td><td></td><td></td><td class="s">point on, any joined tables are inaccessible to ->search on the resultset (as if</td></tr>
+<tr><td class="h"><a name="2977"></a>2977</td><td></td><td></td><td></td><td></td><td class="s">it were simply where-filtered without joins). For example:</td></tr>
+<tr><td class="h"><a name="2978"></a>2978</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2979"></a>2979</td><td></td><td></td><td></td><td></td><td class="s"> my $rs = $schema->resultset('Bar')->search({'x.name' => 'abc'},{ join => 'x' });</td></tr>
+<tr><td class="h"><a name="2980"></a>2980</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2981"></a>2981</td><td></td><td></td><td></td><td></td><td class="s"> # 'x' now pollutes the query namespace</td></tr>
+<tr><td class="h"><a name="2982"></a>2982</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2983"></a>2983</td><td></td><td></td><td></td><td></td><td class="s"> # So the following works as expected</td></tr>
+<tr><td class="h"><a name="2984"></a>2984</td><td></td><td></td><td></td><td></td><td class="s"> my $ok_rs = $rs->search({'x.other' => 1});</td></tr>
+<tr><td class="h"><a name="2985"></a>2985</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2986"></a>2986</td><td></td><td></td><td></td><td></td><td class="s"> # But this doesn't: instead of finding a 'Bar' related to two x rows (abc and</td></tr>
+<tr><td class="h"><a name="2987"></a>2987</td><td></td><td></td><td></td><td></td><td class="s"> # def) we look for one row with contradictory terms and join in another table</td></tr>
+<tr><td class="h"><a name="2988"></a>2988</td><td></td><td></td><td></td><td></td><td class="s"> # (aliased 'x_2') which we never use</td></tr>
+<tr><td class="h"><a name="2989"></a>2989</td><td></td><td></td><td></td><td></td><td class="s"> my $broken_rs = $rs->search({'x.name' => 'def'});</td></tr>
+<tr><td class="h"><a name="2990"></a>2990</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2991"></a>2991</td><td></td><td></td><td></td><td></td><td class="s"> my $rs2 = $rs->as_subselect_rs;</td></tr>
+<tr><td class="h"><a name="2992"></a>2992</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2993"></a>2993</td><td></td><td></td><td></td><td></td><td class="s"> # doesn't work - 'x' is no longer accessible in $rs2, having been sealed away</td></tr>
+<tr><td class="h"><a name="2994"></a>2994</td><td></td><td></td><td></td><td></td><td class="s"> my $not_joined_rs = $rs2->search({'x.other' => 1});</td></tr>
+<tr><td class="h"><a name="2995"></a>2995</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2996"></a>2996</td><td></td><td></td><td></td><td></td><td class="s"> # works as expected: finds a 'table' row related to two x rows (abc and def)</td></tr>
+<tr><td class="h"><a name="2997"></a>2997</td><td></td><td></td><td></td><td></td><td class="s"> my $correctly_joined_rs = $rs2->search({'x.name' => 'def'});</td></tr>
+<tr><td class="h"><a name="2998"></a>2998</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="2999"></a>2999</td><td></td><td></td><td></td><td></td><td class="s">Another example of when one might use this would be to select a subset of</td></tr>
+<tr><td class="h"><a name="3000"></a>3000</td><td></td><td></td><td></td><td></td><td class="s">columns in a group by clause:</td></tr>
+<tr><td class="h"><a name="3001"></a>3001</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3002"></a>3002</td><td></td><td></td><td></td><td></td><td class="s"> my $rs = $schema->resultset('Bar')->search(undef, {</td></tr>
+<tr><td class="h"><a name="3003"></a>3003</td><td></td><td></td><td></td><td></td><td class="s"> group_by => [qw{ id foo_id baz_id }],</td></tr>
+<tr><td class="h"><a name="3004"></a>3004</td><td></td><td></td><td></td><td></td><td class="s"> })->as_subselect_rs->search(undef, {</td></tr>
+<tr><td class="h"><a name="3005"></a>3005</td><td></td><td></td><td></td><td></td><td class="s"> columns => [qw{ id foo_id }]</td></tr>
+<tr><td class="h"><a name="3006"></a>3006</td><td></td><td></td><td></td><td></td><td class="s"> });</td></tr>
+<tr><td class="h"><a name="3007"></a>3007</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3008"></a>3008</td><td></td><td></td><td></td><td></td><td class="s">In the above example normally columns would have to be equal to the group by,</td></tr>
+<tr><td class="h"><a name="3009"></a>3009</td><td></td><td></td><td></td><td></td><td class="s">but because we isolated the group by into a subselect the above works.</td></tr>
+<tr><td class="h"><a name="3010"></a>3010</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3011"></a>3011</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="3012"></a>3012</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3013"></a>3013</td><td></td><td></td><td></td><td></td><td class="s">sub as_subselect_rs {</td></tr>
+<tr><td class="h"><a name="3014"></a>3014</td><td></td><td></td><td></td><td></td><td class="s"> my $self = shift;</td></tr>
+<tr><td class="h"><a name="3015"></a>3015</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3016"></a>3016</td><td></td><td></td><td></td><td></td><td class="s"> my $attrs = $self->_resolved_attrs;</td></tr>
+<tr><td class="h"><a name="3017"></a>3017</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3018"></a>3018</td><td></td><td></td><td></td><td></td><td class="s"> my $fresh_rs = (ref $self)->new (</td></tr>
+<tr><td class="h"><a name="3019"></a>3019</td><td></td><td></td><td></td><td></td><td class="s"> $self->result_source</td></tr>
+<tr><td class="h"><a name="3020"></a>3020</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="3021"></a>3021</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3022"></a>3022</td><td></td><td></td><td></td><td></td><td class="s"> # these pieces will be locked in the subquery</td></tr>
+<tr><td class="h"><a name="3023"></a>3023</td><td></td><td></td><td></td><td></td><td class="s"> delete $fresh_rs->{cond};</td></tr>
+<tr><td class="h"><a name="3024"></a>3024</td><td></td><td></td><td></td><td></td><td class="s"> delete @{$fresh_rs->{attrs}}{qw/where bind/};</td></tr>
+<tr><td class="h"><a name="3025"></a>3025</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3026"></a>3026</td><td></td><td></td><td></td><td></td><td class="s"> return $fresh_rs->search( {}, {</td></tr>
+<tr><td class="h"><a name="3027"></a>3027</td><td></td><td></td><td></td><td></td><td class="s"> from => [{</td></tr>
+<tr><td class="h"><a name="3028"></a>3028</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{alias} => $self->as_query,</td></tr>
+<tr><td class="h"><a name="3029"></a>3029</td><td></td><td></td><td></td><td></td><td class="s"> -alias => $attrs->{alias},</td></tr>
+<tr><td class="h"><a name="3030"></a>3030</td><td></td><td></td><td></td><td></td><td class="s"> -rsrc => $self->result_source,</td></tr>
+<tr><td class="h"><a name="3031"></a>3031</td><td></td><td></td><td></td><td></td><td class="s"> }],</td></tr>
+<tr><td class="h"><a name="3032"></a>3032</td><td></td><td></td><td></td><td></td><td class="s"> alias => $attrs->{alias},</td></tr>
+<tr><td class="h"><a name="3033"></a>3033</td><td></td><td></td><td></td><td></td><td class="s"> });</td></tr>
+<tr><td class="h"><a name="3034"></a>3034</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="3035"></a>3035</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3036"></a>3036</td><td></td><td></td><td></td><td></td><td class="s"># This code is called by search_related, and makes sure there</td></tr>
+<tr><td class="h"><a name="3037"></a>3037</td><td></td><td></td><td></td><td></td><td class="s"># is clear separation between the joins before, during, and</td></tr>
+<tr><td class="h"><a name="3038"></a>3038</td><td></td><td></td><td></td><td></td><td class="s"># after the relationship. This information is needed later</td></tr>
+<tr><td class="h"><a name="3039"></a>3039</td><td></td><td></td><td></td><td></td><td class="s"># in order to properly resolve prefetch aliases (any alias</td></tr>
+<tr><td class="h"><a name="3040"></a>3040</td><td></td><td></td><td></td><td></td><td class="s"># with a relation_chain_depth less than the depth of the</td></tr>
+<tr><td class="h"><a name="3041"></a>3041</td><td></td><td></td><td></td><td></td><td class="s"># current prefetch is not considered)</td></tr>
+<tr><td class="h"><a name="3042"></a>3042</td><td></td><td></td><td></td><td></td><td class="s">#</td></tr>
+<tr><td class="h"><a name="3043"></a>3043</td><td></td><td></td><td></td><td></td><td class="s"># The increments happen twice per join. An even number means a</td></tr>
+<tr><td class="h"><a name="3044"></a>3044</td><td></td><td></td><td></td><td></td><td class="s"># relationship specified via a search_related, whereas an odd</td></tr>
+<tr><td class="h"><a name="3045"></a>3045</td><td></td><td></td><td></td><td></td><td class="s"># number indicates a join/prefetch added via attributes</td></tr>
+<tr><td class="h"><a name="3046"></a>3046</td><td></td><td></td><td></td><td></td><td class="s">#</td></tr>
+<tr><td class="h"><a name="3047"></a>3047</td><td></td><td></td><td></td><td></td><td class="s"># Also this code will wrap the current resultset (the one we</td></tr>
+<tr><td class="h"><a name="3048"></a>3048</td><td></td><td></td><td></td><td></td><td class="s"># chain to) in a subselect IFF it contains limiting attributes</td></tr>
+<tr><td class="h"><a name="3049"></a>3049</td><td></td><td></td><td></td><td></td><td class="s">sub _chain_relationship {</td></tr>
+<tr><td class="h"><a name="3050"></a>3050</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $rel) = @_;</td></tr>
+<tr><td class="h"><a name="3051"></a>3051</td><td></td><td></td><td></td><td></td><td class="s"> my $source = $self->result_source;</td></tr>
+<tr><td class="h"><a name="3052"></a>3052</td><td></td><td></td><td></td><td></td><td class="s"> my $attrs = { %{$self->{attrs}||{}} };</td></tr>
+<tr><td class="h"><a name="3053"></a>3053</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3054"></a>3054</td><td></td><td></td><td></td><td></td><td class="s"> # we need to take the prefetch the attrs into account before we</td></tr>
+<tr><td class="h"><a name="3055"></a>3055</td><td></td><td></td><td></td><td></td><td class="s"> # ->_resolve_join as otherwise they get lost - captainL</td></tr>
+<tr><td class="h"><a name="3056"></a>3056</td><td></td><td></td><td></td><td></td><td class="s"> my $join = $self->_merge_joinpref_attr( $attrs->{join}, $attrs->{prefetch} );</td></tr>
+<tr><td class="h"><a name="3057"></a>3057</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3058"></a>3058</td><td></td><td></td><td></td><td></td><td class="s"> delete @{$attrs}{qw/join prefetch collapse group_by distinct select as columns +select +as +columns/};</td></tr>
+<tr><td class="h"><a name="3059"></a>3059</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3060"></a>3060</td><td></td><td></td><td></td><td></td><td class="s"> my $seen = { %{ (delete $attrs->{seen_join}) || {} } };</td></tr>
+<tr><td class="h"><a name="3061"></a>3061</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3062"></a>3062</td><td></td><td></td><td></td><td></td><td class="s"> my $from;</td></tr>
+<tr><td class="h"><a name="3063"></a>3063</td><td></td><td></td><td></td><td></td><td class="s"> my @force_subq_attrs = qw/offset rows group_by having/;</td></tr>
+<tr><td class="h"><a name="3064"></a>3064</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3065"></a>3065</td><td></td><td></td><td></td><td></td><td class="s"> if (</td></tr>
+<tr><td class="h"><a name="3066"></a>3066</td><td></td><td></td><td></td><td></td><td class="s"> ($attrs->{from} && ref $attrs->{from} ne 'ARRAY')</td></tr>
+<tr><td class="h"><a name="3067"></a>3067</td><td></td><td></td><td></td><td></td><td class="s"> ||</td></tr>
+<tr><td class="h"><a name="3068"></a>3068</td><td></td><td></td><td></td><td></td><td class="s"> $self->_has_resolved_attr (@force_subq_attrs)</td></tr>
+<tr><td class="h"><a name="3069"></a>3069</td><td></td><td></td><td></td><td></td><td class="s"> ) {</td></tr>
+<tr><td class="h"><a name="3070"></a>3070</td><td></td><td></td><td></td><td></td><td class="s"> # Nuke the prefetch (if any) before the new $rs attrs</td></tr>
+<tr><td class="h"><a name="3071"></a>3071</td><td></td><td></td><td></td><td></td><td class="s"> # are resolved (prefetch is useless - we are wrapping</td></tr>
+<tr><td class="h"><a name="3072"></a>3072</td><td></td><td></td><td></td><td></td><td class="s"> # a subquery anyway).</td></tr>
+<tr><td class="h"><a name="3073"></a>3073</td><td></td><td></td><td></td><td></td><td class="s"> my $rs_copy = $self->search;</td></tr>
+<tr><td class="h"><a name="3074"></a>3074</td><td></td><td></td><td></td><td></td><td class="s"> $rs_copy->{attrs}{join} = $self->_merge_joinpref_attr (</td></tr>
+<tr><td class="h"><a name="3075"></a>3075</td><td></td><td></td><td></td><td></td><td class="s"> $rs_copy->{attrs}{join},</td></tr>
+<tr><td class="h"><a name="3076"></a>3076</td><td></td><td></td><td></td><td></td><td class="s"> delete $rs_copy->{attrs}{prefetch},</td></tr>
+<tr><td class="h"><a name="3077"></a>3077</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="3078"></a>3078</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3079"></a>3079</td><td></td><td></td><td></td><td></td><td class="s"> $from = [{</td></tr>
+<tr><td class="h"><a name="3080"></a>3080</td><td></td><td></td><td></td><td></td><td class="s"> -rsrc => $source,</td></tr>
+<tr><td class="h"><a name="3081"></a>3081</td><td></td><td></td><td></td><td></td><td class="s"> -alias => $attrs->{alias},</td></tr>
+<tr><td class="h"><a name="3082"></a>3082</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{alias} => $rs_copy->as_query,</td></tr>
+<tr><td class="h"><a name="3083"></a>3083</td><td></td><td></td><td></td><td></td><td class="s"> }];</td></tr>
+<tr><td class="h"><a name="3084"></a>3084</td><td></td><td></td><td></td><td></td><td class="s"> delete @{$attrs}{@force_subq_attrs, qw/where bind/};</td></tr>
+<tr><td class="h"><a name="3085"></a>3085</td><td></td><td></td><td></td><td></td><td class="s"> $seen->{-relation_chain_depth} = 0;</td></tr>
+<tr><td class="h"><a name="3086"></a>3086</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3087"></a>3087</td><td></td><td></td><td></td><td></td><td class="s"> elsif ($attrs->{from}) { #shallow copy suffices</td></tr>
+<tr><td class="h"><a name="3088"></a>3088</td><td></td><td></td><td></td><td></td><td class="s"> $from = [ @{$attrs->{from}} ];</td></tr>
+<tr><td class="h"><a name="3089"></a>3089</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3090"></a>3090</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="3091"></a>3091</td><td></td><td></td><td></td><td></td><td class="s"> $from = [{</td></tr>
+<tr><td class="h"><a name="3092"></a>3092</td><td></td><td></td><td></td><td></td><td class="s"> -rsrc => $source,</td></tr>
+<tr><td class="h"><a name="3093"></a>3093</td><td></td><td></td><td></td><td></td><td class="s"> -alias => $attrs->{alias},</td></tr>
+<tr><td class="h"><a name="3094"></a>3094</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{alias} => $source->from,</td></tr>
+<tr><td class="h"><a name="3095"></a>3095</td><td></td><td></td><td></td><td></td><td class="s"> }];</td></tr>
+<tr><td class="h"><a name="3096"></a>3096</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3097"></a>3097</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3098"></a>3098</td><td></td><td></td><td></td><td></td><td class="s"> my $jpath = ($seen->{-relation_chain_depth})</td></tr>
+<tr><td class="h"><a name="3099"></a>3099</td><td></td><td></td><td></td><td></td><td class="s"> ? $from->[-1][0]{-join_path}</td></tr>
+<tr><td class="h"><a name="3100"></a>3100</td><td></td><td></td><td></td><td></td><td class="s"> : [];</td></tr>
+<tr><td class="h"><a name="3101"></a>3101</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3102"></a>3102</td><td></td><td></td><td></td><td></td><td class="s"> my @requested_joins = $source->_resolve_join(</td></tr>
+<tr><td class="h"><a name="3103"></a>3103</td><td></td><td></td><td></td><td></td><td class="s"> $join,</td></tr>
+<tr><td class="h"><a name="3104"></a>3104</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{alias},</td></tr>
+<tr><td class="h"><a name="3105"></a>3105</td><td></td><td></td><td></td><td></td><td class="s"> $seen,</td></tr>
+<tr><td class="h"><a name="3106"></a>3106</td><td></td><td></td><td></td><td></td><td class="s"> $jpath,</td></tr>
+<tr><td class="h"><a name="3107"></a>3107</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="3108"></a>3108</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3109"></a>3109</td><td></td><td></td><td></td><td></td><td class="s"> push @$from, @requested_joins;</td></tr>
+<tr><td class="h"><a name="3110"></a>3110</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3111"></a>3111</td><td></td><td></td><td></td><td></td><td class="s"> $seen->{-relation_chain_depth}++;</td></tr>
+<tr><td class="h"><a name="3112"></a>3112</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3113"></a>3113</td><td></td><td></td><td></td><td></td><td class="s"> # if $self already had a join/prefetch specified on it, the requested</td></tr>
+<tr><td class="h"><a name="3114"></a>3114</td><td></td><td></td><td></td><td></td><td class="s"> # $rel might very well be already included. What we do in this case</td></tr>
+<tr><td class="h"><a name="3115"></a>3115</td><td></td><td></td><td></td><td></td><td class="s"> # is effectively a no-op (except that we bump up the chain_depth on</td></tr>
+<tr><td class="h"><a name="3116"></a>3116</td><td></td><td></td><td></td><td></td><td class="s"> # the join in question so we could tell it *is* the search_related)</td></tr>
+<tr><td class="h"><a name="3117"></a>3117</td><td></td><td></td><td></td><td></td><td class="s"> my $already_joined;</td></tr>
+<tr><td class="h"><a name="3118"></a>3118</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3119"></a>3119</td><td></td><td></td><td></td><td></td><td class="s"> # we consider the last one thus reverse</td></tr>
+<tr><td class="h"><a name="3120"></a>3120</td><td></td><td></td><td></td><td></td><td class="s"> for my $j (reverse @requested_joins) {</td></tr>
+<tr><td class="h"><a name="3121"></a>3121</td><td></td><td></td><td></td><td></td><td class="s"> my ($last_j) = keys %{$j->[0]{-join_path}[-1]};</td></tr>
+<tr><td class="h"><a name="3122"></a>3122</td><td></td><td></td><td></td><td></td><td class="s"> if ($rel eq $last_j) {</td></tr>
+<tr><td class="h"><a name="3123"></a>3123</td><td></td><td></td><td></td><td></td><td class="s"> $j->[0]{-relation_chain_depth}++;</td></tr>
+<tr><td class="h"><a name="3124"></a>3124</td><td></td><td></td><td></td><td></td><td class="s"> $already_joined++;</td></tr>
+<tr><td class="h"><a name="3125"></a>3125</td><td></td><td></td><td></td><td></td><td class="s"> last;</td></tr>
+<tr><td class="h"><a name="3126"></a>3126</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3127"></a>3127</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3128"></a>3128</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3129"></a>3129</td><td></td><td></td><td></td><td></td><td class="s"> unless ($already_joined) {</td></tr>
+<tr><td class="h"><a name="3130"></a>3130</td><td></td><td></td><td></td><td></td><td class="s"> push @$from, $source->_resolve_join(</td></tr>
+<tr><td class="h"><a name="3131"></a>3131</td><td></td><td></td><td></td><td></td><td class="s"> $rel,</td></tr>
+<tr><td class="h"><a name="3132"></a>3132</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{alias},</td></tr>
+<tr><td class="h"><a name="3133"></a>3133</td><td></td><td></td><td></td><td></td><td class="s"> $seen,</td></tr>
+<tr><td class="h"><a name="3134"></a>3134</td><td></td><td></td><td></td><td></td><td class="s"> $jpath,</td></tr>
+<tr><td class="h"><a name="3135"></a>3135</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="3136"></a>3136</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3137"></a>3137</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3138"></a>3138</td><td></td><td></td><td></td><td></td><td class="s"> $seen->{-relation_chain_depth}++;</td></tr>
+<tr><td class="h"><a name="3139"></a>3139</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3140"></a>3140</td><td></td><td></td><td></td><td></td><td class="s"> return {%$attrs, from => $from, seen_join => $seen};</td></tr>
+<tr><td class="h"><a name="3141"></a>3141</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="3142"></a>3142</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3143"></a>3143</td><td></td><td></td><td></td><td></td><td class="s"># too many times we have to do $attrs = { %{$self->_resolved_attrs} }</td></tr>
+<tr><td class="h"><a name="3144"></a>3144</td><td></td><td></td><td></td><td></td><td class="s">sub _resolved_attrs_copy {</td></tr>
+<tr><td class="h"><a name="3145"></a>3145</td><td></td><td></td><td></td><td></td><td class="s"> my $self = shift;</td></tr>
+<tr><td class="h"><a name="3146"></a>3146</td><td></td><td></td><td></td><td></td><td class="s"> return { %{$self->_resolved_attrs (@_)} };</td></tr>
+<tr><td class="h"><a name="3147"></a>3147</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="3148"></a>3148</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3149"></a>3149</td><td></td><td></td><td></td><td></td><td class="s">sub _resolved_attrs {</td></tr>
+<tr><td class="h"><a name="3150"></a>3150</td><td></td><td></td><td></td><td></td><td class="s"> my $self = shift;</td></tr>
+<tr><td class="h"><a name="3151"></a>3151</td><td></td><td></td><td></td><td></td><td class="s"> return $self->{_attrs} if $self->{_attrs};</td></tr>
+<tr><td class="h"><a name="3152"></a>3152</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3153"></a>3153</td><td></td><td></td><td></td><td></td><td class="s"> my $attrs = { %{ $self->{attrs} || {} } };</td></tr>
+<tr><td class="h"><a name="3154"></a>3154</td><td></td><td></td><td></td><td></td><td class="s"> my $source = $self->result_source;</td></tr>
+<tr><td class="h"><a name="3155"></a>3155</td><td></td><td></td><td></td><td></td><td class="s"> my $alias = $attrs->{alias};</td></tr>
+<tr><td class="h"><a name="3156"></a>3156</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3157"></a>3157</td><td></td><td></td><td></td><td></td><td class="s"> # default selection list</td></tr>
+<tr><td class="h"><a name="3158"></a>3158</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{columns} = [ $source->columns ]</td></tr>
+<tr><td class="h"><a name="3159"></a>3159</td><td></td><td></td><td></td><td></td><td class="s"> unless List::Util::first { exists $attrs->{$_} } qw/columns cols select as/;</td></tr>
+<tr><td class="h"><a name="3160"></a>3160</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3161"></a>3161</td><td></td><td></td><td></td><td></td><td class="s"> # merge selectors together</td></tr>
+<tr><td class="h"><a name="3162"></a>3162</td><td></td><td></td><td></td><td></td><td class="s"> for (qw/columns select as/) {</td></tr>
+<tr><td class="h"><a name="3163"></a>3163</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{$_} = $self->_merge_attr($attrs->{$_}, delete $attrs->{"+$_"})</td></tr>
+<tr><td class="h"><a name="3164"></a>3164</td><td></td><td></td><td></td><td></td><td class="s"> if $attrs->{$_} or $attrs->{"+$_"};</td></tr>
+<tr><td class="h"><a name="3165"></a>3165</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3166"></a>3166</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3167"></a>3167</td><td></td><td></td><td></td><td></td><td class="s"> # disassemble columns</td></tr>
+<tr><td class="h"><a name="3168"></a>3168</td><td></td><td></td><td></td><td></td><td class="s"> my (@sel, @as);</td></tr>
+<tr><td class="h"><a name="3169"></a>3169</td><td></td><td></td><td></td><td></td><td class="s"> if (my $cols = delete $attrs->{columns}) {</td></tr>
+<tr><td class="h"><a name="3170"></a>3170</td><td></td><td></td><td></td><td></td><td class="s"> for my $c (ref $cols eq 'ARRAY' ? @$cols : $cols) {</td></tr>
+<tr><td class="h"><a name="3171"></a>3171</td><td></td><td></td><td></td><td></td><td class="s"> if (ref $c eq 'HASH') {</td></tr>
+<tr><td class="h"><a name="3172"></a>3172</td><td></td><td></td><td></td><td></td><td class="s"> for my $as (keys %$c) {</td></tr>
+<tr><td class="h"><a name="3173"></a>3173</td><td></td><td></td><td></td><td></td><td class="s"> push @sel, $c->{$as};</td></tr>
+<tr><td class="h"><a name="3174"></a>3174</td><td></td><td></td><td></td><td></td><td class="s"> push @as, $as;</td></tr>
+<tr><td class="h"><a name="3175"></a>3175</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3176"></a>3176</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3177"></a>3177</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="3178"></a>3178</td><td></td><td></td><td></td><td></td><td class="s"> push @sel, $c;</td></tr>
+<tr><td class="h"><a name="3179"></a>3179</td><td></td><td></td><td></td><td></td><td class="s"> push @as, $c;</td></tr>
+<tr><td class="h"><a name="3180"></a>3180</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3181"></a>3181</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3182"></a>3182</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3183"></a>3183</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3184"></a>3184</td><td></td><td></td><td></td><td></td><td class="s"> # when trying to weed off duplicates later do not go past this point -</td></tr>
+<tr><td class="h"><a name="3185"></a>3185</td><td></td><td></td><td></td><td></td><td class="s"> # everything added from here on is unbalanced "anyone's guess" stuff</td></tr>
+<tr><td class="h"><a name="3186"></a>3186</td><td></td><td></td><td></td><td></td><td class="s"> my $dedup_stop_idx = $#as;</td></tr>
+<tr><td class="h"><a name="3187"></a>3187</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3188"></a>3188</td><td></td><td></td><td></td><td></td><td class="s"> push @as, @{ ref $attrs->{as} eq 'ARRAY' ? $attrs->{as} : [ $attrs->{as} ] }</td></tr>
+<tr><td class="h"><a name="3189"></a>3189</td><td></td><td></td><td></td><td></td><td class="s"> if $attrs->{as};</td></tr>
+<tr><td class="h"><a name="3190"></a>3190</td><td></td><td></td><td></td><td></td><td class="s"> push @sel, @{ ref $attrs->{select} eq 'ARRAY' ? $attrs->{select} : [ $attrs->{select} ] }</td></tr>
+<tr><td class="h"><a name="3191"></a>3191</td><td></td><td></td><td></td><td></td><td class="s"> if $attrs->{select};</td></tr>
+<tr><td class="h"><a name="3192"></a>3192</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3193"></a>3193</td><td></td><td></td><td></td><td></td><td class="s"> # assume all unqualified selectors to apply to the current alias (legacy stuff)</td></tr>
+<tr><td class="h"><a name="3194"></a>3194</td><td></td><td></td><td></td><td></td><td class="s"> for (@sel) {</td></tr>
+<tr><td class="h"><a name="3195"></a>3195</td><td></td><td></td><td></td><td></td><td class="s"> $_ = (ref $_ or $_ =~ /\./) ? $_ : "$alias.$_";</td></tr>
+<tr><td class="h"><a name="3196"></a>3196</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3197"></a>3197</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3198"></a>3198</td><td></td><td></td><td></td><td></td><td class="s"> # disqualify all $alias.col as-bits (collapser mandated)</td></tr>
+<tr><td class="h"><a name="3199"></a>3199</td><td></td><td></td><td></td><td></td><td class="s"> for (@as) {</td></tr>
+<tr><td class="h"><a name="3200"></a>3200</td><td></td><td></td><td></td><td></td><td class="s"> $_ = ($_ =~ /^\Q$alias.\E(.+)$/) ? $1 : $_;</td></tr>
+<tr><td class="h"><a name="3201"></a>3201</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3202"></a>3202</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3203"></a>3203</td><td></td><td></td><td></td><td></td><td class="s"> # de-duplicate the result (remove *identical* select/as pairs)</td></tr>
+<tr><td class="h"><a name="3204"></a>3204</td><td></td><td></td><td></td><td></td><td class="s"> # and also die on duplicate {as} pointing to different {select}s</td></tr>
+<tr><td class="h"><a name="3205"></a>3205</td><td></td><td></td><td></td><td></td><td class="s"> # not using a c-style for as the condition is prone to shrinkage</td></tr>
+<tr><td class="h"><a name="3206"></a>3206</td><td></td><td></td><td></td><td></td><td class="s"> my $seen;</td></tr>
+<tr><td class="h"><a name="3207"></a>3207</td><td></td><td></td><td></td><td></td><td class="s"> my $i = 0;</td></tr>
+<tr><td class="h"><a name="3208"></a>3208</td><td></td><td></td><td></td><td></td><td class="s"> while ($i <= $dedup_stop_idx) {</td></tr>
+<tr><td class="h"><a name="3209"></a>3209</td><td></td><td></td><td></td><td></td><td class="s"> if ($seen->{"$sel[$i] \x00\x00 $as[$i]"}++) {</td></tr>
+<tr><td class="h"><a name="3210"></a>3210</td><td></td><td></td><td></td><td></td><td class="s"> splice @sel, $i, 1;</td></tr>
+<tr><td class="h"><a name="3211"></a>3211</td><td></td><td></td><td></td><td></td><td class="s"> splice @as, $i, 1;</td></tr>
+<tr><td class="h"><a name="3212"></a>3212</td><td></td><td></td><td></td><td></td><td class="s"> $dedup_stop_idx--;</td></tr>
+<tr><td class="h"><a name="3213"></a>3213</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3214"></a>3214</td><td></td><td></td><td></td><td></td><td class="s"> elsif ($seen->{$as[$i]}++) {</td></tr>
+<tr><td class="h"><a name="3215"></a>3215</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception(</td></tr>
+<tr><td class="h"><a name="3216"></a>3216</td><td></td><td></td><td></td><td></td><td class="s"> "inflate_result() alias '$as[$i]' specified twice with different SQL-side {select}-ors"</td></tr>
+<tr><td class="h"><a name="3217"></a>3217</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="3218"></a>3218</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3219"></a>3219</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="3220"></a>3220</td><td></td><td></td><td></td><td></td><td class="s"> $i++;</td></tr>
+<tr><td class="h"><a name="3221"></a>3221</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3222"></a>3222</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3223"></a>3223</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3224"></a>3224</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{select} = \@sel;</td></tr>
+<tr><td class="h"><a name="3225"></a>3225</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{as} = \@as;</td></tr>
+<tr><td class="h"><a name="3226"></a>3226</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3227"></a>3227</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{from} ||= [{</td></tr>
+<tr><td class="h"><a name="3228"></a>3228</td><td></td><td></td><td></td><td></td><td class="s"> -rsrc => $source,</td></tr>
+<tr><td class="h"><a name="3229"></a>3229</td><td></td><td></td><td></td><td></td><td class="s"> -alias => $self->{attrs}{alias},</td></tr>
+<tr><td class="h"><a name="3230"></a>3230</td><td></td><td></td><td></td><td></td><td class="s"> $self->{attrs}{alias} => $source->from,</td></tr>
+<tr><td class="h"><a name="3231"></a>3231</td><td></td><td></td><td></td><td></td><td class="s"> }];</td></tr>
+<tr><td class="h"><a name="3232"></a>3232</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3233"></a>3233</td><td></td><td></td><td></td><td></td><td class="s"> if ( $attrs->{join} || $attrs->{prefetch} ) {</td></tr>
+<tr><td class="h"><a name="3234"></a>3234</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3235"></a>3235</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception ('join/prefetch can not be used with a custom {from}')</td></tr>
+<tr><td class="h"><a name="3236"></a>3236</td><td></td><td></td><td></td><td></td><td class="s"> if ref $attrs->{from} ne 'ARRAY';</td></tr>
+<tr><td class="h"><a name="3237"></a>3237</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3238"></a>3238</td><td></td><td></td><td></td><td></td><td class="s"> my $join = (delete $attrs->{join}) || {};</td></tr>
+<tr><td class="h"><a name="3239"></a>3239</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3240"></a>3240</td><td></td><td></td><td></td><td></td><td class="s"> if ( defined $attrs->{prefetch} ) {</td></tr>
+<tr><td class="h"><a name="3241"></a>3241</td><td></td><td></td><td></td><td></td><td class="s"> $join = $self->_merge_joinpref_attr( $join, $attrs->{prefetch} );</td></tr>
+<tr><td class="h"><a name="3242"></a>3242</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3243"></a>3243</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3244"></a>3244</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{from} = # have to copy here to avoid corrupting the original</td></tr>
+<tr><td class="h"><a name="3245"></a>3245</td><td></td><td></td><td></td><td></td><td class="s"> [</td></tr>
+<tr><td class="h"><a name="3246"></a>3246</td><td></td><td></td><td></td><td></td><td class="s"> @{ $attrs->{from} },</td></tr>
+<tr><td class="h"><a name="3247"></a>3247</td><td></td><td></td><td></td><td></td><td class="s"> $source->_resolve_join(</td></tr>
+<tr><td class="h"><a name="3248"></a>3248</td><td></td><td></td><td></td><td></td><td class="s"> $join,</td></tr>
+<tr><td class="h"><a name="3249"></a>3249</td><td></td><td></td><td></td><td></td><td class="s"> $alias,</td></tr>
+<tr><td class="h"><a name="3250"></a>3250</td><td></td><td></td><td></td><td></td><td class="s"> { %{ $attrs->{seen_join} || {} } },</td></tr>
+<tr><td class="h"><a name="3251"></a>3251</td><td></td><td></td><td></td><td></td><td class="s"> ( $attrs->{seen_join} && keys %{$attrs->{seen_join}})</td></tr>
+<tr><td class="h"><a name="3252"></a>3252</td><td></td><td></td><td></td><td></td><td class="s"> ? $attrs->{from}[-1][0]{-join_path}</td></tr>
+<tr><td class="h"><a name="3253"></a>3253</td><td></td><td></td><td></td><td></td><td class="s"> : []</td></tr>
+<tr><td class="h"><a name="3254"></a>3254</td><td></td><td></td><td></td><td></td><td class="s"> ,</td></tr>
+<tr><td class="h"><a name="3255"></a>3255</td><td></td><td></td><td></td><td></td><td class="s"> )</td></tr>
+<tr><td class="h"><a name="3256"></a>3256</td><td></td><td></td><td></td><td></td><td class="s"> ];</td></tr>
+<tr><td class="h"><a name="3257"></a>3257</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3258"></a>3258</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3259"></a>3259</td><td></td><td></td><td></td><td></td><td class="s"> if ( defined $attrs->{order_by} ) {</td></tr>
+<tr><td class="h"><a name="3260"></a>3260</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{order_by} = (</td></tr>
+<tr><td class="h"><a name="3261"></a>3261</td><td></td><td></td><td></td><td></td><td class="s"> ref( $attrs->{order_by} ) eq 'ARRAY'</td></tr>
+<tr><td class="h"><a name="3262"></a>3262</td><td></td><td></td><td></td><td></td><td class="s"> ? [ @{ $attrs->{order_by} } ]</td></tr>
+<tr><td class="h"><a name="3263"></a>3263</td><td></td><td></td><td></td><td></td><td class="s"> : [ $attrs->{order_by} || () ]</td></tr>
+<tr><td class="h"><a name="3264"></a>3264</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="3265"></a>3265</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3266"></a>3266</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3267"></a>3267</td><td></td><td></td><td></td><td></td><td class="s"> if ($attrs->{group_by} and ref $attrs->{group_by} ne 'ARRAY') {</td></tr>
+<tr><td class="h"><a name="3268"></a>3268</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{group_by} = [ $attrs->{group_by} ];</td></tr>
+<tr><td class="h"><a name="3269"></a>3269</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3270"></a>3270</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3271"></a>3271</td><td></td><td></td><td></td><td></td><td class="s"> # generate the distinct induced group_by early, as prefetch will be carried via a</td></tr>
+<tr><td class="h"><a name="3272"></a>3272</td><td></td><td></td><td></td><td></td><td class="s"> # subquery (since a group_by is present)</td></tr>
+<tr><td class="h"><a name="3273"></a>3273</td><td></td><td></td><td></td><td></td><td class="s"> if (delete $attrs->{distinct}) {</td></tr>
+<tr><td class="h"><a name="3274"></a>3274</td><td></td><td></td><td></td><td></td><td class="s"> if ($attrs->{group_by}) {</td></tr>
+<tr><td class="h"><a name="3275"></a>3275</td><td></td><td></td><td></td><td></td><td class="s"> carp_unique ("Useless use of distinct on a grouped resultset ('distinct' is ignored when a 'group_by' is present)");</td></tr>
+<tr><td class="h"><a name="3276"></a>3276</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3277"></a>3277</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="3278"></a>3278</td><td></td><td></td><td></td><td></td><td class="s"> # distinct affects only the main selection part, not what prefetch may</td></tr>
+<tr><td class="h"><a name="3279"></a>3279</td><td></td><td></td><td></td><td></td><td class="s"> # add below.</td></tr>
+<tr><td class="h"><a name="3280"></a>3280</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{group_by} = $source->storage->_group_over_selection (</td></tr>
+<tr><td class="h"><a name="3281"></a>3281</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{from},</td></tr>
+<tr><td class="h"><a name="3282"></a>3282</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{select},</td></tr>
+<tr><td class="h"><a name="3283"></a>3283</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{order_by},</td></tr>
+<tr><td class="h"><a name="3284"></a>3284</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="3285"></a>3285</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3286"></a>3286</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3287"></a>3287</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3288"></a>3288</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{collapse} ||= {};</td></tr>
+<tr><td class="h"><a name="3289"></a>3289</td><td></td><td></td><td></td><td></td><td class="s"> if ($attrs->{prefetch}) {</td></tr>
+<tr><td class="h"><a name="3290"></a>3290</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3291"></a>3291</td><td></td><td></td><td></td><td></td><td class="s"> $self->throw_exception("Unable to prefetch, resultset contains an unnamed selector $attrs->{_dark_selector}{string}")</td></tr>
+<tr><td class="h"><a name="3292"></a>3292</td><td></td><td></td><td></td><td></td><td class="s"> if $attrs->{_dark_selector};</td></tr>
+<tr><td class="h"><a name="3293"></a>3293</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3294"></a>3294</td><td></td><td></td><td></td><td></td><td class="s"> my $prefetch = $self->_merge_joinpref_attr( {}, delete $attrs->{prefetch} );</td></tr>
+<tr><td class="h"><a name="3295"></a>3295</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3296"></a>3296</td><td></td><td></td><td></td><td></td><td class="s"> my $prefetch_ordering = [];</td></tr>
+<tr><td class="h"><a name="3297"></a>3297</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3298"></a>3298</td><td></td><td></td><td></td><td></td><td class="s"> # this is a separate structure (we don't look in {from} directly)</td></tr>
+<tr><td class="h"><a name="3299"></a>3299</td><td></td><td></td><td></td><td></td><td class="s"> # as the resolver needs to shift things off the lists to work</td></tr>
+<tr><td class="h"><a name="3300"></a>3300</td><td></td><td></td><td></td><td></td><td class="s"> # properly (identical-prefetches on different branches)</td></tr>
+<tr><td class="h"><a name="3301"></a>3301</td><td></td><td></td><td></td><td></td><td class="s"> my $join_map = {};</td></tr>
+<tr><td class="h"><a name="3302"></a>3302</td><td></td><td></td><td></td><td></td><td class="s"> if (ref $attrs->{from} eq 'ARRAY') {</td></tr>
+<tr><td class="h"><a name="3303"></a>3303</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3304"></a>3304</td><td></td><td></td><td></td><td></td><td class="s"> my $start_depth = $attrs->{seen_join}{-relation_chain_depth} || 0;</td></tr>
+<tr><td class="h"><a name="3305"></a>3305</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3306"></a>3306</td><td></td><td></td><td></td><td></td><td class="s"> for my $j ( @{$attrs->{from}}[1 .. $#{$attrs->{from}} ] ) {</td></tr>
+<tr><td class="h"><a name="3307"></a>3307</td><td></td><td></td><td></td><td></td><td class="s"> next unless $j->[0]{-alias};</td></tr>
+<tr><td class="h"><a name="3308"></a>3308</td><td></td><td></td><td></td><td></td><td class="s"> next unless $j->[0]{-join_path};</td></tr>
+<tr><td class="h"><a name="3309"></a>3309</td><td></td><td></td><td></td><td></td><td class="s"> next if ($j->[0]{-relation_chain_depth} || 0) < $start_depth;</td></tr>
+<tr><td class="h"><a name="3310"></a>3310</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3311"></a>3311</td><td></td><td></td><td></td><td></td><td class="s"> my @jpath = map { keys %$_ } @{$j->[0]{-join_path}};</td></tr>
+<tr><td class="h"><a name="3312"></a>3312</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3313"></a>3313</td><td></td><td></td><td></td><td></td><td class="s"> my $p = $join_map;</td></tr>
+<tr><td class="h"><a name="3314"></a>3314</td><td></td><td></td><td></td><td></td><td class="s"> $p = $p->{$_} ||= {} for @jpath[ ($start_depth/2) .. $#jpath]; #only even depths are actual jpath boundaries</td></tr>
+<tr><td class="h"><a name="3315"></a>3315</td><td></td><td></td><td></td><td></td><td class="s"> push @{$p->{-join_aliases} }, $j->[0]{-alias};</td></tr>
+<tr><td class="h"><a name="3316"></a>3316</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3317"></a>3317</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3318"></a>3318</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3319"></a>3319</td><td></td><td></td><td></td><td></td><td class="s"> my @prefetch =</td></tr>
+<tr><td class="h"><a name="3320"></a>3320</td><td></td><td></td><td></td><td></td><td class="s"> $source->_resolve_prefetch( $prefetch, $alias, $join_map, $prefetch_ordering, $attrs->{collapse} );</td></tr>
+<tr><td class="h"><a name="3321"></a>3321</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3322"></a>3322</td><td></td><td></td><td></td><td></td><td class="s"> # we need to somehow mark which columns came from prefetch</td></tr>
+<tr><td class="h"><a name="3323"></a>3323</td><td></td><td></td><td></td><td></td><td class="s"> if (@prefetch) {</td></tr>
+<tr><td class="h"><a name="3324"></a>3324</td><td></td><td></td><td></td><td></td><td class="s"> my $sel_end = $#{$attrs->{select}};</td></tr>
+<tr><td class="h"><a name="3325"></a>3325</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{_prefetch_selector_range} = [ $sel_end + 1, $sel_end + @prefetch ];</td></tr>
+<tr><td class="h"><a name="3326"></a>3326</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3327"></a>3327</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3328"></a>3328</td><td></td><td></td><td></td><td></td><td class="s"> push @{ $attrs->{select} }, (map { $_->[0] } @prefetch);</td></tr>
+<tr><td class="h"><a name="3329"></a>3329</td><td></td><td></td><td></td><td></td><td class="s"> push @{ $attrs->{as} }, (map { $_->[1] } @prefetch);</td></tr>
+<tr><td class="h"><a name="3330"></a>3330</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3331"></a>3331</td><td></td><td></td><td></td><td></td><td class="s"> push( @{$attrs->{order_by}}, @$prefetch_ordering );</td></tr>
+<tr><td class="h"><a name="3332"></a>3332</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{_collapse_order_by} = \@$prefetch_ordering;</td></tr>
+<tr><td class="h"><a name="3333"></a>3333</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3334"></a>3334</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3335"></a>3335</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3336"></a>3336</td><td></td><td></td><td></td><td></td><td class="s"> # if both page and offset are specified, produce a combined offset</td></tr>
+<tr><td class="h"><a name="3337"></a>3337</td><td></td><td></td><td></td><td></td><td class="s"> # even though it doesn't make much sense, this is what pre 081xx has</td></tr>
+<tr><td class="h"><a name="3338"></a>3338</td><td></td><td></td><td></td><td></td><td class="s"> # been doing</td></tr>
+<tr><td class="h"><a name="3339"></a>3339</td><td></td><td></td><td></td><td></td><td class="s"> if (my $page = delete $attrs->{page}) {</td></tr>
+<tr><td class="h"><a name="3340"></a>3340</td><td></td><td></td><td></td><td></td><td class="s"> $attrs->{offset} =</td></tr>
+<tr><td class="h"><a name="3341"></a>3341</td><td></td><td></td><td></td><td></td><td class="s"> ($attrs->{rows} * ($page - 1))</td></tr>
+<tr><td class="h"><a name="3342"></a>3342</td><td></td><td></td><td></td><td></td><td class="s"> +</td></tr>
+<tr><td class="h"><a name="3343"></a>3343</td><td></td><td></td><td></td><td></td><td class="s"> ($attrs->{offset} || 0)</td></tr>
+<tr><td class="h"><a name="3344"></a>3344</td><td></td><td></td><td></td><td></td><td class="s"> ;</td></tr>
+<tr><td class="h"><a name="3345"></a>3345</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3346"></a>3346</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3347"></a>3347</td><td></td><td></td><td></td><td></td><td class="s"> return $self->{_attrs} = $attrs;</td></tr>
+<tr><td class="h"><a name="3348"></a>3348</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="3349"></a>3349</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3350"></a>3350</td><td></td><td></td><td></td><td></td><td class="s">sub _rollout_attr {</td></tr>
+<tr><td class="h"><a name="3351"></a>3351</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $attr) = @_;</td></tr>
+<tr><td class="h"><a name="3352"></a>3352</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3353"></a>3353</td><td></td><td></td><td></td><td></td><td class="s"> if (ref $attr eq 'HASH') {</td></tr>
+<tr><td class="h"><a name="3354"></a>3354</td><td></td><td></td><td></td><td></td><td class="s"> return $self->_rollout_hash($attr);</td></tr>
+<tr><td class="h"><a name="3355"></a>3355</td><td></td><td></td><td></td><td></td><td class="s"> } elsif (ref $attr eq 'ARRAY') {</td></tr>
+<tr><td class="h"><a name="3356"></a>3356</td><td></td><td></td><td></td><td></td><td class="s"> return $self->_rollout_array($attr);</td></tr>
+<tr><td class="h"><a name="3357"></a>3357</td><td></td><td></td><td></td><td></td><td class="s"> } else {</td></tr>
+<tr><td class="h"><a name="3358"></a>3358</td><td></td><td></td><td></td><td></td><td class="s"> return [$attr];</td></tr>
+<tr><td class="h"><a name="3359"></a>3359</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3360"></a>3360</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="3361"></a>3361</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3362"></a>3362</td><td></td><td></td><td></td><td></td><td class="s">sub _rollout_array {</td></tr>
+<tr><td class="h"><a name="3363"></a>3363</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $attr) = @_;</td></tr>
+<tr><td class="h"><a name="3364"></a>3364</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3365"></a>3365</td><td></td><td></td><td></td><td></td><td class="s"> my @rolled_array;</td></tr>
+<tr><td class="h"><a name="3366"></a>3366</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $element (@{$attr}) {</td></tr>
+<tr><td class="h"><a name="3367"></a>3367</td><td></td><td></td><td></td><td></td><td class="s"> if (ref $element eq 'HASH') {</td></tr>
+<tr><td class="h"><a name="3368"></a>3368</td><td></td><td></td><td></td><td></td><td class="s"> push( @rolled_array, @{ $self->_rollout_hash( $element ) } );</td></tr>
+<tr><td class="h"><a name="3369"></a>3369</td><td></td><td></td><td></td><td></td><td class="s"> } elsif (ref $element eq 'ARRAY') {</td></tr>
+<tr><td class="h"><a name="3370"></a>3370</td><td></td><td></td><td></td><td></td><td class="s"> # XXX - should probably recurse here</td></tr>
+<tr><td class="h"><a name="3371"></a>3371</td><td></td><td></td><td></td><td></td><td class="s"> push( @rolled_array, @{$self->_rollout_array($element)} );</td></tr>
+<tr><td class="h"><a name="3372"></a>3372</td><td></td><td></td><td></td><td></td><td class="s"> } else {</td></tr>
+<tr><td class="h"><a name="3373"></a>3373</td><td></td><td></td><td></td><td></td><td class="s"> push( @rolled_array, $element );</td></tr>
+<tr><td class="h"><a name="3374"></a>3374</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3375"></a>3375</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3376"></a>3376</td><td></td><td></td><td></td><td></td><td class="s"> return \@rolled_array;</td></tr>
+<tr><td class="h"><a name="3377"></a>3377</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="3378"></a>3378</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3379"></a>3379</td><td></td><td></td><td></td><td></td><td class="s">sub _rollout_hash {</td></tr>
+<tr><td class="h"><a name="3380"></a>3380</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $attr) = @_;</td></tr>
+<tr><td class="h"><a name="3381"></a>3381</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3382"></a>3382</td><td></td><td></td><td></td><td></td><td class="s"> my @rolled_array;</td></tr>
+<tr><td class="h"><a name="3383"></a>3383</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $key (keys %{$attr}) {</td></tr>
+<tr><td class="h"><a name="3384"></a>3384</td><td></td><td></td><td></td><td></td><td class="s"> push( @rolled_array, { $key => $attr->{$key} } );</td></tr>
+<tr><td class="h"><a name="3385"></a>3385</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3386"></a>3386</td><td></td><td></td><td></td><td></td><td class="s"> return \@rolled_array;</td></tr>
+<tr><td class="h"><a name="3387"></a>3387</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="3388"></a>3388</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3389"></a>3389</td><td></td><td></td><td></td><td></td><td class="s">sub _calculate_score {</td></tr>
+<tr><td class="h"><a name="3390"></a>3390</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $a, $b) = @_;</td></tr>
+<tr><td class="h"><a name="3391"></a>3391</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3392"></a>3392</td><td></td><td></td><td></td><td></td><td class="s"> if (defined $a xor defined $b) {</td></tr>
+<tr><td class="h"><a name="3393"></a>3393</td><td></td><td></td><td></td><td></td><td class="s"> return 0;</td></tr>
+<tr><td class="h"><a name="3394"></a>3394</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3395"></a>3395</td><td></td><td></td><td></td><td></td><td class="s"> elsif (not defined $a) {</td></tr>
+<tr><td class="h"><a name="3396"></a>3396</td><td></td><td></td><td></td><td></td><td class="s"> return 1;</td></tr>
+<tr><td class="h"><a name="3397"></a>3397</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3398"></a>3398</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3399"></a>3399</td><td></td><td></td><td></td><td></td><td class="s"> if (ref $b eq 'HASH') {</td></tr>
+<tr><td class="h"><a name="3400"></a>3400</td><td></td><td></td><td></td><td></td><td class="s"> my ($b_key) = keys %{$b};</td></tr>
+<tr><td class="h"><a name="3401"></a>3401</td><td></td><td></td><td></td><td></td><td class="s"> if (ref $a eq 'HASH') {</td></tr>
+<tr><td class="h"><a name="3402"></a>3402</td><td></td><td></td><td></td><td></td><td class="s"> my ($a_key) = keys %{$a};</td></tr>
+<tr><td class="h"><a name="3403"></a>3403</td><td></td><td></td><td></td><td></td><td class="s"> if ($a_key eq $b_key) {</td></tr>
+<tr><td class="h"><a name="3404"></a>3404</td><td></td><td></td><td></td><td></td><td class="s"> return (1 + $self->_calculate_score( $a->{$a_key}, $b->{$b_key} ));</td></tr>
+<tr><td class="h"><a name="3405"></a>3405</td><td></td><td></td><td></td><td></td><td class="s"> } else {</td></tr>
+<tr><td class="h"><a name="3406"></a>3406</td><td></td><td></td><td></td><td></td><td class="s"> return 0;</td></tr>
+<tr><td class="h"><a name="3407"></a>3407</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3408"></a>3408</td><td></td><td></td><td></td><td></td><td class="s"> } else {</td></tr>
+<tr><td class="h"><a name="3409"></a>3409</td><td></td><td></td><td></td><td></td><td class="s"> return ($a eq $b_key) ? 1 : 0;</td></tr>
+<tr><td class="h"><a name="3410"></a>3410</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3411"></a>3411</td><td></td><td></td><td></td><td></td><td class="s"> } else {</td></tr>
+<tr><td class="h"><a name="3412"></a>3412</td><td></td><td></td><td></td><td></td><td class="s"> if (ref $a eq 'HASH') {</td></tr>
+<tr><td class="h"><a name="3413"></a>3413</td><td></td><td></td><td></td><td></td><td class="s"> my ($a_key) = keys %{$a};</td></tr>
+<tr><td class="h"><a name="3414"></a>3414</td><td></td><td></td><td></td><td></td><td class="s"> return ($b eq $a_key) ? 1 : 0;</td></tr>
+<tr><td class="h"><a name="3415"></a>3415</td><td></td><td></td><td></td><td></td><td class="s"> } else {</td></tr>
+<tr><td class="h"><a name="3416"></a>3416</td><td></td><td></td><td></td><td></td><td class="s"> return ($b eq $a) ? 1 : 0;</td></tr>
+<tr><td class="h"><a name="3417"></a>3417</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3418"></a>3418</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3419"></a>3419</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="3420"></a>3420</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3421"></a>3421</td><td></td><td></td><td></td><td></td><td class="s">sub _merge_joinpref_attr {</td></tr>
+<tr><td class="h"><a name="3422"></a>3422</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $orig, $import) = @_;</td></tr>
+<tr><td class="h"><a name="3423"></a>3423</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3424"></a>3424</td><td></td><td></td><td></td><td></td><td class="s"> return $import unless defined($orig);</td></tr>
+<tr><td class="h"><a name="3425"></a>3425</td><td></td><td></td><td></td><td></td><td class="s"> return $orig unless defined($import);</td></tr>
+<tr><td class="h"><a name="3426"></a>3426</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3427"></a>3427</td><td></td><td></td><td></td><td></td><td class="s"> $orig = $self->_rollout_attr($orig);</td></tr>
+<tr><td class="h"><a name="3428"></a>3428</td><td></td><td></td><td></td><td></td><td class="s"> $import = $self->_rollout_attr($import);</td></tr>
+<tr><td class="h"><a name="3429"></a>3429</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3430"></a>3430</td><td></td><td></td><td></td><td></td><td class="s"> my $seen_keys;</td></tr>
+<tr><td class="h"><a name="3431"></a>3431</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $import_element ( @{$import} ) {</td></tr>
+<tr><td class="h"><a name="3432"></a>3432</td><td></td><td></td><td></td><td></td><td class="s"> # find best candidate from $orig to merge $b_element into</td></tr>
+<tr><td class="h"><a name="3433"></a>3433</td><td></td><td></td><td></td><td></td><td class="s"> my $best_candidate = { position => undef, score => 0 }; my $position = 0;</td></tr>
+<tr><td class="h"><a name="3434"></a>3434</td><td></td><td></td><td></td><td></td><td class="s"> foreach my $orig_element ( @{$orig} ) {</td></tr>
+<tr><td class="h"><a name="3435"></a>3435</td><td></td><td></td><td></td><td></td><td class="s"> my $score = $self->_calculate_score( $orig_element, $import_element );</td></tr>
+<tr><td class="h"><a name="3436"></a>3436</td><td></td><td></td><td></td><td></td><td class="s"> if ($score > $best_candidate->{score}) {</td></tr>
+<tr><td class="h"><a name="3437"></a>3437</td><td></td><td></td><td></td><td></td><td class="s"> $best_candidate->{position} = $position;</td></tr>
+<tr><td class="h"><a name="3438"></a>3438</td><td></td><td></td><td></td><td></td><td class="s"> $best_candidate->{score} = $score;</td></tr>
+<tr><td class="h"><a name="3439"></a>3439</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3440"></a>3440</td><td></td><td></td><td></td><td></td><td class="s"> $position++;</td></tr>
+<tr><td class="h"><a name="3441"></a>3441</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3442"></a>3442</td><td></td><td></td><td></td><td></td><td class="s"> my ($import_key) = ( ref $import_element eq 'HASH' ) ? keys %{$import_element} : ($import_element);</td></tr>
+<tr><td class="h"><a name="3443"></a>3443</td><td></td><td></td><td></td><td></td><td class="s"> $import_key = '' if not defined $import_key;</td></tr>
+<tr><td class="h"><a name="3444"></a>3444</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3445"></a>3445</td><td></td><td></td><td></td><td></td><td class="s"> if ($best_candidate->{score} == 0 || exists $seen_keys->{$import_key}) {</td></tr>
+<tr><td class="h"><a name="3446"></a>3446</td><td></td><td></td><td></td><td></td><td class="s"> push( @{$orig}, $import_element );</td></tr>
+<tr><td class="h"><a name="3447"></a>3447</td><td></td><td></td><td></td><td></td><td class="s"> } else {</td></tr>
+<tr><td class="h"><a name="3448"></a>3448</td><td></td><td></td><td></td><td></td><td class="s"> my $orig_best = $orig->[$best_candidate->{position}];</td></tr>
+<tr><td class="h"><a name="3449"></a>3449</td><td></td><td></td><td></td><td></td><td class="s"> # merge orig_best and b_element together and replace original with merged</td></tr>
+<tr><td class="h"><a name="3450"></a>3450</td><td></td><td></td><td></td><td></td><td class="s"> if (ref $orig_best ne 'HASH') {</td></tr>
+<tr><td class="h"><a name="3451"></a>3451</td><td></td><td></td><td></td><td></td><td class="s"> $orig->[$best_candidate->{position}] = $import_element;</td></tr>
+<tr><td class="h"><a name="3452"></a>3452</td><td></td><td></td><td></td><td></td><td class="s"> } elsif (ref $import_element eq 'HASH') {</td></tr>
+<tr><td class="h"><a name="3453"></a>3453</td><td></td><td></td><td></td><td></td><td class="s"> my ($key) = keys %{$orig_best};</td></tr>
+<tr><td class="h"><a name="3454"></a>3454</td><td></td><td></td><td></td><td></td><td class="s"> $orig->[$best_candidate->{position}] = { $key => $self->_merge_joinpref_attr($orig_best->{$key}, $import_element->{$key}) };</td></tr>
+<tr><td class="h"><a name="3455"></a>3455</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3456"></a>3456</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3457"></a>3457</td><td></td><td></td><td></td><td></td><td class="s"> $seen_keys->{$import_key} = 1; # don't merge the same key twice</td></tr>
+<tr><td class="h"><a name="3458"></a>3458</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3459"></a>3459</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3460"></a>3460</td><td></td><td></td><td></td><td></td><td class="s"> return $orig;</td></tr>
+<tr><td class="h"><a name="3461"></a>3461</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="3462"></a>3462</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3463"></a>3463</td><td></td><td></td><td></td><td></td><td class="s">{</td></tr>
+<tr><td class="h"><a name="3464"></a>3464</td><td class="c3">2</td><td class="c3"><span title="Avg 150ns">300ns</span></td><td></td><td></td><td class="s"> my $hm;</td></tr>
+<tr><td class="h"><a name="3465"></a>3465</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3466"></a>3466</td><td></td><td></td><td></td><td></td><td class="s"> sub _merge_attr {</td></tr>
+<tr><td class="h"><a name="3467"></a>3467</td><td></td><td></td><td></td><td></td><td class="s"> $hm ||= do {</td></tr>
+<tr><td class="h"><a name="3468"></a>3468</td><td></td><td></td><td></td><td></td><td class="s"> require Hash::Merge;</td></tr>
+<tr><td class="h"><a name="3469"></a>3469</td><td></td><td></td><td></td><td></td><td class="s"> my $hm = Hash::Merge->new;</td></tr>
+<tr><td class="h"><a name="3470"></a>3470</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3471"></a>3471</td><td></td><td></td><td></td><td></td><td class="s"> $hm->specify_behavior({</td></tr>
+<tr><td class="h"><a name="3472"></a>3472</td><td></td><td></td><td></td><td></td><td class="s"> SCALAR => {</td></tr>
+<tr><td class="h"><a name="3473"></a>3473</td><td></td><td></td><td></td><td></td><td class="s"> SCALAR => sub {</td></tr>
+<tr><td class="h"><a name="3474"></a>3474</td><td></td><td></td><td></td><td></td><td class="s"> my ($defl, $defr) = map { defined $_ } (@_[0,1]);</td></tr>
+<tr><td class="h"><a name="3475"></a>3475</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3476"></a>3476</td><td></td><td></td><td></td><td></td><td class="s"> if ($defl xor $defr) {</td></tr>
+<tr><td class="h"><a name="3477"></a>3477</td><td></td><td></td><td></td><td></td><td class="s"> return [ $defl ? $_[0] : $_[1] ];</td></tr>
+<tr><td class="h"><a name="3478"></a>3478</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3479"></a>3479</td><td></td><td></td><td></td><td></td><td class="s"> elsif (! $defl) {</td></tr>
+<tr><td class="h"><a name="3480"></a>3480</td><td></td><td></td><td></td><td></td><td class="s"> return [];</td></tr>
+<tr><td class="h"><a name="3481"></a>3481</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3482"></a>3482</td><td></td><td></td><td></td><td></td><td class="s"> elsif (__HM_DEDUP and $_[0] eq $_[1]) {</td></tr>
+<tr><td class="h"><a name="3483"></a>3483</td><td></td><td></td><td></td><td></td><td class="s"> return [ $_[0] ];</td></tr>
+<tr><td class="h"><a name="3484"></a>3484</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3485"></a>3485</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="3486"></a>3486</td><td></td><td></td><td></td><td></td><td class="s"> return [$_[0], $_[1]];</td></tr>
+<tr><td class="h"><a name="3487"></a>3487</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3488"></a>3488</td><td></td><td></td><td></td><td></td><td class="s"> },</td></tr>
+<tr><td class="h"><a name="3489"></a>3489</td><td></td><td></td><td></td><td></td><td class="s"> ARRAY => sub {</td></tr>
+<tr><td class="h"><a name="3490"></a>3490</td><td></td><td></td><td></td><td></td><td class="s"> return $_[1] if !defined $_[0];</td></tr>
+<tr><td class="h"><a name="3491"></a>3491</td><td></td><td></td><td></td><td></td><td class="s"> return $_[1] if __HM_DEDUP and List::Util::first { $_ eq $_[0] } @{$_[1]};</td></tr>
+<tr><td class="h"><a name="3492"></a>3492</td><td></td><td></td><td></td><td></td><td class="s"> return [$_[0], @{$_[1]}]</td></tr>
+<tr><td class="h"><a name="3493"></a>3493</td><td></td><td></td><td></td><td></td><td class="s"> },</td></tr>
+<tr><td class="h"><a name="3494"></a>3494</td><td></td><td></td><td></td><td></td><td class="s"> HASH => sub {</td></tr>
+<tr><td class="h"><a name="3495"></a>3495</td><td></td><td></td><td></td><td></td><td class="s"> return [] if !defined $_[0] and !keys %{$_[1]};</td></tr>
+<tr><td class="h"><a name="3496"></a>3496</td><td></td><td></td><td></td><td></td><td class="s"> return [ $_[1] ] if !defined $_[0];</td></tr>
+<tr><td class="h"><a name="3497"></a>3497</td><td></td><td></td><td></td><td></td><td class="s"> return [ $_[0] ] if !keys %{$_[1]};</td></tr>
+<tr><td class="h"><a name="3498"></a>3498</td><td></td><td></td><td></td><td></td><td class="s"> return [$_[0], $_[1]]</td></tr>
+<tr><td class="h"><a name="3499"></a>3499</td><td></td><td></td><td></td><td></td><td class="s"> },</td></tr>
+<tr><td class="h"><a name="3500"></a>3500</td><td></td><td></td><td></td><td></td><td class="s"> },</td></tr>
+<tr><td class="h"><a name="3501"></a>3501</td><td></td><td></td><td></td><td></td><td class="s"> ARRAY => {</td></tr>
+<tr><td class="h"><a name="3502"></a>3502</td><td></td><td></td><td></td><td></td><td class="s"> SCALAR => sub {</td></tr>
+<tr><td class="h"><a name="3503"></a>3503</td><td></td><td></td><td></td><td></td><td class="s"> return $_[0] if !defined $_[1];</td></tr>
+<tr><td class="h"><a name="3504"></a>3504</td><td></td><td></td><td></td><td></td><td class="s"> return $_[0] if __HM_DEDUP and List::Util::first { $_ eq $_[1] } @{$_[0]};</td></tr>
+<tr><td class="h"><a name="3505"></a>3505</td><td></td><td></td><td></td><td></td><td class="s"> return [@{$_[0]}, $_[1]]</td></tr>
+<tr><td class="h"><a name="3506"></a>3506</td><td></td><td></td><td></td><td></td><td class="s"> },</td></tr>
+<tr><td class="h"><a name="3507"></a>3507</td><td></td><td></td><td></td><td></td><td class="s"> ARRAY => sub {</td></tr>
+<tr><td class="h"><a name="3508"></a>3508</td><td></td><td></td><td></td><td></td><td class="s"> my @ret = @{$_[0]} or return $_[1];</td></tr>
+<tr><td class="h"><a name="3509"></a>3509</td><td></td><td></td><td></td><td></td><td class="s"> return [ @ret, @{$_[1]} ] unless __HM_DEDUP;</td></tr>
+<tr><td class="h"><a name="3510"></a>3510</td><td></td><td></td><td></td><td></td><td class="s"> my %idx = map { $_ => 1 } @ret;</td></tr>
+<tr><td class="h"><a name="3511"></a>3511</td><td></td><td></td><td></td><td></td><td class="s"> push @ret, grep { ! defined $idx{$_} } (@{$_[1]});</td></tr>
+<tr><td class="h"><a name="3512"></a>3512</td><td></td><td></td><td></td><td></td><td class="s"> \@ret;</td></tr>
+<tr><td class="h"><a name="3513"></a>3513</td><td></td><td></td><td></td><td></td><td class="s"> },</td></tr>
+<tr><td class="h"><a name="3514"></a>3514</td><td></td><td></td><td></td><td></td><td class="s"> HASH => sub {</td></tr>
+<tr><td class="h"><a name="3515"></a>3515</td><td></td><td></td><td></td><td></td><td class="s"> return [ $_[1] ] if ! @{$_[0]};</td></tr>
+<tr><td class="h"><a name="3516"></a>3516</td><td></td><td></td><td></td><td></td><td class="s"> return $_[0] if !keys %{$_[1]};</td></tr>
+<tr><td class="h"><a name="3517"></a>3517</td><td></td><td></td><td></td><td></td><td class="s"> return $_[0] if __HM_DEDUP and List::Util::first { $_ eq $_[1] } @{$_[0]};</td></tr>
+<tr><td class="h"><a name="3518"></a>3518</td><td></td><td></td><td></td><td></td><td class="s"> return [ @{$_[0]}, $_[1] ];</td></tr>
+<tr><td class="h"><a name="3519"></a>3519</td><td></td><td></td><td></td><td></td><td class="s"> },</td></tr>
+<tr><td class="h"><a name="3520"></a>3520</td><td></td><td></td><td></td><td></td><td class="s"> },</td></tr>
+<tr><td class="h"><a name="3521"></a>3521</td><td></td><td></td><td></td><td></td><td class="s"> HASH => {</td></tr>
+<tr><td class="h"><a name="3522"></a>3522</td><td></td><td></td><td></td><td></td><td class="s"> SCALAR => sub {</td></tr>
+<tr><td class="h"><a name="3523"></a>3523</td><td></td><td></td><td></td><td></td><td class="s"> return [] if !keys %{$_[0]} and !defined $_[1];</td></tr>
+<tr><td class="h"><a name="3524"></a>3524</td><td></td><td></td><td></td><td></td><td class="s"> return [ $_[0] ] if !defined $_[1];</td></tr>
+<tr><td class="h"><a name="3525"></a>3525</td><td></td><td></td><td></td><td></td><td class="s"> return [ $_[1] ] if !keys %{$_[0]};</td></tr>
+<tr><td class="h"><a name="3526"></a>3526</td><td></td><td></td><td></td><td></td><td class="s"> return [$_[0], $_[1]]</td></tr>
+<tr><td class="h"><a name="3527"></a>3527</td><td></td><td></td><td></td><td></td><td class="s"> },</td></tr>
+<tr><td class="h"><a name="3528"></a>3528</td><td></td><td></td><td></td><td></td><td class="s"> ARRAY => sub {</td></tr>
+<tr><td class="h"><a name="3529"></a>3529</td><td></td><td></td><td></td><td></td><td class="s"> return [] if !keys %{$_[0]} and !@{$_[1]};</td></tr>
+<tr><td class="h"><a name="3530"></a>3530</td><td></td><td></td><td></td><td></td><td class="s"> return [ $_[0] ] if !@{$_[1]};</td></tr>
+<tr><td class="h"><a name="3531"></a>3531</td><td></td><td></td><td></td><td></td><td class="s"> return $_[1] if !keys %{$_[0]};</td></tr>
+<tr><td class="h"><a name="3532"></a>3532</td><td></td><td></td><td></td><td></td><td class="s"> return $_[1] if __HM_DEDUP and List::Util::first { $_ eq $_[0] } @{$_[1]};</td></tr>
+<tr><td class="h"><a name="3533"></a>3533</td><td></td><td></td><td></td><td></td><td class="s"> return [ $_[0], @{$_[1]} ];</td></tr>
+<tr><td class="h"><a name="3534"></a>3534</td><td></td><td></td><td></td><td></td><td class="s"> },</td></tr>
+<tr><td class="h"><a name="3535"></a>3535</td><td></td><td></td><td></td><td></td><td class="s"> HASH => sub {</td></tr>
+<tr><td class="h"><a name="3536"></a>3536</td><td></td><td></td><td></td><td></td><td class="s"> return [] if !keys %{$_[0]} and !keys %{$_[1]};</td></tr>
+<tr><td class="h"><a name="3537"></a>3537</td><td></td><td></td><td></td><td></td><td class="s"> return [ $_[0] ] if !keys %{$_[1]};</td></tr>
+<tr><td class="h"><a name="3538"></a>3538</td><td></td><td></td><td></td><td></td><td class="s"> return [ $_[1] ] if !keys %{$_[0]};</td></tr>
+<tr><td class="h"><a name="3539"></a>3539</td><td></td><td></td><td></td><td></td><td class="s"> return [ $_[0] ] if $_[0] eq $_[1];</td></tr>
+<tr><td class="h"><a name="3540"></a>3540</td><td></td><td></td><td></td><td></td><td class="s"> return [ $_[0], $_[1] ];</td></tr>
+<tr><td class="h"><a name="3541"></a>3541</td><td></td><td></td><td></td><td></td><td class="s"> },</td></tr>
+<tr><td class="h"><a name="3542"></a>3542</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3543"></a>3543</td><td></td><td></td><td></td><td></td><td class="s"> } => 'DBIC_RS_ATTR_MERGER');</td></tr>
+<tr><td class="h"><a name="3544"></a>3544</td><td></td><td></td><td></td><td></td><td class="s"> $hm;</td></tr>
+<tr><td class="h"><a name="3545"></a>3545</td><td></td><td></td><td></td><td></td><td class="s"> };</td></tr>
+<tr><td class="h"><a name="3546"></a>3546</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3547"></a>3547</td><td></td><td></td><td></td><td></td><td class="s"> return $hm->merge ($_[1], $_[2]);</td></tr>
+<tr><td class="h"><a name="3548"></a>3548</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3549"></a>3549</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="3550"></a>3550</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3551"></a>3551</td><td></td><td></td><td></td><td></td><td class="s">sub STORABLE_freeze {</td></tr>
+<tr><td class="h"><a name="3552"></a>3552</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $cloning) = @_;</td></tr>
+<tr><td class="h"><a name="3553"></a>3553</td><td></td><td></td><td></td><td></td><td class="s"> my $to_serialize = { %$self };</td></tr>
+<tr><td class="h"><a name="3554"></a>3554</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3555"></a>3555</td><td></td><td></td><td></td><td></td><td class="s"> # A cursor in progress can't be serialized (and would make little sense anyway)</td></tr>
+<tr><td class="h"><a name="3556"></a>3556</td><td></td><td></td><td></td><td></td><td class="s"> delete $to_serialize->{cursor};</td></tr>
+<tr><td class="h"><a name="3557"></a>3557</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3558"></a>3558</td><td></td><td></td><td></td><td></td><td class="s"> # nor is it sensical to store a not-yet-fired-count pager</td></tr>
+<tr><td class="h"><a name="3559"></a>3559</td><td></td><td></td><td></td><td></td><td class="s"> if ($to_serialize->{pager} and ref $to_serialize->{pager}{total_entries} eq 'CODE') {</td></tr>
+<tr><td class="h"><a name="3560"></a>3560</td><td></td><td></td><td></td><td></td><td class="s"> delete $to_serialize->{pager};</td></tr>
+<tr><td class="h"><a name="3561"></a>3561</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3562"></a>3562</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3563"></a>3563</td><td></td><td></td><td></td><td></td><td class="s"> Storable::nfreeze($to_serialize);</td></tr>
+<tr><td class="h"><a name="3564"></a>3564</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="3565"></a>3565</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3566"></a>3566</td><td></td><td></td><td></td><td></td><td class="s"># need this hook for symmetry</td></tr>
+<tr><td class="h"><a name="3567"></a>3567</td><td></td><td></td><td></td><td></td><td class="s">sub STORABLE_thaw {</td></tr>
+<tr><td class="h"><a name="3568"></a>3568</td><td></td><td></td><td></td><td></td><td class="s"> my ($self, $cloning, $serialized) = @_;</td></tr>
+<tr><td class="h"><a name="3569"></a>3569</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3570"></a>3570</td><td></td><td></td><td></td><td></td><td class="s"> %$self = %{ Storable::thaw($serialized) };</td></tr>
+<tr><td class="h"><a name="3571"></a>3571</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3572"></a>3572</td><td></td><td></td><td></td><td></td><td class="s"> $self;</td></tr>
+<tr><td class="h"><a name="3573"></a>3573</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="3574"></a>3574</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3575"></a>3575</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3576"></a>3576</td><td></td><td></td><td></td><td></td><td class="s">=head2 throw_exception</td></tr>
+<tr><td class="h"><a name="3577"></a>3577</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3578"></a>3578</td><td></td><td></td><td></td><td></td><td class="s">See L<DBIx::Class::Schema/throw_exception> for details.</td></tr>
+<tr><td class="h"><a name="3579"></a>3579</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3580"></a>3580</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="3581"></a>3581</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3582"></a>3582</td><td></td><td></td><td></td><td></td><td class="s">sub throw_exception {</td></tr>
+<tr><td class="h"><a name="3583"></a>3583</td><td></td><td></td><td></td><td></td><td class="s"> my $self=shift;</td></tr>
+<tr><td class="h"><a name="3584"></a>3584</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3585"></a>3585</td><td></td><td></td><td></td><td></td><td class="s"> if (ref $self and my $rsrc = $self->result_source) {</td></tr>
+<tr><td class="h"><a name="3586"></a>3586</td><td></td><td></td><td></td><td></td><td class="s"> $rsrc->throw_exception(@_)</td></tr>
+<tr><td class="h"><a name="3587"></a>3587</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3588"></a>3588</td><td></td><td></td><td></td><td></td><td class="s"> else {</td></tr>
+<tr><td class="h"><a name="3589"></a>3589</td><td></td><td></td><td></td><td></td><td class="s"> DBIx::Class::Exception->throw(@_);</td></tr>
+<tr><td class="h"><a name="3590"></a>3590</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3591"></a>3591</td><td></td><td></td><td></td><td></td><td class="s">}</td></tr>
+<tr><td class="h"><a name="3592"></a>3592</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3593"></a>3593</td><td></td><td></td><td></td><td></td><td class="s"># XXX: FIXME: Attributes docs need clearing up</td></tr>
+<tr><td class="h"><a name="3594"></a>3594</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3595"></a>3595</td><td></td><td></td><td></td><td></td><td class="s">=head1 ATTRIBUTES</td></tr>
+<tr><td class="h"><a name="3596"></a>3596</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3597"></a>3597</td><td></td><td></td><td></td><td></td><td class="s">Attributes are used to refine a ResultSet in various ways when</td></tr>
+<tr><td class="h"><a name="3598"></a>3598</td><td></td><td></td><td></td><td></td><td class="s">searching for data. They can be passed to any method which takes an</td></tr>
+<tr><td class="h"><a name="3599"></a>3599</td><td></td><td></td><td></td><td></td><td class="s">C<\%attrs> argument. See L</search>, L</search_rs>, L</find>,</td></tr>
+<tr><td class="h"><a name="3600"></a>3600</td><td></td><td></td><td></td><td></td><td class="s">L</count>.</td></tr>
+<tr><td class="h"><a name="3601"></a>3601</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3602"></a>3602</td><td></td><td></td><td></td><td></td><td class="s">These are in no particular order:</td></tr>
+<tr><td class="h"><a name="3603"></a>3603</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3604"></a>3604</td><td></td><td></td><td></td><td></td><td class="s">=head2 order_by</td></tr>
+<tr><td class="h"><a name="3605"></a>3605</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3606"></a>3606</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="3607"></a>3607</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3608"></a>3608</td><td></td><td></td><td></td><td></td><td class="s">=item Value: ( $order_by | \@order_by | \%order_by )</td></tr>
+<tr><td class="h"><a name="3609"></a>3609</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3610"></a>3610</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="3611"></a>3611</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3612"></a>3612</td><td></td><td></td><td></td><td></td><td class="s">Which column(s) to order the results by.</td></tr>
+<tr><td class="h"><a name="3613"></a>3613</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3614"></a>3614</td><td></td><td></td><td></td><td></td><td class="s">[The full list of suitable values is documented in</td></tr>
+<tr><td class="h"><a name="3615"></a>3615</td><td></td><td></td><td></td><td></td><td class="s">L<SQL::Abstract/"ORDER BY CLAUSES">; the following is a summary of</td></tr>
+<tr><td class="h"><a name="3616"></a>3616</td><td></td><td></td><td></td><td></td><td class="s">common options.]</td></tr>
+<tr><td class="h"><a name="3617"></a>3617</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3618"></a>3618</td><td></td><td></td><td></td><td></td><td class="s">If a single column name, or an arrayref of names is supplied, the</td></tr>
+<tr><td class="h"><a name="3619"></a>3619</td><td></td><td></td><td></td><td></td><td class="s">argument is passed through directly to SQL. The hashref syntax allows</td></tr>
+<tr><td class="h"><a name="3620"></a>3620</td><td></td><td></td><td></td><td></td><td class="s">for connection-agnostic specification of ordering direction:</td></tr>
+<tr><td class="h"><a name="3621"></a>3621</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3622"></a>3622</td><td></td><td></td><td></td><td></td><td class="s"> For descending order:</td></tr>
+<tr><td class="h"><a name="3623"></a>3623</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3624"></a>3624</td><td></td><td></td><td></td><td></td><td class="s"> order_by => { -desc => [qw/col1 col2 col3/] }</td></tr>
+<tr><td class="h"><a name="3625"></a>3625</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3626"></a>3626</td><td></td><td></td><td></td><td></td><td class="s"> For explicit ascending order:</td></tr>
+<tr><td class="h"><a name="3627"></a>3627</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3628"></a>3628</td><td></td><td></td><td></td><td></td><td class="s"> order_by => { -asc => 'col' }</td></tr>
+<tr><td class="h"><a name="3629"></a>3629</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3630"></a>3630</td><td></td><td></td><td></td><td></td><td class="s">The old scalarref syntax (i.e. order_by => \'year DESC') is still</td></tr>
+<tr><td class="h"><a name="3631"></a>3631</td><td></td><td></td><td></td><td></td><td class="s">supported, although you are strongly encouraged to use the hashref</td></tr>
+<tr><td class="h"><a name="3632"></a>3632</td><td></td><td></td><td></td><td></td><td class="s">syntax as outlined above.</td></tr>
+<tr><td class="h"><a name="3633"></a>3633</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3634"></a>3634</td><td></td><td></td><td></td><td></td><td class="s">=head2 columns</td></tr>
+<tr><td class="h"><a name="3635"></a>3635</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3636"></a>3636</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="3637"></a>3637</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3638"></a>3638</td><td></td><td></td><td></td><td></td><td class="s">=item Value: \@columns</td></tr>
+<tr><td class="h"><a name="3639"></a>3639</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3640"></a>3640</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="3641"></a>3641</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3642"></a>3642</td><td></td><td></td><td></td><td></td><td class="s">Shortcut to request a particular set of columns to be retrieved. Each</td></tr>
+<tr><td class="h"><a name="3643"></a>3643</td><td></td><td></td><td></td><td></td><td class="s">column spec may be a string (a table column name), or a hash (in which</td></tr>
+<tr><td class="h"><a name="3644"></a>3644</td><td></td><td></td><td></td><td></td><td class="s">case the key is the C<as> value, and the value is used as the C<select></td></tr>
+<tr><td class="h"><a name="3645"></a>3645</td><td></td><td></td><td></td><td></td><td class="s">expression). Adds C<me.> onto the start of any column without a C<.> in</td></tr>
+<tr><td class="h"><a name="3646"></a>3646</td><td></td><td></td><td></td><td></td><td class="s">it and sets C<select> from that, then auto-populates C<as> from</td></tr>
+<tr><td class="h"><a name="3647"></a>3647</td><td></td><td></td><td></td><td></td><td class="s">C<select> as normal. (You may also use the C<cols> attribute, as in</td></tr>
+<tr><td class="h"><a name="3648"></a>3648</td><td></td><td></td><td></td><td></td><td class="s">earlier versions of DBIC.)</td></tr>
+<tr><td class="h"><a name="3649"></a>3649</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3650"></a>3650</td><td></td><td></td><td></td><td></td><td class="s">Essentially C<columns> does the same as L</select> and L</as>.</td></tr>
+<tr><td class="h"><a name="3651"></a>3651</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3652"></a>3652</td><td></td><td></td><td></td><td></td><td class="s"> columns => [ 'foo', { bar => 'baz' } ]</td></tr>
+<tr><td class="h"><a name="3653"></a>3653</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3654"></a>3654</td><td></td><td></td><td></td><td></td><td class="s">is the same as</td></tr>
+<tr><td class="h"><a name="3655"></a>3655</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3656"></a>3656</td><td></td><td></td><td></td><td></td><td class="s"> select => [qw/foo baz/],</td></tr>
+<tr><td class="h"><a name="3657"></a>3657</td><td></td><td></td><td></td><td></td><td class="s"> as => [qw/foo bar/]</td></tr>
+<tr><td class="h"><a name="3658"></a>3658</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3659"></a>3659</td><td></td><td></td><td></td><td></td><td class="s">=head2 +columns</td></tr>
+<tr><td class="h"><a name="3660"></a>3660</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3661"></a>3661</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="3662"></a>3662</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3663"></a>3663</td><td></td><td></td><td></td><td></td><td class="s">=item Value: \@columns</td></tr>
+<tr><td class="h"><a name="3664"></a>3664</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3665"></a>3665</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="3666"></a>3666</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3667"></a>3667</td><td></td><td></td><td></td><td></td><td class="s">Indicates additional columns to be selected from storage. Works the same</td></tr>
+<tr><td class="h"><a name="3668"></a>3668</td><td></td><td></td><td></td><td></td><td class="s">as L</columns> but adds columns to the selection. (You may also use the</td></tr>
+<tr><td class="h"><a name="3669"></a>3669</td><td></td><td></td><td></td><td></td><td class="s">C<include_columns> attribute, as in earlier versions of DBIC). For</td></tr>
+<tr><td class="h"><a name="3670"></a>3670</td><td></td><td></td><td></td><td></td><td class="s">example:-</td></tr>
+<tr><td class="h"><a name="3671"></a>3671</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3672"></a>3672</td><td></td><td></td><td></td><td></td><td class="s"> $schema->resultset('CD')->search(undef, {</td></tr>
+<tr><td class="h"><a name="3673"></a>3673</td><td></td><td></td><td></td><td></td><td class="s"> '+columns' => ['artist.name'],</td></tr>
+<tr><td class="h"><a name="3674"></a>3674</td><td></td><td></td><td></td><td></td><td class="s"> join => ['artist']</td></tr>
+<tr><td class="h"><a name="3675"></a>3675</td><td></td><td></td><td></td><td></td><td class="s"> });</td></tr>
+<tr><td class="h"><a name="3676"></a>3676</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3677"></a>3677</td><td></td><td></td><td></td><td></td><td class="s">would return all CDs and include a 'name' column to the information</td></tr>
+<tr><td class="h"><a name="3678"></a>3678</td><td></td><td></td><td></td><td></td><td class="s">passed to object inflation. Note that the 'artist' is the name of the</td></tr>
+<tr><td class="h"><a name="3679"></a>3679</td><td></td><td></td><td></td><td></td><td class="s">column (or relationship) accessor, and 'name' is the name of the column</td></tr>
+<tr><td class="h"><a name="3680"></a>3680</td><td></td><td></td><td></td><td></td><td class="s">accessor in the related table.</td></tr>
+<tr><td class="h"><a name="3681"></a>3681</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3682"></a>3682</td><td></td><td></td><td></td><td></td><td class="s">B<NOTE:> You need to explicitly quote '+columns' when defining the attribute.</td></tr>
+<tr><td class="h"><a name="3683"></a>3683</td><td></td><td></td><td></td><td></td><td class="s">Not doing so causes Perl to incorrectly interpret +columns as a bareword with a</td></tr>
+<tr><td class="h"><a name="3684"></a>3684</td><td></td><td></td><td></td><td></td><td class="s">unary plus operator before it.</td></tr>
+<tr><td class="h"><a name="3685"></a>3685</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3686"></a>3686</td><td></td><td></td><td></td><td></td><td class="s">=head2 include_columns</td></tr>
+<tr><td class="h"><a name="3687"></a>3687</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3688"></a>3688</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="3689"></a>3689</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3690"></a>3690</td><td></td><td></td><td></td><td></td><td class="s">=item Value: \@columns</td></tr>
+<tr><td class="h"><a name="3691"></a>3691</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3692"></a>3692</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="3693"></a>3693</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3694"></a>3694</td><td></td><td></td><td></td><td></td><td class="s">Deprecated. Acts as a synonym for L</+columns> for backward compatibility.</td></tr>
+<tr><td class="h"><a name="3695"></a>3695</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3696"></a>3696</td><td></td><td></td><td></td><td></td><td class="s">=head2 select</td></tr>
+<tr><td class="h"><a name="3697"></a>3697</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3698"></a>3698</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="3699"></a>3699</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3700"></a>3700</td><td></td><td></td><td></td><td></td><td class="s">=item Value: \@select_columns</td></tr>
+<tr><td class="h"><a name="3701"></a>3701</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3702"></a>3702</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="3703"></a>3703</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3704"></a>3704</td><td></td><td></td><td></td><td></td><td class="s">Indicates which columns should be selected from the storage. You can use</td></tr>
+<tr><td class="h"><a name="3705"></a>3705</td><td></td><td></td><td></td><td></td><td class="s">column names, or in the case of RDBMS back ends, function or stored procedure</td></tr>
+<tr><td class="h"><a name="3706"></a>3706</td><td></td><td></td><td></td><td></td><td class="s">names:</td></tr>
+<tr><td class="h"><a name="3707"></a>3707</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3708"></a>3708</td><td></td><td></td><td></td><td></td><td class="s"> $rs = $schema->resultset('Employee')->search(undef, {</td></tr>
+<tr><td class="h"><a name="3709"></a>3709</td><td></td><td></td><td></td><td></td><td class="s"> select => [</td></tr>
+<tr><td class="h"><a name="3710"></a>3710</td><td></td><td></td><td></td><td></td><td class="s"> 'name',</td></tr>
+<tr><td class="h"><a name="3711"></a>3711</td><td></td><td></td><td></td><td></td><td class="s"> { count => 'employeeid' },</td></tr>
+<tr><td class="h"><a name="3712"></a>3712</td><td></td><td></td><td></td><td></td><td class="s"> { max => { length => 'name' }, -as => 'longest_name' }</td></tr>
+<tr><td class="h"><a name="3713"></a>3713</td><td></td><td></td><td></td><td></td><td class="s"> ]</td></tr>
+<tr><td class="h"><a name="3714"></a>3714</td><td></td><td></td><td></td><td></td><td class="s"> });</td></tr>
+<tr><td class="h"><a name="3715"></a>3715</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3716"></a>3716</td><td></td><td></td><td></td><td></td><td class="s"> # Equivalent SQL</td></tr>
+<tr><td class="h"><a name="3717"></a>3717</td><td></td><td></td><td></td><td></td><td class="s"> SELECT name, COUNT( employeeid ), MAX( LENGTH( name ) ) AS longest_name FROM employee</td></tr>
+<tr><td class="h"><a name="3718"></a>3718</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3719"></a>3719</td><td></td><td></td><td></td><td></td><td class="s">B<NOTE:> You will almost always need a corresponding L</as> attribute when you</td></tr>
+<tr><td class="h"><a name="3720"></a>3720</td><td></td><td></td><td></td><td></td><td class="s">use L</select>, to instruct DBIx::Class how to store the result of the column.</td></tr>
+<tr><td class="h"><a name="3721"></a>3721</td><td></td><td></td><td></td><td></td><td class="s">Also note that the L</as> attribute has nothing to do with the SQL-side 'AS'</td></tr>
+<tr><td class="h"><a name="3722"></a>3722</td><td></td><td></td><td></td><td></td><td class="s">identifier aliasing. You can however alias a function, so you can use it in</td></tr>
+<tr><td class="h"><a name="3723"></a>3723</td><td></td><td></td><td></td><td></td><td class="s">e.g. an C<ORDER BY> clause. This is done via the C<-as> B<select function</td></tr>
+<tr><td class="h"><a name="3724"></a>3724</td><td></td><td></td><td></td><td></td><td class="s">attribute> supplied as shown in the example above.</td></tr>
+<tr><td class="h"><a name="3725"></a>3725</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3726"></a>3726</td><td></td><td></td><td></td><td></td><td class="s">B<NOTE:> You need to explicitly quote '+select'/'+as' when defining the attributes.</td></tr>
+<tr><td class="h"><a name="3727"></a>3727</td><td></td><td></td><td></td><td></td><td class="s">Not doing so causes Perl to incorrectly interpret them as a bareword with a</td></tr>
+<tr><td class="h"><a name="3728"></a>3728</td><td></td><td></td><td></td><td></td><td class="s">unary plus operator before it.</td></tr>
+<tr><td class="h"><a name="3729"></a>3729</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3730"></a>3730</td><td></td><td></td><td></td><td></td><td class="s">=head2 +select</td></tr>
+<tr><td class="h"><a name="3731"></a>3731</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3732"></a>3732</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="3733"></a>3733</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3734"></a>3734</td><td></td><td></td><td></td><td></td><td class="s">Indicates additional columns to be selected from storage. Works the same as</td></tr>
+<tr><td class="h"><a name="3735"></a>3735</td><td></td><td></td><td></td><td></td><td class="s">L</select> but adds columns to the default selection, instead of specifying</td></tr>
+<tr><td class="h"><a name="3736"></a>3736</td><td></td><td></td><td></td><td></td><td class="s">an explicit list.</td></tr>
+<tr><td class="h"><a name="3737"></a>3737</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3738"></a>3738</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="3739"></a>3739</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3740"></a>3740</td><td></td><td></td><td></td><td></td><td class="s">=head2 +as</td></tr>
+<tr><td class="h"><a name="3741"></a>3741</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3742"></a>3742</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="3743"></a>3743</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3744"></a>3744</td><td></td><td></td><td></td><td></td><td class="s">Indicates additional column names for those added via L</+select>. See L</as>.</td></tr>
+<tr><td class="h"><a name="3745"></a>3745</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3746"></a>3746</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="3747"></a>3747</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3748"></a>3748</td><td></td><td></td><td></td><td></td><td class="s">=head2 as</td></tr>
+<tr><td class="h"><a name="3749"></a>3749</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3750"></a>3750</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="3751"></a>3751</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3752"></a>3752</td><td></td><td></td><td></td><td></td><td class="s">=item Value: \@inflation_names</td></tr>
+<tr><td class="h"><a name="3753"></a>3753</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3754"></a>3754</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="3755"></a>3755</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3756"></a>3756</td><td></td><td></td><td></td><td></td><td class="s">Indicates column names for object inflation. That is L</as> indicates the</td></tr>
+<tr><td class="h"><a name="3757"></a>3757</td><td></td><td></td><td></td><td></td><td class="s">slot name in which the column value will be stored within the</td></tr>
+<tr><td class="h"><a name="3758"></a>3758</td><td></td><td></td><td></td><td></td><td class="s">L<Row|DBIx::Class::Row> object. The value will then be accessible via this</td></tr>
+<tr><td class="h"><a name="3759"></a>3759</td><td></td><td></td><td></td><td></td><td class="s">identifier by the C<get_column> method (or via the object accessor B<if one</td></tr>
+<tr><td class="h"><a name="3760"></a>3760</td><td></td><td></td><td></td><td></td><td class="s">with the same name already exists>) as shown below. The L</as> attribute has</td></tr>
+<tr><td class="h"><a name="3761"></a>3761</td><td></td><td></td><td></td><td></td><td class="s">B<nothing to do> with the SQL-side C<AS>. See L</select> for details.</td></tr>
+<tr><td class="h"><a name="3762"></a>3762</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3763"></a>3763</td><td></td><td></td><td></td><td></td><td class="s"> $rs = $schema->resultset('Employee')->search(undef, {</td></tr>
+<tr><td class="h"><a name="3764"></a>3764</td><td></td><td></td><td></td><td></td><td class="s"> select => [</td></tr>
+<tr><td class="h"><a name="3765"></a>3765</td><td></td><td></td><td></td><td></td><td class="s"> 'name',</td></tr>
+<tr><td class="h"><a name="3766"></a>3766</td><td></td><td></td><td></td><td></td><td class="s"> { count => 'employeeid' },</td></tr>
+<tr><td class="h"><a name="3767"></a>3767</td><td></td><td></td><td></td><td></td><td class="s"> { max => { length => 'name' }, -as => 'longest_name' }</td></tr>
+<tr><td class="h"><a name="3768"></a>3768</td><td></td><td></td><td></td><td></td><td class="s"> ],</td></tr>
+<tr><td class="h"><a name="3769"></a>3769</td><td></td><td></td><td></td><td></td><td class="s"> as => [qw/</td></tr>
+<tr><td class="h"><a name="3770"></a>3770</td><td></td><td></td><td></td><td></td><td class="s"> name</td></tr>
+<tr><td class="h"><a name="3771"></a>3771</td><td></td><td></td><td></td><td></td><td class="s"> employee_count</td></tr>
+<tr><td class="h"><a name="3772"></a>3772</td><td></td><td></td><td></td><td></td><td class="s"> max_name_length</td></tr>
+<tr><td class="h"><a name="3773"></a>3773</td><td></td><td></td><td></td><td></td><td class="s"> /],</td></tr>
+<tr><td class="h"><a name="3774"></a>3774</td><td></td><td></td><td></td><td></td><td class="s"> });</td></tr>
+<tr><td class="h"><a name="3775"></a>3775</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3776"></a>3776</td><td></td><td></td><td></td><td></td><td class="s">If the object against which the search is performed already has an accessor</td></tr>
+<tr><td class="h"><a name="3777"></a>3777</td><td></td><td></td><td></td><td></td><td class="s">matching a column name specified in C<as>, the value can be retrieved using</td></tr>
+<tr><td class="h"><a name="3778"></a>3778</td><td></td><td></td><td></td><td></td><td class="s">the accessor as normal:</td></tr>
+<tr><td class="h"><a name="3779"></a>3779</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3780"></a>3780</td><td></td><td></td><td></td><td></td><td class="s"> my $name = $employee->name();</td></tr>
+<tr><td class="h"><a name="3781"></a>3781</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3782"></a>3782</td><td></td><td></td><td></td><td></td><td class="s">If on the other hand an accessor does not exist in the object, you need to</td></tr>
+<tr><td class="h"><a name="3783"></a>3783</td><td></td><td></td><td></td><td></td><td class="s">use C<get_column> instead:</td></tr>
+<tr><td class="h"><a name="3784"></a>3784</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3785"></a>3785</td><td></td><td></td><td></td><td></td><td class="s"> my $employee_count = $employee->get_column('employee_count');</td></tr>
+<tr><td class="h"><a name="3786"></a>3786</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3787"></a>3787</td><td></td><td></td><td></td><td></td><td class="s">You can create your own accessors if required - see</td></tr>
+<tr><td class="h"><a name="3788"></a>3788</td><td></td><td></td><td></td><td></td><td class="s">L<DBIx::Class::Manual::Cookbook> for details.</td></tr>
+<tr><td class="h"><a name="3789"></a>3789</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3790"></a>3790</td><td></td><td></td><td></td><td></td><td class="s">=head2 join</td></tr>
+<tr><td class="h"><a name="3791"></a>3791</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3792"></a>3792</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="3793"></a>3793</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3794"></a>3794</td><td></td><td></td><td></td><td></td><td class="s">=item Value: ($rel_name | \@rel_names | \%rel_names)</td></tr>
+<tr><td class="h"><a name="3795"></a>3795</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3796"></a>3796</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="3797"></a>3797</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3798"></a>3798</td><td></td><td></td><td></td><td></td><td class="s">Contains a list of relationships that should be joined for this query. For</td></tr>
+<tr><td class="h"><a name="3799"></a>3799</td><td></td><td></td><td></td><td></td><td class="s">example:</td></tr>
+<tr><td class="h"><a name="3800"></a>3800</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3801"></a>3801</td><td></td><td></td><td></td><td></td><td class="s"> # Get CDs by Nine Inch Nails</td></tr>
+<tr><td class="h"><a name="3802"></a>3802</td><td></td><td></td><td></td><td></td><td class="s"> my $rs = $schema->resultset('CD')->search(</td></tr>
+<tr><td class="h"><a name="3803"></a>3803</td><td></td><td></td><td></td><td></td><td class="s"> { 'artist.name' => 'Nine Inch Nails' },</td></tr>
+<tr><td class="h"><a name="3804"></a>3804</td><td></td><td></td><td></td><td></td><td class="s"> { join => 'artist' }</td></tr>
+<tr><td class="h"><a name="3805"></a>3805</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="3806"></a>3806</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3807"></a>3807</td><td></td><td></td><td></td><td></td><td class="s">Can also contain a hash reference to refer to the other relation's relations.</td></tr>
+<tr><td class="h"><a name="3808"></a>3808</td><td></td><td></td><td></td><td></td><td class="s">For example:</td></tr>
+<tr><td class="h"><a name="3809"></a>3809</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3810"></a>3810</td><td></td><td></td><td></td><td></td><td class="s"> package MyApp::Schema::Track;</td></tr>
+<tr><td class="h"><a name="3811"></a>3811</td><td></td><td></td><td></td><td></td><td class="s"> use base qw/DBIx::Class/;</td></tr>
+<tr><td class="h"><a name="3812"></a>3812</td><td></td><td></td><td></td><td></td><td class="s"> __PACKAGE__->table('track');</td></tr>
+<tr><td class="h"><a name="3813"></a>3813</td><td></td><td></td><td></td><td></td><td class="s"> __PACKAGE__->add_columns(qw/trackid cd position title/);</td></tr>
+<tr><td class="h"><a name="3814"></a>3814</td><td></td><td></td><td></td><td></td><td class="s"> __PACKAGE__->set_primary_key('trackid');</td></tr>
+<tr><td class="h"><a name="3815"></a>3815</td><td></td><td></td><td></td><td></td><td class="s"> __PACKAGE__->belongs_to(cd => 'MyApp::Schema::CD');</td></tr>
+<tr><td class="h"><a name="3816"></a>3816</td><td></td><td></td><td></td><td></td><td class="s"> 1;</td></tr>
+<tr><td class="h"><a name="3817"></a>3817</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3818"></a>3818</td><td></td><td></td><td></td><td></td><td class="s"> # In your application</td></tr>
+<tr><td class="h"><a name="3819"></a>3819</td><td></td><td></td><td></td><td></td><td class="s"> my $rs = $schema->resultset('Artist')->search(</td></tr>
+<tr><td class="h"><a name="3820"></a>3820</td><td></td><td></td><td></td><td></td><td class="s"> { 'track.title' => 'Teardrop' },</td></tr>
+<tr><td class="h"><a name="3821"></a>3821</td><td></td><td></td><td></td><td></td><td class="s"> {</td></tr>
+<tr><td class="h"><a name="3822"></a>3822</td><td></td><td></td><td></td><td></td><td class="s"> join => { cd => 'track' },</td></tr>
+<tr><td class="h"><a name="3823"></a>3823</td><td></td><td></td><td></td><td></td><td class="s"> order_by => 'artist.name',</td></tr>
+<tr><td class="h"><a name="3824"></a>3824</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3825"></a>3825</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="3826"></a>3826</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3827"></a>3827</td><td></td><td></td><td></td><td></td><td class="s">You need to use the relationship (not the table) name in conditions,</td></tr>
+<tr><td class="h"><a name="3828"></a>3828</td><td></td><td></td><td></td><td></td><td class="s">because they are aliased as such. The current table is aliased as "me", so</td></tr>
+<tr><td class="h"><a name="3829"></a>3829</td><td></td><td></td><td></td><td></td><td class="s">you need to use me.column_name in order to avoid ambiguity. For example:</td></tr>
+<tr><td class="h"><a name="3830"></a>3830</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3831"></a>3831</td><td></td><td></td><td></td><td></td><td class="s"> # Get CDs from 1984 with a 'Foo' track</td></tr>
+<tr><td class="h"><a name="3832"></a>3832</td><td></td><td></td><td></td><td></td><td class="s"> my $rs = $schema->resultset('CD')->search(</td></tr>
+<tr><td class="h"><a name="3833"></a>3833</td><td></td><td></td><td></td><td></td><td class="s"> {</td></tr>
+<tr><td class="h"><a name="3834"></a>3834</td><td></td><td></td><td></td><td></td><td class="s"> 'me.year' => 1984,</td></tr>
+<tr><td class="h"><a name="3835"></a>3835</td><td></td><td></td><td></td><td></td><td class="s"> 'tracks.name' => 'Foo'</td></tr>
+<tr><td class="h"><a name="3836"></a>3836</td><td></td><td></td><td></td><td></td><td class="s"> },</td></tr>
+<tr><td class="h"><a name="3837"></a>3837</td><td></td><td></td><td></td><td></td><td class="s"> { join => 'tracks' }</td></tr>
+<tr><td class="h"><a name="3838"></a>3838</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="3839"></a>3839</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3840"></a>3840</td><td></td><td></td><td></td><td></td><td class="s">If the same join is supplied twice, it will be aliased to <rel>_2 (and</td></tr>
+<tr><td class="h"><a name="3841"></a>3841</td><td></td><td></td><td></td><td></td><td class="s">similarly for a third time). For e.g.</td></tr>
+<tr><td class="h"><a name="3842"></a>3842</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3843"></a>3843</td><td></td><td></td><td></td><td></td><td class="s"> my $rs = $schema->resultset('Artist')->search({</td></tr>
+<tr><td class="h"><a name="3844"></a>3844</td><td></td><td></td><td></td><td></td><td class="s"> 'cds.title' => 'Down to Earth',</td></tr>
+<tr><td class="h"><a name="3845"></a>3845</td><td></td><td></td><td></td><td></td><td class="s"> 'cds_2.title' => 'Popular',</td></tr>
+<tr><td class="h"><a name="3846"></a>3846</td><td></td><td></td><td></td><td></td><td class="s"> }, {</td></tr>
+<tr><td class="h"><a name="3847"></a>3847</td><td></td><td></td><td></td><td></td><td class="s"> join => [ qw/cds cds/ ],</td></tr>
+<tr><td class="h"><a name="3848"></a>3848</td><td></td><td></td><td></td><td></td><td class="s"> });</td></tr>
+<tr><td class="h"><a name="3849"></a>3849</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3850"></a>3850</td><td></td><td></td><td></td><td></td><td class="s">will return a set of all artists that have both a cd with title 'Down</td></tr>
+<tr><td class="h"><a name="3851"></a>3851</td><td></td><td></td><td></td><td></td><td class="s">to Earth' and a cd with title 'Popular'.</td></tr>
+<tr><td class="h"><a name="3852"></a>3852</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3853"></a>3853</td><td></td><td></td><td></td><td></td><td class="s">If you want to fetch related objects from other tables as well, see C<prefetch></td></tr>
+<tr><td class="h"><a name="3854"></a>3854</td><td></td><td></td><td></td><td></td><td class="s">below.</td></tr>
+<tr><td class="h"><a name="3855"></a>3855</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3856"></a>3856</td><td></td><td></td><td></td><td></td><td class="s">For more help on using joins with search, see L<DBIx::Class::Manual::Joining>.</td></tr>
+<tr><td class="h"><a name="3857"></a>3857</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3858"></a>3858</td><td></td><td></td><td></td><td></td><td class="s">=head2 prefetch</td></tr>
+<tr><td class="h"><a name="3859"></a>3859</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3860"></a>3860</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="3861"></a>3861</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3862"></a>3862</td><td></td><td></td><td></td><td></td><td class="s">=item Value: ($rel_name | \@rel_names | \%rel_names)</td></tr>
+<tr><td class="h"><a name="3863"></a>3863</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3864"></a>3864</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="3865"></a>3865</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3866"></a>3866</td><td></td><td></td><td></td><td></td><td class="s">Contains one or more relationships that should be fetched along with</td></tr>
+<tr><td class="h"><a name="3867"></a>3867</td><td></td><td></td><td></td><td></td><td class="s">the main query (when they are accessed afterwards the data will</td></tr>
+<tr><td class="h"><a name="3868"></a>3868</td><td></td><td></td><td></td><td></td><td class="s">already be available, without extra queries to the database). This is</td></tr>
+<tr><td class="h"><a name="3869"></a>3869</td><td></td><td></td><td></td><td></td><td class="s">useful for when you know you will need the related objects, because it</td></tr>
+<tr><td class="h"><a name="3870"></a>3870</td><td></td><td></td><td></td><td></td><td class="s">saves at least one query:</td></tr>
+<tr><td class="h"><a name="3871"></a>3871</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3872"></a>3872</td><td></td><td></td><td></td><td></td><td class="s"> my $rs = $schema->resultset('Tag')->search(</td></tr>
+<tr><td class="h"><a name="3873"></a>3873</td><td></td><td></td><td></td><td></td><td class="s"> undef,</td></tr>
+<tr><td class="h"><a name="3874"></a>3874</td><td></td><td></td><td></td><td></td><td class="s"> {</td></tr>
+<tr><td class="h"><a name="3875"></a>3875</td><td></td><td></td><td></td><td></td><td class="s"> prefetch => {</td></tr>
+<tr><td class="h"><a name="3876"></a>3876</td><td></td><td></td><td></td><td></td><td class="s"> cd => 'artist'</td></tr>
+<tr><td class="h"><a name="3877"></a>3877</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3878"></a>3878</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3879"></a>3879</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="3880"></a>3880</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3881"></a>3881</td><td></td><td></td><td></td><td></td><td class="s">The initial search results in SQL like the following:</td></tr>
+<tr><td class="h"><a name="3882"></a>3882</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3883"></a>3883</td><td></td><td></td><td></td><td></td><td class="s"> SELECT tag.*, cd.*, artist.* FROM tag</td></tr>
+<tr><td class="h"><a name="3884"></a>3884</td><td></td><td></td><td></td><td></td><td class="s"> JOIN cd ON tag.cd = cd.cdid</td></tr>
+<tr><td class="h"><a name="3885"></a>3885</td><td></td><td></td><td></td><td></td><td class="s"> JOIN artist ON cd.artist = artist.artistid</td></tr>
+<tr><td class="h"><a name="3886"></a>3886</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3887"></a>3887</td><td></td><td></td><td></td><td></td><td class="s">L<DBIx::Class> has no need to go back to the database when we access the</td></tr>
+<tr><td class="h"><a name="3888"></a>3888</td><td></td><td></td><td></td><td></td><td class="s">C<cd> or C<artist> relationships, which saves us two SQL statements in this</td></tr>
+<tr><td class="h"><a name="3889"></a>3889</td><td></td><td></td><td></td><td></td><td class="s">case.</td></tr>
+<tr><td class="h"><a name="3890"></a>3890</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3891"></a>3891</td><td></td><td></td><td></td><td></td><td class="s">Simple prefetches will be joined automatically, so there is no need</td></tr>
+<tr><td class="h"><a name="3892"></a>3892</td><td></td><td></td><td></td><td></td><td class="s">for a C<join> attribute in the above search.</td></tr>
+<tr><td class="h"><a name="3893"></a>3893</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3894"></a>3894</td><td></td><td></td><td></td><td></td><td class="s">L</prefetch> can be used with the any of the relationship types and</td></tr>
+<tr><td class="h"><a name="3895"></a>3895</td><td></td><td></td><td></td><td></td><td class="s">multiple prefetches can be specified together. Below is a more complex</td></tr>
+<tr><td class="h"><a name="3896"></a>3896</td><td></td><td></td><td></td><td></td><td class="s">example that prefetches a CD's artist, its liner notes (if present),</td></tr>
+<tr><td class="h"><a name="3897"></a>3897</td><td></td><td></td><td></td><td></td><td class="s">the cover image, the tracks on that cd, and the guests on those</td></tr>
+<tr><td class="h"><a name="3898"></a>3898</td><td></td><td></td><td></td><td></td><td class="s">tracks.</td></tr>
+<tr><td class="h"><a name="3899"></a>3899</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3900"></a>3900</td><td></td><td></td><td></td><td></td><td class="s"> # Assuming:</td></tr>
+<tr><td class="h"><a name="3901"></a>3901</td><td></td><td></td><td></td><td></td><td class="s"> My::Schema::CD->belongs_to( artist => 'My::Schema::Artist' );</td></tr>
+<tr><td class="h"><a name="3902"></a>3902</td><td></td><td></td><td></td><td></td><td class="s"> My::Schema::CD->might_have( liner_note => 'My::Schema::LinerNotes' );</td></tr>
+<tr><td class="h"><a name="3903"></a>3903</td><td></td><td></td><td></td><td></td><td class="s"> My::Schema::CD->has_one( cover_image => 'My::Schema::Artwork' );</td></tr>
+<tr><td class="h"><a name="3904"></a>3904</td><td></td><td></td><td></td><td></td><td class="s"> My::Schema::CD->has_many( tracks => 'My::Schema::Track' );</td></tr>
+<tr><td class="h"><a name="3905"></a>3905</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3906"></a>3906</td><td></td><td></td><td></td><td></td><td class="s"> My::Schema::Artist->belongs_to( record_label => 'My::Schema::RecordLabel' );</td></tr>
+<tr><td class="h"><a name="3907"></a>3907</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3908"></a>3908</td><td></td><td></td><td></td><td></td><td class="s"> My::Schema::Track->has_many( guests => 'My::Schema::Guest' );</td></tr>
+<tr><td class="h"><a name="3909"></a>3909</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3910"></a>3910</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3911"></a>3911</td><td></td><td></td><td></td><td></td><td class="s"> my $rs = $schema->resultset('CD')->search(</td></tr>
+<tr><td class="h"><a name="3912"></a>3912</td><td></td><td></td><td></td><td></td><td class="s"> undef,</td></tr>
+<tr><td class="h"><a name="3913"></a>3913</td><td></td><td></td><td></td><td></td><td class="s"> {</td></tr>
+<tr><td class="h"><a name="3914"></a>3914</td><td></td><td></td><td></td><td></td><td class="s"> prefetch => [</td></tr>
+<tr><td class="h"><a name="3915"></a>3915</td><td></td><td></td><td></td><td></td><td class="s"> { artist => 'record_label'}, # belongs_to => belongs_to</td></tr>
+<tr><td class="h"><a name="3916"></a>3916</td><td></td><td></td><td></td><td></td><td class="s"> 'liner_note', # might_have</td></tr>
+<tr><td class="h"><a name="3917"></a>3917</td><td></td><td></td><td></td><td></td><td class="s"> 'cover_image', # has_one</td></tr>
+<tr><td class="h"><a name="3918"></a>3918</td><td></td><td></td><td></td><td></td><td class="s"> { tracks => 'guests' }, # has_many => has_many</td></tr>
+<tr><td class="h"><a name="3919"></a>3919</td><td></td><td></td><td></td><td></td><td class="s"> ]</td></tr>
+<tr><td class="h"><a name="3920"></a>3920</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3921"></a>3921</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="3922"></a>3922</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3923"></a>3923</td><td></td><td></td><td></td><td></td><td class="s">This will produce SQL like the following:</td></tr>
+<tr><td class="h"><a name="3924"></a>3924</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3925"></a>3925</td><td></td><td></td><td></td><td></td><td class="s"> SELECT cd.*, artist.*, record_label.*, liner_note.*, cover_image.*,</td></tr>
+<tr><td class="h"><a name="3926"></a>3926</td><td></td><td></td><td></td><td></td><td class="s"> tracks.*, guests.*</td></tr>
+<tr><td class="h"><a name="3927"></a>3927</td><td></td><td></td><td></td><td></td><td class="s"> FROM cd me</td></tr>
+<tr><td class="h"><a name="3928"></a>3928</td><td></td><td></td><td></td><td></td><td class="s"> JOIN artist artist</td></tr>
+<tr><td class="h"><a name="3929"></a>3929</td><td></td><td></td><td></td><td></td><td class="s"> ON artist.artistid = me.artistid</td></tr>
+<tr><td class="h"><a name="3930"></a>3930</td><td></td><td></td><td></td><td></td><td class="s"> JOIN record_label record_label</td></tr>
+<tr><td class="h"><a name="3931"></a>3931</td><td></td><td></td><td></td><td></td><td class="s"> ON record_label.labelid = artist.labelid</td></tr>
+<tr><td class="h"><a name="3932"></a>3932</td><td></td><td></td><td></td><td></td><td class="s"> LEFT JOIN track tracks</td></tr>
+<tr><td class="h"><a name="3933"></a>3933</td><td></td><td></td><td></td><td></td><td class="s"> ON tracks.cdid = me.cdid</td></tr>
+<tr><td class="h"><a name="3934"></a>3934</td><td></td><td></td><td></td><td></td><td class="s"> LEFT JOIN guest guests</td></tr>
+<tr><td class="h"><a name="3935"></a>3935</td><td></td><td></td><td></td><td></td><td class="s"> ON guests.trackid = track.trackid</td></tr>
+<tr><td class="h"><a name="3936"></a>3936</td><td></td><td></td><td></td><td></td><td class="s"> LEFT JOIN liner_notes liner_note</td></tr>
+<tr><td class="h"><a name="3937"></a>3937</td><td></td><td></td><td></td><td></td><td class="s"> ON liner_note.cdid = me.cdid</td></tr>
+<tr><td class="h"><a name="3938"></a>3938</td><td></td><td></td><td></td><td></td><td class="s"> JOIN cd_artwork cover_image</td></tr>
+<tr><td class="h"><a name="3939"></a>3939</td><td></td><td></td><td></td><td></td><td class="s"> ON cover_image.cdid = me.cdid</td></tr>
+<tr><td class="h"><a name="3940"></a>3940</td><td></td><td></td><td></td><td></td><td class="s"> ORDER BY tracks.cd</td></tr>
+<tr><td class="h"><a name="3941"></a>3941</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3942"></a>3942</td><td></td><td></td><td></td><td></td><td class="s">Now the C<artist>, C<record_label>, C<liner_note>, C<cover_image>,</td></tr>
+<tr><td class="h"><a name="3943"></a>3943</td><td></td><td></td><td></td><td></td><td class="s">C<tracks>, and C<guests> of the CD will all be available through the</td></tr>
+<tr><td class="h"><a name="3944"></a>3944</td><td></td><td></td><td></td><td></td><td class="s">relationship accessors without the need for additional queries to the</td></tr>
+<tr><td class="h"><a name="3945"></a>3945</td><td></td><td></td><td></td><td></td><td class="s">database.</td></tr>
+<tr><td class="h"><a name="3946"></a>3946</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3947"></a>3947</td><td></td><td></td><td></td><td></td><td class="s">However, there is one caveat to be observed: it can be dangerous to</td></tr>
+<tr><td class="h"><a name="3948"></a>3948</td><td></td><td></td><td></td><td></td><td class="s">prefetch more than one L<has_many|DBIx::Class::Relationship/has_many></td></tr>
+<tr><td class="h"><a name="3949"></a>3949</td><td></td><td></td><td></td><td></td><td class="s">relationship on a given level. e.g.:</td></tr>
+<tr><td class="h"><a name="3950"></a>3950</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3951"></a>3951</td><td></td><td></td><td></td><td></td><td class="s"> my $rs = $schema->resultset('CD')->search(</td></tr>
+<tr><td class="h"><a name="3952"></a>3952</td><td></td><td></td><td></td><td></td><td class="s"> undef,</td></tr>
+<tr><td class="h"><a name="3953"></a>3953</td><td></td><td></td><td></td><td></td><td class="s"> {</td></tr>
+<tr><td class="h"><a name="3954"></a>3954</td><td></td><td></td><td></td><td></td><td class="s"> prefetch => [</td></tr>
+<tr><td class="h"><a name="3955"></a>3955</td><td></td><td></td><td></td><td></td><td class="s"> 'tracks', # has_many</td></tr>
+<tr><td class="h"><a name="3956"></a>3956</td><td></td><td></td><td></td><td></td><td class="s"> { cd_to_producer => 'producer' }, # has_many => belongs_to (i.e. m2m)</td></tr>
+<tr><td class="h"><a name="3957"></a>3957</td><td></td><td></td><td></td><td></td><td class="s"> ]</td></tr>
+<tr><td class="h"><a name="3958"></a>3958</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3959"></a>3959</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="3960"></a>3960</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3961"></a>3961</td><td></td><td></td><td></td><td></td><td class="s">In fact, C<DBIx::Class> will emit the following warning:</td></tr>
+<tr><td class="h"><a name="3962"></a>3962</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3963"></a>3963</td><td></td><td></td><td></td><td></td><td class="s"> Prefetching multiple has_many rels tracks and cd_to_producer at top</td></tr>
+<tr><td class="h"><a name="3964"></a>3964</td><td></td><td></td><td></td><td></td><td class="s"> level will explode the number of row objects retrievable via ->next</td></tr>
+<tr><td class="h"><a name="3965"></a>3965</td><td></td><td></td><td></td><td></td><td class="s"> or ->all. Use at your own risk.</td></tr>
+<tr><td class="h"><a name="3966"></a>3966</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3967"></a>3967</td><td></td><td></td><td></td><td></td><td class="s">The collapser currently can't identify duplicate tuples for multiple</td></tr>
+<tr><td class="h"><a name="3968"></a>3968</td><td></td><td></td><td></td><td></td><td class="s">L<has_many|DBIx::Class::Relationship/has_many> relationships and as a</td></tr>
+<tr><td class="h"><a name="3969"></a>3969</td><td></td><td></td><td></td><td></td><td class="s">result the second L<has_many|DBIx::Class::Relationship/has_many></td></tr>
+<tr><td class="h"><a name="3970"></a>3970</td><td></td><td></td><td></td><td></td><td class="s">relation could contain redundant objects.</td></tr>
+<tr><td class="h"><a name="3971"></a>3971</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3972"></a>3972</td><td></td><td></td><td></td><td></td><td class="s">=head3 Using L</prefetch> with L</join></td></tr>
+<tr><td class="h"><a name="3973"></a>3973</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3974"></a>3974</td><td></td><td></td><td></td><td></td><td class="s">L</prefetch> implies a L</join> with the equivalent argument, and is</td></tr>
+<tr><td class="h"><a name="3975"></a>3975</td><td></td><td></td><td></td><td></td><td class="s">properly merged with any existing L</join> specification. So the</td></tr>
+<tr><td class="h"><a name="3976"></a>3976</td><td></td><td></td><td></td><td></td><td class="s">following:</td></tr>
+<tr><td class="h"><a name="3977"></a>3977</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3978"></a>3978</td><td></td><td></td><td></td><td></td><td class="s"> my $rs = $schema->resultset('CD')->search(</td></tr>
+<tr><td class="h"><a name="3979"></a>3979</td><td></td><td></td><td></td><td></td><td class="s"> {'record_label.name' => 'Music Product Ltd.'},</td></tr>
+<tr><td class="h"><a name="3980"></a>3980</td><td></td><td></td><td></td><td></td><td class="s"> {</td></tr>
+<tr><td class="h"><a name="3981"></a>3981</td><td></td><td></td><td></td><td></td><td class="s"> join => {artist => 'record_label'},</td></tr>
+<tr><td class="h"><a name="3982"></a>3982</td><td></td><td></td><td></td><td></td><td class="s"> prefetch => 'artist',</td></tr>
+<tr><td class="h"><a name="3983"></a>3983</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="3984"></a>3984</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="3985"></a>3985</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3986"></a>3986</td><td></td><td></td><td></td><td></td><td class="s">... will work, searching on the record label's name, but only</td></tr>
+<tr><td class="h"><a name="3987"></a>3987</td><td></td><td></td><td></td><td></td><td class="s">prefetching the C<artist>.</td></tr>
+<tr><td class="h"><a name="3988"></a>3988</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3989"></a>3989</td><td></td><td></td><td></td><td></td><td class="s">=head3 Using L</prefetch> with L</select> / L</+select> / L</as> / L</+as></td></tr>
+<tr><td class="h"><a name="3990"></a>3990</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3991"></a>3991</td><td></td><td></td><td></td><td></td><td class="s">L</prefetch> implies a L</+select>/L</+as> with the fields of the</td></tr>
+<tr><td class="h"><a name="3992"></a>3992</td><td></td><td></td><td></td><td></td><td class="s">prefetched relations. So given:</td></tr>
+<tr><td class="h"><a name="3993"></a>3993</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="3994"></a>3994</td><td></td><td></td><td></td><td></td><td class="s"> my $rs = $schema->resultset('CD')->search(</td></tr>
+<tr><td class="h"><a name="3995"></a>3995</td><td></td><td></td><td></td><td></td><td class="s"> undef,</td></tr>
+<tr><td class="h"><a name="3996"></a>3996</td><td></td><td></td><td></td><td></td><td class="s"> {</td></tr>
+<tr><td class="h"><a name="3997"></a>3997</td><td></td><td></td><td></td><td></td><td class="s"> select => ['cd.title'],</td></tr>
+<tr><td class="h"><a name="3998"></a>3998</td><td></td><td></td><td></td><td></td><td class="s"> as => ['cd_title'],</td></tr>
+<tr><td class="h"><a name="3999"></a>3999</td><td></td><td></td><td></td><td></td><td class="s"> prefetch => 'artist',</td></tr>
+<tr><td class="h"><a name="4000"></a>4000</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="4001"></a>4001</td><td></td><td></td><td></td><td></td><td class="s"> );</td></tr>
+<tr><td class="h"><a name="4002"></a>4002</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4003"></a>4003</td><td></td><td></td><td></td><td></td><td class="s">The L</select> becomes: C<'cd.title', 'artist.*'> and the L</as></td></tr>
+<tr><td class="h"><a name="4004"></a>4004</td><td></td><td></td><td></td><td></td><td class="s">becomes: C<'cd_title', 'artist.*'>.</td></tr>
+<tr><td class="h"><a name="4005"></a>4005</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4006"></a>4006</td><td></td><td></td><td></td><td></td><td class="s">=head3 CAVEATS</td></tr>
+<tr><td class="h"><a name="4007"></a>4007</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4008"></a>4008</td><td></td><td></td><td></td><td></td><td class="s">Prefetch does a lot of deep magic. As such, it may not behave exactly</td></tr>
+<tr><td class="h"><a name="4009"></a>4009</td><td></td><td></td><td></td><td></td><td class="s">as you might expect.</td></tr>
+<tr><td class="h"><a name="4010"></a>4010</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4011"></a>4011</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="4012"></a>4012</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4013"></a>4013</td><td></td><td></td><td></td><td></td><td class="s">=item *</td></tr>
+<tr><td class="h"><a name="4014"></a>4014</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4015"></a>4015</td><td></td><td></td><td></td><td></td><td class="s">Prefetch uses the L</cache> to populate the prefetched relationships. This</td></tr>
+<tr><td class="h"><a name="4016"></a>4016</td><td></td><td></td><td></td><td></td><td class="s">may or may not be what you want.</td></tr>
+<tr><td class="h"><a name="4017"></a>4017</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4018"></a>4018</td><td></td><td></td><td></td><td></td><td class="s">=item *</td></tr>
+<tr><td class="h"><a name="4019"></a>4019</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4020"></a>4020</td><td></td><td></td><td></td><td></td><td class="s">If you specify a condition on a prefetched relationship, ONLY those</td></tr>
+<tr><td class="h"><a name="4021"></a>4021</td><td></td><td></td><td></td><td></td><td class="s">rows that match the prefetched condition will be fetched into that relationship.</td></tr>
+<tr><td class="h"><a name="4022"></a>4022</td><td></td><td></td><td></td><td></td><td class="s">This means that adding prefetch to a search() B<may alter> what is returned by</td></tr>
+<tr><td class="h"><a name="4023"></a>4023</td><td></td><td></td><td></td><td></td><td class="s">traversing a relationship. So, if you have C<< Artist->has_many(CDs) >> and you do</td></tr>
+<tr><td class="h"><a name="4024"></a>4024</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4025"></a>4025</td><td></td><td></td><td></td><td></td><td class="s"> my $artist_rs = $schema->resultset('Artist')->search({</td></tr>
+<tr><td class="h"><a name="4026"></a>4026</td><td></td><td></td><td></td><td></td><td class="s"> 'cds.year' => 2008,</td></tr>
+<tr><td class="h"><a name="4027"></a>4027</td><td></td><td></td><td></td><td></td><td class="s"> }, {</td></tr>
+<tr><td class="h"><a name="4028"></a>4028</td><td></td><td></td><td></td><td></td><td class="s"> join => 'cds',</td></tr>
+<tr><td class="h"><a name="4029"></a>4029</td><td></td><td></td><td></td><td></td><td class="s"> });</td></tr>
+<tr><td class="h"><a name="4030"></a>4030</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4031"></a>4031</td><td></td><td></td><td></td><td></td><td class="s"> my $count = $artist_rs->first->cds->count;</td></tr>
+<tr><td class="h"><a name="4032"></a>4032</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4033"></a>4033</td><td></td><td></td><td></td><td></td><td class="s"> my $artist_rs_prefetch = $artist_rs->search( {}, { prefetch => 'cds' } );</td></tr>
+<tr><td class="h"><a name="4034"></a>4034</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4035"></a>4035</td><td></td><td></td><td></td><td></td><td class="s"> my $prefetch_count = $artist_rs_prefetch->first->cds->count;</td></tr>
+<tr><td class="h"><a name="4036"></a>4036</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4037"></a>4037</td><td></td><td></td><td></td><td></td><td class="s"> cmp_ok( $count, '==', $prefetch_count, "Counts should be the same" );</td></tr>
+<tr><td class="h"><a name="4038"></a>4038</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4039"></a>4039</td><td></td><td></td><td></td><td></td><td class="s">that cmp_ok() may or may not pass depending on the datasets involved. This</td></tr>
+<tr><td class="h"><a name="4040"></a>4040</td><td></td><td></td><td></td><td></td><td class="s">behavior may or may not survive the 0.09 transition.</td></tr>
+<tr><td class="h"><a name="4041"></a>4041</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4042"></a>4042</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="4043"></a>4043</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4044"></a>4044</td><td></td><td></td><td></td><td></td><td class="s">=head2 page</td></tr>
+<tr><td class="h"><a name="4045"></a>4045</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4046"></a>4046</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="4047"></a>4047</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4048"></a>4048</td><td></td><td></td><td></td><td></td><td class="s">=item Value: $page</td></tr>
+<tr><td class="h"><a name="4049"></a>4049</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4050"></a>4050</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="4051"></a>4051</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4052"></a>4052</td><td></td><td></td><td></td><td></td><td class="s">Makes the resultset paged and specifies the page to retrieve. Effectively</td></tr>
+<tr><td class="h"><a name="4053"></a>4053</td><td></td><td></td><td></td><td></td><td class="s">identical to creating a non-pages resultset and then calling ->page($page)</td></tr>
+<tr><td class="h"><a name="4054"></a>4054</td><td></td><td></td><td></td><td></td><td class="s">on it.</td></tr>
+<tr><td class="h"><a name="4055"></a>4055</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4056"></a>4056</td><td></td><td></td><td></td><td></td><td class="s">If L</rows> attribute is not specified it defaults to 10 rows per page.</td></tr>
+<tr><td class="h"><a name="4057"></a>4057</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4058"></a>4058</td><td></td><td></td><td></td><td></td><td class="s">When you have a paged resultset, L</count> will only return the number</td></tr>
+<tr><td class="h"><a name="4059"></a>4059</td><td></td><td></td><td></td><td></td><td class="s">of rows in the page. To get the total, use the L</pager> and call</td></tr>
+<tr><td class="h"><a name="4060"></a>4060</td><td></td><td></td><td></td><td></td><td class="s">C<total_entries> on it.</td></tr>
+<tr><td class="h"><a name="4061"></a>4061</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4062"></a>4062</td><td></td><td></td><td></td><td></td><td class="s">=head2 rows</td></tr>
+<tr><td class="h"><a name="4063"></a>4063</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4064"></a>4064</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="4065"></a>4065</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4066"></a>4066</td><td></td><td></td><td></td><td></td><td class="s">=item Value: $rows</td></tr>
+<tr><td class="h"><a name="4067"></a>4067</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4068"></a>4068</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="4069"></a>4069</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4070"></a>4070</td><td></td><td></td><td></td><td></td><td class="s">Specifies the maximum number of rows for direct retrieval or the number of</td></tr>
+<tr><td class="h"><a name="4071"></a>4071</td><td></td><td></td><td></td><td></td><td class="s">rows per page if the page attribute or method is used.</td></tr>
+<tr><td class="h"><a name="4072"></a>4072</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4073"></a>4073</td><td></td><td></td><td></td><td></td><td class="s">=head2 offset</td></tr>
+<tr><td class="h"><a name="4074"></a>4074</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4075"></a>4075</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="4076"></a>4076</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4077"></a>4077</td><td></td><td></td><td></td><td></td><td class="s">=item Value: $offset</td></tr>
+<tr><td class="h"><a name="4078"></a>4078</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4079"></a>4079</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="4080"></a>4080</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4081"></a>4081</td><td></td><td></td><td></td><td></td><td class="s">Specifies the (zero-based) row number for the first row to be returned, or the</td></tr>
+<tr><td class="h"><a name="4082"></a>4082</td><td></td><td></td><td></td><td></td><td class="s">of the first row of the first page if paging is used.</td></tr>
+<tr><td class="h"><a name="4083"></a>4083</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4084"></a>4084</td><td></td><td></td><td></td><td></td><td class="s">=head2 group_by</td></tr>
+<tr><td class="h"><a name="4085"></a>4085</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4086"></a>4086</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="4087"></a>4087</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4088"></a>4088</td><td></td><td></td><td></td><td></td><td class="s">=item Value: \@columns</td></tr>
+<tr><td class="h"><a name="4089"></a>4089</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4090"></a>4090</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="4091"></a>4091</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4092"></a>4092</td><td></td><td></td><td></td><td></td><td class="s">A arrayref of columns to group by. Can include columns of joined tables.</td></tr>
+<tr><td class="h"><a name="4093"></a>4093</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4094"></a>4094</td><td></td><td></td><td></td><td></td><td class="s"> group_by => [qw/ column1 column2 ... /]</td></tr>
+<tr><td class="h"><a name="4095"></a>4095</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4096"></a>4096</td><td></td><td></td><td></td><td></td><td class="s">=head2 having</td></tr>
+<tr><td class="h"><a name="4097"></a>4097</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4098"></a>4098</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="4099"></a>4099</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4100"></a>4100</td><td></td><td></td><td></td><td></td><td class="s">=item Value: $condition</td></tr>
+<tr><td class="h"><a name="4101"></a>4101</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4102"></a>4102</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="4103"></a>4103</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4104"></a>4104</td><td></td><td></td><td></td><td></td><td class="s">HAVING is a select statement attribute that is applied between GROUP BY and</td></tr>
+<tr><td class="h"><a name="4105"></a>4105</td><td></td><td></td><td></td><td></td><td class="s">ORDER BY. It is applied to the after the grouping calculations have been</td></tr>
+<tr><td class="h"><a name="4106"></a>4106</td><td></td><td></td><td></td><td></td><td class="s">done.</td></tr>
+<tr><td class="h"><a name="4107"></a>4107</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4108"></a>4108</td><td></td><td></td><td></td><td></td><td class="s"> having => { 'count_employee' => { '>=', 100 } }</td></tr>
+<tr><td class="h"><a name="4109"></a>4109</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4110"></a>4110</td><td></td><td></td><td></td><td></td><td class="s">or with an in-place function in which case literal SQL is required:</td></tr>
+<tr><td class="h"><a name="4111"></a>4111</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4112"></a>4112</td><td></td><td></td><td></td><td></td><td class="s"> having => \[ 'count(employee) >= ?', [ count => 100 ] ]</td></tr>
+<tr><td class="h"><a name="4113"></a>4113</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4114"></a>4114</td><td></td><td></td><td></td><td></td><td class="s">=head2 distinct</td></tr>
+<tr><td class="h"><a name="4115"></a>4115</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4116"></a>4116</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="4117"></a>4117</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4118"></a>4118</td><td></td><td></td><td></td><td></td><td class="s">=item Value: (0 | 1)</td></tr>
+<tr><td class="h"><a name="4119"></a>4119</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4120"></a>4120</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="4121"></a>4121</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4122"></a>4122</td><td></td><td></td><td></td><td></td><td class="s">Set to 1 to group by all columns. If the resultset already has a group_by</td></tr>
+<tr><td class="h"><a name="4123"></a>4123</td><td></td><td></td><td></td><td></td><td class="s">attribute, this setting is ignored and an appropriate warning is issued.</td></tr>
+<tr><td class="h"><a name="4124"></a>4124</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4125"></a>4125</td><td></td><td></td><td></td><td></td><td class="s">=head2 where</td></tr>
+<tr><td class="h"><a name="4126"></a>4126</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4127"></a>4127</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="4128"></a>4128</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4129"></a>4129</td><td></td><td></td><td></td><td></td><td class="s">Adds to the WHERE clause.</td></tr>
+<tr><td class="h"><a name="4130"></a>4130</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4131"></a>4131</td><td></td><td></td><td></td><td></td><td class="s"> # only return rows WHERE deleted IS NULL for all searches</td></tr>
+<tr><td class="h"><a name="4132"></a>4132</td><td></td><td></td><td></td><td></td><td class="s"> __PACKAGE__->resultset_attributes({ where => { deleted => undef } }); )</td></tr>
+<tr><td class="h"><a name="4133"></a>4133</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4134"></a>4134</td><td></td><td></td><td></td><td></td><td class="s">Can be overridden by passing C<< { where => undef } >> as an attribute</td></tr>
+<tr><td class="h"><a name="4135"></a>4135</td><td></td><td></td><td></td><td></td><td class="s">to a resultset.</td></tr>
+<tr><td class="h"><a name="4136"></a>4136</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4137"></a>4137</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="4138"></a>4138</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4139"></a>4139</td><td></td><td></td><td></td><td></td><td class="s">=head2 cache</td></tr>
+<tr><td class="h"><a name="4140"></a>4140</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4141"></a>4141</td><td></td><td></td><td></td><td></td><td class="s">Set to 1 to cache search results. This prevents extra SQL queries if you</td></tr>
+<tr><td class="h"><a name="4142"></a>4142</td><td></td><td></td><td></td><td></td><td class="s">revisit rows in your ResultSet:</td></tr>
+<tr><td class="h"><a name="4143"></a>4143</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4144"></a>4144</td><td></td><td></td><td></td><td></td><td class="s"> my $resultset = $schema->resultset('Artist')->search( undef, { cache => 1 } );</td></tr>
+<tr><td class="h"><a name="4145"></a>4145</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4146"></a>4146</td><td></td><td></td><td></td><td></td><td class="s"> while( my $artist = $resultset->next ) {</td></tr>
+<tr><td class="h"><a name="4147"></a>4147</td><td></td><td></td><td></td><td></td><td class="s"> ... do stuff ...</td></tr>
+<tr><td class="h"><a name="4148"></a>4148</td><td></td><td></td><td></td><td></td><td class="s"> }</td></tr>
+<tr><td class="h"><a name="4149"></a>4149</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4150"></a>4150</td><td></td><td></td><td></td><td></td><td class="s"> $rs->first; # without cache, this would issue a query</td></tr>
+<tr><td class="h"><a name="4151"></a>4151</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4152"></a>4152</td><td></td><td></td><td></td><td></td><td class="s">By default, searches are not cached.</td></tr>
+<tr><td class="h"><a name="4153"></a>4153</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4154"></a>4154</td><td></td><td></td><td></td><td></td><td class="s">For more examples of using these attributes, see</td></tr>
+<tr><td class="h"><a name="4155"></a>4155</td><td></td><td></td><td></td><td></td><td class="s">L<DBIx::Class::Manual::Cookbook>.</td></tr>
+<tr><td class="h"><a name="4156"></a>4156</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4157"></a>4157</td><td></td><td></td><td></td><td></td><td class="s">=head2 for</td></tr>
+<tr><td class="h"><a name="4158"></a>4158</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4159"></a>4159</td><td></td><td></td><td></td><td></td><td class="s">=over 4</td></tr>
+<tr><td class="h"><a name="4160"></a>4160</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4161"></a>4161</td><td></td><td></td><td></td><td></td><td class="s">=item Value: ( 'update' | 'shared' )</td></tr>
+<tr><td class="h"><a name="4162"></a>4162</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4163"></a>4163</td><td></td><td></td><td></td><td></td><td class="s">=back</td></tr>
+<tr><td class="h"><a name="4164"></a>4164</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4165"></a>4165</td><td></td><td></td><td></td><td></td><td class="s">Set to 'update' for a SELECT ... FOR UPDATE or 'shared' for a SELECT</td></tr>
+<tr><td class="h"><a name="4166"></a>4166</td><td></td><td></td><td></td><td></td><td class="s">... FOR SHARED.</td></tr>
+<tr><td class="h"><a name="4167"></a>4167</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4168"></a>4168</td><td></td><td></td><td></td><td></td><td class="s">=cut</td></tr>
+<tr><td class="h"><a name="4169"></a>4169</td><td></td><td></td><td></td><td></td><td class="s"></td></tr>
+<tr><td class="h"><a name="4170"></a>4170</td><td class="c3">1</td><td class="c1"><span title="Avg 46µs">46µs</span></td><td class="c3">1</td><td class="c0">797µs</td><td class="s">1;<div class="calls"><div class="calls_out"># spent 797µs making 1 call to <a href="B-Hooks-EndOfScope-pm-376-sub.html#26">B::Hooks::EndOfScope::__ANON__[B/Hooks/EndOfScope.pm:26]</a></div></div></td></tr>
+</tbody></table></div>
+
+ <script type="text/javascript"> $(document).ready(function() {
+
+ $("#subs_table").tablesorter({
+ sortList: [[3,1]],
+ headers: {
+ 3: { sorter: 'fmt_time' },
+ 4: { sorter: 'fmt_time' }
+ }
+ });
+
+ } ); </script>
+
+ <div class="footer">Report produced by the
+ <a href="http://search.cpan.org/dist/Devel-NYTProf/">NYTProf 4.06</a>
+ Perl profiler, developed by
+ <a href="http://www.linkedin.com/in/timbunce">Tim Bunce</a> and
+ <a href="http://code.nytimes.com">Adam Kaplan</a>.
+ </div>
+ <br /><br /><br /><br /><br /><br /><br /><br /><br /><br />
+ </body></html>
\ No newline at end of file