<html>
<head>
<title>Coverage for Doctrine_Expression_Driver</title>
<style type="text/css">
.covered{ background: green;}
.normal{ background: white;}
.red{ background: red;}
.orange{ background: #f90;}
</style>
</head>
<body><h1>Coverage for Doctrine_Expression_Driver</h1><p><a href="index.php">Back to coverage report</a></p><table>
<tr><td>1</td>
<td class="normal"><?php
</td></tr>
<tr><td>2</td>
<td class="normal">/*
</td></tr>
<tr><td>3</td>
<td class="normal"> * $Id$
</td></tr>
<tr><td>4</td>
<td class="normal"> *
</td></tr>
<tr><td>5</td>
<td class="normal"> * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
</td></tr>
<tr><td>6</td>
<td class="normal"> * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
</td></tr>
<tr><td>7</td>
<td class="normal"> * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
</td></tr>
<tr><td>8</td>
<td class="normal"> * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
</td></tr>
<tr><td>9</td>
<td class="normal"> * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
</td></tr>
<tr><td>10</td>
<td class="normal"> * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
</td></tr>
<tr><td>11</td>
<td class="normal"> * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
</td></tr>
<tr><td>12</td>
<td class="normal"> * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
</td></tr>
<tr><td>13</td>
<td class="normal"> * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
</td></tr>
<tr><td>14</td>
<td class="normal"> * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
</td></tr>
<tr><td>15</td>
<td class="normal"> * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
</td></tr>
<tr><td>16</td>
<td class="normal"> *
</td></tr>
<tr><td>17</td>
<td class="normal"> * This software consists of voluntary contributions made by many individuals
</td></tr>
<tr><td>18</td>
<td class="normal"> * and is licensed under the LGPL. For more information, see
</td></tr>
<tr><td>19</td>
<td class="normal"> * <http://www.phpdoctrine.com>.
</td></tr>
<tr><td>20</td>
<td class="normal"> */
</td></tr>
<tr><td>21</td>
<td class="covered">Doctrine::autoload('Doctrine_Connection_Module');
</td></tr>
<tr><td>22</td>
<td class="normal">/**
</td></tr>
<tr><td>23</td>
<td class="normal"> * Doctrine_Expression_Driver
</td></tr>
<tr><td>24</td>
<td class="normal"> *
</td></tr>
<tr><td>25</td>
<td class="normal"> * @package Doctrine
</td></tr>
<tr><td>26</td>
<td class="normal"> * @subpackage Expression
</td></tr>
<tr><td>27</td>
<td class="normal"> * @license http://www.opensource.org/licenses/lgpl-license.php LGPL
</td></tr>
<tr><td>28</td>
<td class="normal"> * @link www.phpdoctrine.com
</td></tr>
<tr><td>29</td>
<td class="normal"> * @since 1.0
</td></tr>
<tr><td>30</td>
<td class="normal"> * @version $Revision$
</td></tr>
<tr><td>31</td>
<td class="normal"> * @author Konsta Vesterinen <kvesteri@cc.hut.fi>
</td></tr>
<tr><td>32</td>
<td class="normal"> */
</td></tr>
<tr><td>33</td>
<td class="covered">class Doctrine_Expression_Driver extends Doctrine_Connection_Module
</td></tr>
<tr><td>34</td>
<td class="normal">{
</td></tr>
<tr><td>35</td>
<td class="normal"> public function getIdentifier($column)
</td></tr>
<tr><td>36</td>
<td class="normal"> {
</td></tr>
<tr><td>37</td>
<td class="covered"> return $column;
</td></tr>
<tr><td>38</td>
<td class="orange"> }
</td></tr>
<tr><td>39</td>
<td class="normal"> public function getIdentifiers($columns)
</td></tr>
<tr><td>40</td>
<td class="normal"> {
</td></tr>
<tr><td>41</td>
<td class="covered"> return $columns;
</td></tr>
<tr><td>42</td>
<td class="orange"> }
</td></tr>
<tr><td>43</td>
<td class="normal"> /**
</td></tr>
<tr><td>44</td>
<td class="normal"> * regexp
</td></tr>
<tr><td>45</td>
<td class="normal"> * returns the regular expression operator
</td></tr>
<tr><td>46</td>
<td class="normal"> *
</td></tr>
<tr><td>47</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>48</td>
<td class="normal"> */
</td></tr>
<tr><td>49</td>
<td class="normal"> public function regexp()
</td></tr>
<tr><td>50</td>
<td class="normal"> {
</td></tr>
<tr><td>51</td>
<td class="covered"> throw new Doctrine_Expression_Exception('Regular expression operator is not supported by this database driver.');
</td></tr>
<tr><td>52</td>
<td class="orange"> }
</td></tr>
<tr><td>53</td>
<td class="normal"> /**
</td></tr>
<tr><td>54</td>
<td class="normal"> * Returns the average value of a column
</td></tr>
<tr><td>55</td>
<td class="normal"> *
</td></tr>
<tr><td>56</td>
<td class="normal"> * @param string $column the column to use
</td></tr>
<tr><td>57</td>
<td class="normal"> * @return string generated sql including an AVG aggregate function
</td></tr>
<tr><td>58</td>
<td class="normal"> */
</td></tr>
<tr><td>59</td>
<td class="normal"> public function avg($column)
</td></tr>
<tr><td>60</td>
<td class="normal"> {
</td></tr>
<tr><td>61</td>
<td class="covered"> $column = $this->getIdentifier($column);
</td></tr>
<tr><td>62</td>
<td class="covered"> return 'AVG(' . $column . ')';
</td></tr>
<tr><td>63</td>
<td class="orange"> }
</td></tr>
<tr><td>64</td>
<td class="normal">
</td></tr>
<tr><td>65</td>
<td class="normal"> /**
</td></tr>
<tr><td>66</td>
<td class="normal"> * Returns the number of rows (without a NULL value) of a column
</td></tr>
<tr><td>67</td>
<td class="normal"> *
</td></tr>
<tr><td>68</td>
<td class="normal"> * If a '*' is used instead of a column the number of selected rows
</td></tr>
<tr><td>69</td>
<td class="normal"> * is returned.
</td></tr>
<tr><td>70</td>
<td class="normal"> *
</td></tr>
<tr><td>71</td>
<td class="normal"> * @param string|integer $column the column to use
</td></tr>
<tr><td>72</td>
<td class="normal"> * @return string generated sql including a COUNT aggregate function
</td></tr>
<tr><td>73</td>
<td class="normal"> */
</td></tr>
<tr><td>74</td>
<td class="normal"> public function count($column)
</td></tr>
<tr><td>75</td>
<td class="normal"> {
</td></tr>
<tr><td>76</td>
<td class="covered"> $column = $this->getIdentifier($column);
</td></tr>
<tr><td>77</td>
<td class="covered"> return 'COUNT(' . $column . ')';
</td></tr>
<tr><td>78</td>
<td class="orange"> }
</td></tr>
<tr><td>79</td>
<td class="normal">
</td></tr>
<tr><td>80</td>
<td class="normal"> /**
</td></tr>
<tr><td>81</td>
<td class="normal"> * Returns the highest value of a column
</td></tr>
<tr><td>82</td>
<td class="normal"> *
</td></tr>
<tr><td>83</td>
<td class="normal"> * @param string $column the column to use
</td></tr>
<tr><td>84</td>
<td class="normal"> * @return string generated sql including a MAX aggregate function
</td></tr>
<tr><td>85</td>
<td class="normal"> */
</td></tr>
<tr><td>86</td>
<td class="normal"> public function max($column)
</td></tr>
<tr><td>87</td>
<td class="normal"> {
</td></tr>
<tr><td>88</td>
<td class="covered"> $column = $this->getIdentifier($column);
</td></tr>
<tr><td>89</td>
<td class="covered"> return 'MAX(' . $column . ')';
</td></tr>
<tr><td>90</td>
<td class="orange"> }
</td></tr>
<tr><td>91</td>
<td class="normal">
</td></tr>
<tr><td>92</td>
<td class="normal"> /**
</td></tr>
<tr><td>93</td>
<td class="normal"> * Returns the lowest value of a column
</td></tr>
<tr><td>94</td>
<td class="normal"> *
</td></tr>
<tr><td>95</td>
<td class="normal"> * @param string $column the column to use
</td></tr>
<tr><td>96</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>97</td>
<td class="normal"> */
</td></tr>
<tr><td>98</td>
<td class="normal"> public function min($column)
</td></tr>
<tr><td>99</td>
<td class="normal"> {
</td></tr>
<tr><td>100</td>
<td class="covered"> $column = $this->getIdentifier($column);
</td></tr>
<tr><td>101</td>
<td class="covered"> return 'MIN(' . $column . ')';
</td></tr>
<tr><td>102</td>
<td class="orange"> }
</td></tr>
<tr><td>103</td>
<td class="normal">
</td></tr>
<tr><td>104</td>
<td class="normal"> /**
</td></tr>
<tr><td>105</td>
<td class="normal"> * Returns the total sum of a column
</td></tr>
<tr><td>106</td>
<td class="normal"> *
</td></tr>
<tr><td>107</td>
<td class="normal"> * @param string $column the column to use
</td></tr>
<tr><td>108</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>109</td>
<td class="normal"> */
</td></tr>
<tr><td>110</td>
<td class="normal"> public function sum($column)
</td></tr>
<tr><td>111</td>
<td class="normal"> {
</td></tr>
<tr><td>112</td>
<td class="covered"> $column = $this->getIdentifier($column);
</td></tr>
<tr><td>113</td>
<td class="covered"> return 'SUM(' . $column . ')';
</td></tr>
<tr><td>114</td>
<td class="orange"> }
</td></tr>
<tr><td>115</td>
<td class="normal">
</td></tr>
<tr><td>116</td>
<td class="normal"> // scalar functions
</td></tr>
<tr><td>117</td>
<td class="normal">
</td></tr>
<tr><td>118</td>
<td class="normal"> /**
</td></tr>
<tr><td>119</td>
<td class="normal"> * Returns the md5 sum of a field.
</td></tr>
<tr><td>120</td>
<td class="normal"> *
</td></tr>
<tr><td>121</td>
<td class="normal"> * Note: Not SQL92, but common functionality
</td></tr>
<tr><td>122</td>
<td class="normal"> *
</td></tr>
<tr><td>123</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>124</td>
<td class="normal"> */
</td></tr>
<tr><td>125</td>
<td class="normal"> public function md5($column)
</td></tr>
<tr><td>126</td>
<td class="normal"> {
</td></tr>
<tr><td>127</td>
<td class="red"> $column = $this->getIdentifier($column);
</td></tr>
<tr><td>128</td>
<td class="red"> return 'MD5(' . $column . ')';
</td></tr>
<tr><td>129</td>
<td class="orange"> }
</td></tr>
<tr><td>130</td>
<td class="normal">
</td></tr>
<tr><td>131</td>
<td class="normal"> /**
</td></tr>
<tr><td>132</td>
<td class="normal"> * Returns the length of a text field.
</td></tr>
<tr><td>133</td>
<td class="normal"> *
</td></tr>
<tr><td>134</td>
<td class="normal"> * @param string $expression1
</td></tr>
<tr><td>135</td>
<td class="normal"> * @param string $expression2
</td></tr>
<tr><td>136</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>137</td>
<td class="normal"> */
</td></tr>
<tr><td>138</td>
<td class="normal"> public function length($column)
</td></tr>
<tr><td>139</td>
<td class="normal"> {
</td></tr>
<tr><td>140</td>
<td class="covered"> $column = $this->getIdentifier($column);
</td></tr>
<tr><td>141</td>
<td class="covered"> return 'LENGTH(' . $column . ')';
</td></tr>
<tr><td>142</td>
<td class="orange"> }
</td></tr>
<tr><td>143</td>
<td class="normal">
</td></tr>
<tr><td>144</td>
<td class="normal"> /**
</td></tr>
<tr><td>145</td>
<td class="normal"> * Rounds a numeric field to the number of decimals specified.
</td></tr>
<tr><td>146</td>
<td class="normal"> *
</td></tr>
<tr><td>147</td>
<td class="normal"> * @param string $expression1
</td></tr>
<tr><td>148</td>
<td class="normal"> * @param string $expression2
</td></tr>
<tr><td>149</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>150</td>
<td class="normal"> */
</td></tr>
<tr><td>151</td>
<td class="normal"> public function round($column, $decimals = 0)
</td></tr>
<tr><td>152</td>
<td class="normal"> {
</td></tr>
<tr><td>153</td>
<td class="covered"> $column = $this->getIdentifier($column);
</td></tr>
<tr><td>154</td>
<td class="normal">
</td></tr>
<tr><td>155</td>
<td class="covered"> return 'ROUND(' . $column . ', ' . $decimals . ')';
</td></tr>
<tr><td>156</td>
<td class="orange"> }
</td></tr>
<tr><td>157</td>
<td class="normal">
</td></tr>
<tr><td>158</td>
<td class="normal"> /**
</td></tr>
<tr><td>159</td>
<td class="normal"> * Returns the remainder of the division operation
</td></tr>
<tr><td>160</td>
<td class="normal"> * $expression1 / $expression2.
</td></tr>
<tr><td>161</td>
<td class="normal"> *
</td></tr>
<tr><td>162</td>
<td class="normal"> * @param string $expression1
</td></tr>
<tr><td>163</td>
<td class="normal"> * @param string $expression2
</td></tr>
<tr><td>164</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>165</td>
<td class="normal"> */
</td></tr>
<tr><td>166</td>
<td class="normal"> public function mod($expression1, $expression2)
</td></tr>
<tr><td>167</td>
<td class="normal"> {
</td></tr>
<tr><td>168</td>
<td class="covered"> $expression1 = $this->getIdentifier($expression1);
</td></tr>
<tr><td>169</td>
<td class="covered"> $expression2 = $this->getIdentifier($expression2);
</td></tr>
<tr><td>170</td>
<td class="covered"> return 'MOD(' . $expression1 . ', ' . $expression2 . ')';
</td></tr>
<tr><td>171</td>
<td class="orange"> }
</td></tr>
<tr><td>172</td>
<td class="normal">
</td></tr>
<tr><td>173</td>
<td class="normal"> /**
</td></tr>
<tr><td>174</td>
<td class="normal"> * trim
</td></tr>
<tr><td>175</td>
<td class="normal"> * returns the string $str with leading and proceeding space characters removed
</td></tr>
<tr><td>176</td>
<td class="normal"> *
</td></tr>
<tr><td>177</td>
<td class="normal"> * @param string $str literal string or column name
</td></tr>
<tr><td>178</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>179</td>
<td class="normal"> */
</td></tr>
<tr><td>180</td>
<td class="normal"> public function trim($str)
</td></tr>
<tr><td>181</td>
<td class="normal"> {
</td></tr>
<tr><td>182</td>
<td class="covered"> return 'TRIM(' . $str . ')';
</td></tr>
<tr><td>183</td>
<td class="orange"> }
</td></tr>
<tr><td>184</td>
<td class="normal">
</td></tr>
<tr><td>185</td>
<td class="normal"> /**
</td></tr>
<tr><td>186</td>
<td class="normal"> * rtrim
</td></tr>
<tr><td>187</td>
<td class="normal"> * returns the string $str with proceeding space characters removed
</td></tr>
<tr><td>188</td>
<td class="normal"> *
</td></tr>
<tr><td>189</td>
<td class="normal"> * @param string $str literal string or column name
</td></tr>
<tr><td>190</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>191</td>
<td class="normal"> */
</td></tr>
<tr><td>192</td>
<td class="normal"> public function rtrim($str)
</td></tr>
<tr><td>193</td>
<td class="normal"> {
</td></tr>
<tr><td>194</td>
<td class="red"> return 'RTRIM(' . $str . ')';
</td></tr>
<tr><td>195</td>
<td class="orange"> }
</td></tr>
<tr><td>196</td>
<td class="normal">
</td></tr>
<tr><td>197</td>
<td class="normal"> /**
</td></tr>
<tr><td>198</td>
<td class="normal"> * ltrim
</td></tr>
<tr><td>199</td>
<td class="normal"> * returns the string $str with leading space characters removed
</td></tr>
<tr><td>200</td>
<td class="normal"> *
</td></tr>
<tr><td>201</td>
<td class="normal"> * @param string $str literal string or column name
</td></tr>
<tr><td>202</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>203</td>
<td class="normal"> */
</td></tr>
<tr><td>204</td>
<td class="normal"> public function ltrim($str)
</td></tr>
<tr><td>205</td>
<td class="normal"> {
</td></tr>
<tr><td>206</td>
<td class="covered"> return 'LTRIM(' . $str . ')';
</td></tr>
<tr><td>207</td>
<td class="orange"> }
</td></tr>
<tr><td>208</td>
<td class="normal"> /**
</td></tr>
<tr><td>209</td>
<td class="normal"> * upper
</td></tr>
<tr><td>210</td>
<td class="normal"> * Returns the string $str with all characters changed to
</td></tr>
<tr><td>211</td>
<td class="normal"> * uppercase according to the current character set mapping.
</td></tr>
<tr><td>212</td>
<td class="normal"> *
</td></tr>
<tr><td>213</td>
<td class="normal"> * @param string $str literal string or column name
</td></tr>
<tr><td>214</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>215</td>
<td class="normal"> */
</td></tr>
<tr><td>216</td>
<td class="normal"> public function upper($str)
</td></tr>
<tr><td>217</td>
<td class="normal"> {
</td></tr>
<tr><td>218</td>
<td class="covered"> return 'UPPER(' . $str . ')';
</td></tr>
<tr><td>219</td>
<td class="orange"> }
</td></tr>
<tr><td>220</td>
<td class="normal"> /**
</td></tr>
<tr><td>221</td>
<td class="normal"> * lower
</td></tr>
<tr><td>222</td>
<td class="normal"> * Returns the string $str with all characters changed to
</td></tr>
<tr><td>223</td>
<td class="normal"> * lowercase according to the current character set mapping.
</td></tr>
<tr><td>224</td>
<td class="normal"> *
</td></tr>
<tr><td>225</td>
<td class="normal"> * @param string $str literal string or column name
</td></tr>
<tr><td>226</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>227</td>
<td class="normal"> */
</td></tr>
<tr><td>228</td>
<td class="normal"> public function lower($str)
</td></tr>
<tr><td>229</td>
<td class="normal"> {
</td></tr>
<tr><td>230</td>
<td class="covered"> return 'LOWER(' . $str . ')';
</td></tr>
<tr><td>231</td>
<td class="orange"> }
</td></tr>
<tr><td>232</td>
<td class="normal"> /**
</td></tr>
<tr><td>233</td>
<td class="normal"> * locate
</td></tr>
<tr><td>234</td>
<td class="normal"> * returns the position of the first occurrence of substring $substr in string $str
</td></tr>
<tr><td>235</td>
<td class="normal"> *
</td></tr>
<tr><td>236</td>
<td class="normal"> * @param string $substr literal string to find
</td></tr>
<tr><td>237</td>
<td class="normal"> * @param string $str literal string
</td></tr>
<tr><td>238</td>
<td class="normal"> * @return integer
</td></tr>
<tr><td>239</td>
<td class="normal"> */
</td></tr>
<tr><td>240</td>
<td class="normal"> public function locate($str, $substr)
</td></tr>
<tr><td>241</td>
<td class="normal"> {
</td></tr>
<tr><td>242</td>
<td class="covered"> return 'LOCATE(' . $str . ', ' . $substr . ')';
</td></tr>
<tr><td>243</td>
<td class="orange"> }
</td></tr>
<tr><td>244</td>
<td class="normal"> /**
</td></tr>
<tr><td>245</td>
<td class="normal"> * Returns the current system date.
</td></tr>
<tr><td>246</td>
<td class="normal"> *
</td></tr>
<tr><td>247</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>248</td>
<td class="normal"> */
</td></tr>
<tr><td>249</td>
<td class="normal"> public function now()
</td></tr>
<tr><td>250</td>
<td class="normal"> {
</td></tr>
<tr><td>251</td>
<td class="covered"> return 'NOW()';
</td></tr>
<tr><td>252</td>
<td class="orange"> }
</td></tr>
<tr><td>253</td>
<td class="normal"> /**
</td></tr>
<tr><td>254</td>
<td class="normal"> * soundex
</td></tr>
<tr><td>255</td>
<td class="normal"> * Returns a string to call a function to compute the
</td></tr>
<tr><td>256</td>
<td class="normal"> * soundex encoding of a string
</td></tr>
<tr><td>257</td>
<td class="normal"> *
</td></tr>
<tr><td>258</td>
<td class="normal"> * The string "?000" is returned if the argument is NULL.
</td></tr>
<tr><td>259</td>
<td class="normal"> *
</td></tr>
<tr><td>260</td>
<td class="normal"> * @param string $value
</td></tr>
<tr><td>261</td>
<td class="normal"> * @return string SQL soundex function with given parameter
</td></tr>
<tr><td>262</td>
<td class="normal"> */
</td></tr>
<tr><td>263</td>
<td class="normal"> public function soundex($value)
</td></tr>
<tr><td>264</td>
<td class="normal"> {
</td></tr>
<tr><td>265</td>
<td class="covered"> throw new Doctrine_Expression_Exception('SQL soundex function not supported by this driver.');
</td></tr>
<tr><td>266</td>
<td class="orange"> }
</td></tr>
<tr><td>267</td>
<td class="normal"> /**
</td></tr>
<tr><td>268</td>
<td class="normal"> * return string to call a function to get a substring inside an SQL statement
</td></tr>
<tr><td>269</td>
<td class="normal"> *
</td></tr>
<tr><td>270</td>
<td class="normal"> * Note: Not SQL92, but common functionality.
</td></tr>
<tr><td>271</td>
<td class="normal"> *
</td></tr>
<tr><td>272</td>
<td class="normal"> * SQLite only supports the 2 parameter variant of this function
</td></tr>
<tr><td>273</td>
<td class="normal"> *
</td></tr>
<tr><td>274</td>
<td class="normal"> * @param string $value an sql string literal or column name/alias
</td></tr>
<tr><td>275</td>
<td class="normal"> * @param integer $position where to start the substring portion
</td></tr>
<tr><td>276</td>
<td class="normal"> * @param integer $length the substring portion length
</td></tr>
<tr><td>277</td>
<td class="normal"> * @return string SQL substring function with given parameters
</td></tr>
<tr><td>278</td>
<td class="normal"> */
</td></tr>
<tr><td>279</td>
<td class="normal"> public function substring($value, $from, $len = null)
</td></tr>
<tr><td>280</td>
<td class="normal"> {
</td></tr>
<tr><td>281</td>
<td class="covered"> $value = $this->getIdentifier($value);
</td></tr>
<tr><td>282</td>
<td class="covered"> if ($len === null)
</td></tr>
<tr><td>283</td>
<td class="covered"> return 'SUBSTRING(' . $value . ' FROM ' . $from . ')';
</td></tr>
<tr><td>284</td>
<td class="normal"> else {
</td></tr>
<tr><td>285</td>
<td class="covered"> $len = $this->getIdentifier($len);
</td></tr>
<tr><td>286</td>
<td class="covered"> return 'SUBSTRING(' . $value . ' FROM ' . $from . ' FOR ' . $len . ')';
</td></tr>
<tr><td>287</td>
<td class="normal"> }
</td></tr>
<tr><td>288</td>
<td class="orange"> }
</td></tr>
<tr><td>289</td>
<td class="normal"> /**
</td></tr>
<tr><td>290</td>
<td class="normal"> * Returns a series of strings concatinated
</td></tr>
<tr><td>291</td>
<td class="normal"> *
</td></tr>
<tr><td>292</td>
<td class="normal"> * concat() accepts an arbitrary number of parameters. Each parameter
</td></tr>
<tr><td>293</td>
<td class="normal"> * must contain an expression or an array with expressions.
</td></tr>
<tr><td>294</td>
<td class="normal"> *
</td></tr>
<tr><td>295</td>
<td class="normal"> * @param string|array(string) strings that will be concatinated.
</td></tr>
<tr><td>296</td>
<td class="normal"> */
</td></tr>
<tr><td>297</td>
<td class="normal"> public function concat()
</td></tr>
<tr><td>298</td>
<td class="normal"> {
</td></tr>
<tr><td>299</td>
<td class="covered"> $args = func_get_args();
</td></tr>
<tr><td>300</td>
<td class="normal">
</td></tr>
<tr><td>301</td>
<td class="covered"> return 'CONCAT(' . join(', ', (array) $args) . ')';
</td></tr>
<tr><td>302</td>
<td class="orange"> }
</td></tr>
<tr><td>303</td>
<td class="normal"> /**
</td></tr>
<tr><td>304</td>
<td class="normal"> * Returns the SQL for a logical not.
</td></tr>
<tr><td>305</td>
<td class="normal"> *
</td></tr>
<tr><td>306</td>
<td class="normal"> * Example:
</td></tr>
<tr><td>307</td>
<td class="normal"> * <code>
</td></tr>
<tr><td>308</td>
<td class="normal"> * $q = new Doctrine_Query();
</td></tr>
<tr><td>309</td>
<td class="normal"> * $e = $q->expr;
</td></tr>
<tr><td>310</td>
<td class="normal"> * $q->select('*')->from('table')
</td></tr>
<tr><td>311</td>
<td class="normal"> * ->where($e->eq('id', $e->not('null'));
</td></tr>
<tr><td>312</td>
<td class="normal"> * </code>
</td></tr>
<tr><td>313</td>
<td class="normal"> *
</td></tr>
<tr><td>314</td>
<td class="normal"> * @return string a logical expression
</td></tr>
<tr><td>315</td>
<td class="normal"> */
</td></tr>
<tr><td>316</td>
<td class="normal"> public function not($expression)
</td></tr>
<tr><td>317</td>
<td class="normal"> {
</td></tr>
<tr><td>318</td>
<td class="covered"> $expression = $this->getIdentifier($expression);
</td></tr>
<tr><td>319</td>
<td class="covered"> return 'NOT(' . $expression . ')';
</td></tr>
<tr><td>320</td>
<td class="orange"> }
</td></tr>
<tr><td>321</td>
<td class="normal"> /**
</td></tr>
<tr><td>322</td>
<td class="normal"> * Returns the SQL to perform the same mathematical operation over an array
</td></tr>
<tr><td>323</td>
<td class="normal"> * of values or expressions.
</td></tr>
<tr><td>324</td>
<td class="normal"> *
</td></tr>
<tr><td>325</td>
<td class="normal"> * basicMath() accepts an arbitrary number of parameters. Each parameter
</td></tr>
<tr><td>326</td>
<td class="normal"> * must contain a value or an expression or an array with values or
</td></tr>
<tr><td>327</td>
<td class="normal"> * expressions.
</td></tr>
<tr><td>328</td>
<td class="normal"> *
</td></tr>
<tr><td>329</td>
<td class="normal"> * @param string $type the type of operation, can be '+', '-', '*' or '/'.
</td></tr>
<tr><td>330</td>
<td class="normal"> * @param string|array(string)
</td></tr>
<tr><td>331</td>
<td class="normal"> * @return string an expression
</td></tr>
<tr><td>332</td>
<td class="normal"> */
</td></tr>
<tr><td>333</td>
<td class="normal"> private function basicMath($type, array $args)
</td></tr>
<tr><td>334</td>
<td class="normal"> {
</td></tr>
<tr><td>335</td>
<td class="covered"> $elements = $this->getIdentifiers($args);
</td></tr>
<tr><td>336</td>
<td class="covered"> if (count($elements) < 1) {
</td></tr>
<tr><td>337</td>
<td class="red"> return '';
</td></tr>
<tr><td>338</td>
<td class="orange"> }
</td></tr>
<tr><td>339</td>
<td class="covered"> if (count($elements) == 1) {
</td></tr>
<tr><td>340</td>
<td class="red"> return $elements[0];
</td></tr>
<tr><td>341</td>
<td class="orange"> } else {
</td></tr>
<tr><td>342</td>
<td class="covered"> return '(' . implode(' ' . $type . ' ', $elements) . ')';
</td></tr>
<tr><td>343</td>
<td class="normal"> }
</td></tr>
<tr><td>344</td>
<td class="orange"> }
</td></tr>
<tr><td>345</td>
<td class="normal"> /**
</td></tr>
<tr><td>346</td>
<td class="normal"> * Returns the SQL to add values or expressions together.
</td></tr>
<tr><td>347</td>
<td class="normal"> *
</td></tr>
<tr><td>348</td>
<td class="normal"> * add() accepts an arbitrary number of parameters. Each parameter
</td></tr>
<tr><td>349</td>
<td class="normal"> * must contain a value or an expression or an array with values or
</td></tr>
<tr><td>350</td>
<td class="normal"> * expressions.
</td></tr>
<tr><td>351</td>
<td class="normal"> *
</td></tr>
<tr><td>352</td>
<td class="normal"> * Example:
</td></tr>
<tr><td>353</td>
<td class="normal"> * <code>
</td></tr>
<tr><td>354</td>
<td class="normal"> * $q = new Doctrine_Query();
</td></tr>
<tr><td>355</td>
<td class="normal"> * $e = $q->expr;
</td></tr>
<tr><td>356</td>
<td class="normal"> *
</td></tr>
<tr><td>357</td>
<td class="normal"> * $q->select('u.*')
</td></tr>
<tr><td>358</td>
<td class="normal"> * ->from('User u')
</td></tr>
<tr><td>359</td>
<td class="normal"> * ->where($e->eq($e->add('id', 2), 12));
</td></tr>
<tr><td>360</td>
<td class="normal"> * </code>
</td></tr>
<tr><td>361</td>
<td class="normal"> *
</td></tr>
<tr><td>362</td>
<td class="normal"> * @param string|array(string)
</td></tr>
<tr><td>363</td>
<td class="normal"> * @return string an expression
</td></tr>
<tr><td>364</td>
<td class="normal"> */
</td></tr>
<tr><td>365</td>
<td class="normal"> public function add(array $args)
</td></tr>
<tr><td>366</td>
<td class="normal"> {
</td></tr>
<tr><td>367</td>
<td class="covered"> return $this->basicMath('+', $args);
</td></tr>
<tr><td>368</td>
<td class="orange"> }
</td></tr>
<tr><td>369</td>
<td class="normal">
</td></tr>
<tr><td>370</td>
<td class="normal"> /**
</td></tr>
<tr><td>371</td>
<td class="normal"> * Returns the SQL to subtract values or expressions from eachother.
</td></tr>
<tr><td>372</td>
<td class="normal"> *
</td></tr>
<tr><td>373</td>
<td class="normal"> * subtract() accepts an arbitrary number of parameters. Each parameter
</td></tr>
<tr><td>374</td>
<td class="normal"> * must contain a value or an expression or an array with values or
</td></tr>
<tr><td>375</td>
<td class="normal"> * expressions.
</td></tr>
<tr><td>376</td>
<td class="normal"> *
</td></tr>
<tr><td>377</td>
<td class="normal"> * Example:
</td></tr>
<tr><td>378</td>
<td class="normal"> * <code>
</td></tr>
<tr><td>379</td>
<td class="normal"> * $q = new Doctrine_Query();
</td></tr>
<tr><td>380</td>
<td class="normal"> * $e = $q->expr;
</td></tr>
<tr><td>381</td>
<td class="normal"> *
</td></tr>
<tr><td>382</td>
<td class="normal"> * $q->select('u.*')
</td></tr>
<tr><td>383</td>
<td class="normal"> * ->from('User u')
</td></tr>
<tr><td>384</td>
<td class="normal"> * ->where($e->eq($e->sub('id', 2), 12));
</td></tr>
<tr><td>385</td>
<td class="normal"> * </code>
</td></tr>
<tr><td>386</td>
<td class="normal"> *
</td></tr>
<tr><td>387</td>
<td class="normal"> * @param string|array(string)
</td></tr>
<tr><td>388</td>
<td class="normal"> * @return string an expression
</td></tr>
<tr><td>389</td>
<td class="normal"> */
</td></tr>
<tr><td>390</td>
<td class="normal"> public function sub(array $args)
</td></tr>
<tr><td>391</td>
<td class="normal"> {
</td></tr>
<tr><td>392</td>
<td class="covered"> return $this->basicMath('-', $args );
</td></tr>
<tr><td>393</td>
<td class="orange"> }
</td></tr>
<tr><td>394</td>
<td class="normal">
</td></tr>
<tr><td>395</td>
<td class="normal"> /**
</td></tr>
<tr><td>396</td>
<td class="normal"> * Returns the SQL to multiply values or expressions by eachother.
</td></tr>
<tr><td>397</td>
<td class="normal"> *
</td></tr>
<tr><td>398</td>
<td class="normal"> * multiply() accepts an arbitrary number of parameters. Each parameter
</td></tr>
<tr><td>399</td>
<td class="normal"> * must contain a value or an expression or an array with values or
</td></tr>
<tr><td>400</td>
<td class="normal"> * expressions.
</td></tr>
<tr><td>401</td>
<td class="normal"> *
</td></tr>
<tr><td>402</td>
<td class="normal"> * Example:
</td></tr>
<tr><td>403</td>
<td class="normal"> * <code>
</td></tr>
<tr><td>404</td>
<td class="normal"> * $q = new Doctrine_Query();
</td></tr>
<tr><td>405</td>
<td class="normal"> * $e = $q->expr;
</td></tr>
<tr><td>406</td>
<td class="normal"> *
</td></tr>
<tr><td>407</td>
<td class="normal"> * $q->select('u.*')
</td></tr>
<tr><td>408</td>
<td class="normal"> * ->from('User u')
</td></tr>
<tr><td>409</td>
<td class="normal"> * ->where($e->eq($e->mul('id', 2), 12));
</td></tr>
<tr><td>410</td>
<td class="normal"> * </code>
</td></tr>
<tr><td>411</td>
<td class="normal"> *
</td></tr>
<tr><td>412</td>
<td class="normal"> * @param string|array(string)
</td></tr>
<tr><td>413</td>
<td class="normal"> * @return string an expression
</td></tr>
<tr><td>414</td>
<td class="normal"> */
</td></tr>
<tr><td>415</td>
<td class="normal"> public function mul(array $args)
</td></tr>
<tr><td>416</td>
<td class="normal"> {
</td></tr>
<tr><td>417</td>
<td class="covered"> return $this->basicMath('*', $args);
</td></tr>
<tr><td>418</td>
<td class="orange"> }
</td></tr>
<tr><td>419</td>
<td class="normal">
</td></tr>
<tr><td>420</td>
<td class="normal"> /**
</td></tr>
<tr><td>421</td>
<td class="normal"> * Returns the SQL to divide values or expressions by eachother.
</td></tr>
<tr><td>422</td>
<td class="normal"> *
</td></tr>
<tr><td>423</td>
<td class="normal"> * divide() accepts an arbitrary number of parameters. Each parameter
</td></tr>
<tr><td>424</td>
<td class="normal"> * must contain a value or an expression or an array with values or
</td></tr>
<tr><td>425</td>
<td class="normal"> * expressions.
</td></tr>
<tr><td>426</td>
<td class="normal"> *
</td></tr>
<tr><td>427</td>
<td class="normal"> * Example:
</td></tr>
<tr><td>428</td>
<td class="normal"> * <code>
</td></tr>
<tr><td>429</td>
<td class="normal"> * $q = new Doctrine_Query();
</td></tr>
<tr><td>430</td>
<td class="normal"> * $e = $q->expr;
</td></tr>
<tr><td>431</td>
<td class="normal"> *
</td></tr>
<tr><td>432</td>
<td class="normal"> * $q->select('u.*')
</td></tr>
<tr><td>433</td>
<td class="normal"> * ->from('User u')
</td></tr>
<tr><td>434</td>
<td class="normal"> * ->where($e->eq($e->div('id', 2), 12));
</td></tr>
<tr><td>435</td>
<td class="normal"> * </code>
</td></tr>
<tr><td>436</td>
<td class="normal"> *
</td></tr>
<tr><td>437</td>
<td class="normal"> * @param string|array(string)
</td></tr>
<tr><td>438</td>
<td class="normal"> * @return string an expression
</td></tr>
<tr><td>439</td>
<td class="normal"> */
</td></tr>
<tr><td>440</td>
<td class="normal"> public function div(array $args)
</td></tr>
<tr><td>441</td>
<td class="normal"> {
</td></tr>
<tr><td>442</td>
<td class="covered"> return $this->basicMath('/', $args);
</td></tr>
<tr><td>443</td>
<td class="orange"> }
</td></tr>
<tr><td>444</td>
<td class="normal">
</td></tr>
<tr><td>445</td>
<td class="normal"> /**
</td></tr>
<tr><td>446</td>
<td class="normal"> * Returns the SQL to check if two values are equal.
</td></tr>
<tr><td>447</td>
<td class="normal"> *
</td></tr>
<tr><td>448</td>
<td class="normal"> * Example:
</td></tr>
<tr><td>449</td>
<td class="normal"> * <code>
</td></tr>
<tr><td>450</td>
<td class="normal"> * $q = new Doctrine_Query();
</td></tr>
<tr><td>451</td>
<td class="normal"> * $q->select('u.*')
</td></tr>
<tr><td>452</td>
<td class="normal"> * ->from('User u')
</td></tr>
<tr><td>453</td>
<td class="normal"> * ->where($q->expr->eq('id', 1));
</td></tr>
<tr><td>454</td>
<td class="normal"> * </code>
</td></tr>
<tr><td>455</td>
<td class="normal"> *
</td></tr>
<tr><td>456</td>
<td class="normal"> * @param string $value1 logical expression to compare
</td></tr>
<tr><td>457</td>
<td class="normal"> * @param string $value2 logical expression to compare with
</td></tr>
<tr><td>458</td>
<td class="normal"> * @return string logical expression
</td></tr>
<tr><td>459</td>
<td class="normal"> */
</td></tr>
<tr><td>460</td>
<td class="normal"> public function eq($value1, $value2)
</td></tr>
<tr><td>461</td>
<td class="normal"> {
</td></tr>
<tr><td>462</td>
<td class="covered"> $value1 = $this->getIdentifier($value1);
</td></tr>
<tr><td>463</td>
<td class="covered"> $value2 = $this->getIdentifier($value2);
</td></tr>
<tr><td>464</td>
<td class="covered"> return $value1 . ' = ' . $value2;
</td></tr>
<tr><td>465</td>
<td class="orange"> }
</td></tr>
<tr><td>466</td>
<td class="normal">
</td></tr>
<tr><td>467</td>
<td class="normal"> /**
</td></tr>
<tr><td>468</td>
<td class="normal"> * Returns the SQL to check if two values are unequal.
</td></tr>
<tr><td>469</td>
<td class="normal"> *
</td></tr>
<tr><td>470</td>
<td class="normal"> * Example:
</td></tr>
<tr><td>471</td>
<td class="normal"> * <code>
</td></tr>
<tr><td>472</td>
<td class="normal"> * $q = new Doctrine_Query();
</td></tr>
<tr><td>473</td>
<td class="normal"> * $q->select('u.*')
</td></tr>
<tr><td>474</td>
<td class="normal"> * ->from('User u')
</td></tr>
<tr><td>475</td>
<td class="normal"> * ->where($q->expr->neq('id', 1));
</td></tr>
<tr><td>476</td>
<td class="normal"> * </code>
</td></tr>
<tr><td>477</td>
<td class="normal"> *
</td></tr>
<tr><td>478</td>
<td class="normal"> * @param string $value1 logical expression to compare
</td></tr>
<tr><td>479</td>
<td class="normal"> * @param string $value2 logical expression to compare with
</td></tr>
<tr><td>480</td>
<td class="normal"> * @return string logical expression
</td></tr>
<tr><td>481</td>
<td class="normal"> */
</td></tr>
<tr><td>482</td>
<td class="normal"> public function neq($value1, $value2)
</td></tr>
<tr><td>483</td>
<td class="normal"> {
</td></tr>
<tr><td>484</td>
<td class="covered"> $value1 = $this->getIdentifier($value1);
</td></tr>
<tr><td>485</td>
<td class="covered"> $value2 = $this->getIdentifier($value2);
</td></tr>
<tr><td>486</td>
<td class="covered"> return $value1 . ' <> ' . $value2;
</td></tr>
<tr><td>487</td>
<td class="orange"> }
</td></tr>
<tr><td>488</td>
<td class="normal">
</td></tr>
<tr><td>489</td>
<td class="normal"> /**
</td></tr>
<tr><td>490</td>
<td class="normal"> * Returns the SQL to check if one value is greater than another value.
</td></tr>
<tr><td>491</td>
<td class="normal"> *
</td></tr>
<tr><td>492</td>
<td class="normal"> * Example:
</td></tr>
<tr><td>493</td>
<td class="normal"> * <code>
</td></tr>
<tr><td>494</td>
<td class="normal"> * $q = new Doctrine_Query();
</td></tr>
<tr><td>495</td>
<td class="normal"> * $q->select('u.*')
</td></tr>
<tr><td>496</td>
<td class="normal"> * ->from('User u')
</td></tr>
<tr><td>497</td>
<td class="normal"> * ->where($q->expr->gt('id', 1));
</td></tr>
<tr><td>498</td>
<td class="normal"> * </code>
</td></tr>
<tr><td>499</td>
<td class="normal"> *
</td></tr>
<tr><td>500</td>
<td class="normal"> * @param string $value1 logical expression to compare
</td></tr>
<tr><td>501</td>
<td class="normal"> * @param string $value2 logical expression to compare with
</td></tr>
<tr><td>502</td>
<td class="normal"> * @return string logical expression
</td></tr>
<tr><td>503</td>
<td class="normal"> */
</td></tr>
<tr><td>504</td>
<td class="normal"> public function gt($value1, $value2)
</td></tr>
<tr><td>505</td>
<td class="normal"> {
</td></tr>
<tr><td>506</td>
<td class="covered"> $value1 = $this->getIdentifier($value1);
</td></tr>
<tr><td>507</td>
<td class="covered"> $value2 = $this->getIdentifier($value2);
</td></tr>
<tr><td>508</td>
<td class="covered"> return $value1 . ' > ' . $value2;
</td></tr>
<tr><td>509</td>
<td class="orange"> }
</td></tr>
<tr><td>510</td>
<td class="normal">
</td></tr>
<tr><td>511</td>
<td class="normal"> /**
</td></tr>
<tr><td>512</td>
<td class="normal"> * Returns the SQL to check if one value is greater than or equal to
</td></tr>
<tr><td>513</td>
<td class="normal"> * another value.
</td></tr>
<tr><td>514</td>
<td class="normal"> *
</td></tr>
<tr><td>515</td>
<td class="normal"> * Example:
</td></tr>
<tr><td>516</td>
<td class="normal"> * <code>
</td></tr>
<tr><td>517</td>
<td class="normal"> * $q = new Doctrine_Query();
</td></tr>
<tr><td>518</td>
<td class="normal"> * $q->select('u.*')
</td></tr>
<tr><td>519</td>
<td class="normal"> * ->from('User u')
</td></tr>
<tr><td>520</td>
<td class="normal"> * ->where($q->expr->gte('id', 1));
</td></tr>
<tr><td>521</td>
<td class="normal"> * </code>
</td></tr>
<tr><td>522</td>
<td class="normal"> *
</td></tr>
<tr><td>523</td>
<td class="normal"> * @param string $value1 logical expression to compare
</td></tr>
<tr><td>524</td>
<td class="normal"> * @param string $value2 logical expression to compare with
</td></tr>
<tr><td>525</td>
<td class="normal"> * @return string logical expression
</td></tr>
<tr><td>526</td>
<td class="normal"> */
</td></tr>
<tr><td>527</td>
<td class="normal"> public function gte($value1, $value2)
</td></tr>
<tr><td>528</td>
<td class="normal"> {
</td></tr>
<tr><td>529</td>
<td class="covered"> $value1 = $this->getIdentifier($value1);
</td></tr>
<tr><td>530</td>
<td class="covered"> $value2 = $this->getIdentifier($value2);
</td></tr>
<tr><td>531</td>
<td class="covered"> return $value1 . ' >= ' . $value2;
</td></tr>
<tr><td>532</td>
<td class="orange"> }
</td></tr>
<tr><td>533</td>
<td class="normal">
</td></tr>
<tr><td>534</td>
<td class="normal"> /**
</td></tr>
<tr><td>535</td>
<td class="normal"> * Returns the SQL to check if one value is less than another value.
</td></tr>
<tr><td>536</td>
<td class="normal"> *
</td></tr>
<tr><td>537</td>
<td class="normal"> * Example:
</td></tr>
<tr><td>538</td>
<td class="normal"> * <code>
</td></tr>
<tr><td>539</td>
<td class="normal"> * $q = new Doctrine_Query();
</td></tr>
<tr><td>540</td>
<td class="normal"> * $q->select('u.*')
</td></tr>
<tr><td>541</td>
<td class="normal"> * ->from('User u')
</td></tr>
<tr><td>542</td>
<td class="normal"> * ->where($q->expr->lt('id', 1));
</td></tr>
<tr><td>543</td>
<td class="normal"> * </code>
</td></tr>
<tr><td>544</td>
<td class="normal"> *
</td></tr>
<tr><td>545</td>
<td class="normal"> * @param string $value1 logical expression to compare
</td></tr>
<tr><td>546</td>
<td class="normal"> * @param string $value2 logical expression to compare with
</td></tr>
<tr><td>547</td>
<td class="normal"> * @return string logical expression
</td></tr>
<tr><td>548</td>
<td class="normal"> */
</td></tr>
<tr><td>549</td>
<td class="normal"> public function lt($value1, $value2)
</td></tr>
<tr><td>550</td>
<td class="normal"> {
</td></tr>
<tr><td>551</td>
<td class="covered"> $value1 = $this->getIdentifier($value1);
</td></tr>
<tr><td>552</td>
<td class="covered"> $value2 = $this->getIdentifier($value2);
</td></tr>
<tr><td>553</td>
<td class="covered"> return $value1 . ' < ' . $value2;
</td></tr>
<tr><td>554</td>
<td class="orange"> }
</td></tr>
<tr><td>555</td>
<td class="normal">
</td></tr>
<tr><td>556</td>
<td class="normal"> /**
</td></tr>
<tr><td>557</td>
<td class="normal"> * Returns the SQL to check if one value is less than or equal to
</td></tr>
<tr><td>558</td>
<td class="normal"> * another value.
</td></tr>
<tr><td>559</td>
<td class="normal"> *
</td></tr>
<tr><td>560</td>
<td class="normal"> * Example:
</td></tr>
<tr><td>561</td>
<td class="normal"> * <code>
</td></tr>
<tr><td>562</td>
<td class="normal"> * $q = new Doctrine_Query();
</td></tr>
<tr><td>563</td>
<td class="normal"> * $q->select('u.*')
</td></tr>
<tr><td>564</td>
<td class="normal"> * ->from('User u')
</td></tr>
<tr><td>565</td>
<td class="normal"> * ->where($q->expr->lte('id', 1));
</td></tr>
<tr><td>566</td>
<td class="normal"> * </code>
</td></tr>
<tr><td>567</td>
<td class="normal"> *
</td></tr>
<tr><td>568</td>
<td class="normal"> * @param string $value1 logical expression to compare
</td></tr>
<tr><td>569</td>
<td class="normal"> * @param string $value2 logical expression to compare with
</td></tr>
<tr><td>570</td>
<td class="normal"> * @return string logical expression
</td></tr>
<tr><td>571</td>
<td class="normal"> */
</td></tr>
<tr><td>572</td>
<td class="normal"> public function lte($value1, $value2)
</td></tr>
<tr><td>573</td>
<td class="normal"> {
</td></tr>
<tr><td>574</td>
<td class="covered"> $value1 = $this->getIdentifier($value1);
</td></tr>
<tr><td>575</td>
<td class="covered"> $value2 = $this->getIdentifier($value2);
</td></tr>
<tr><td>576</td>
<td class="covered"> return $value1 . ' <= ' . $value2;
</td></tr>
<tr><td>577</td>
<td class="orange"> }
</td></tr>
<tr><td>578</td>
<td class="normal">
</td></tr>
<tr><td>579</td>
<td class="normal"> /**
</td></tr>
<tr><td>580</td>
<td class="normal"> * Returns the SQL to check if a value is one in a set of
</td></tr>
<tr><td>581</td>
<td class="normal"> * given values..
</td></tr>
<tr><td>582</td>
<td class="normal"> *
</td></tr>
<tr><td>583</td>
<td class="normal"> * in() accepts an arbitrary number of parameters. The first parameter
</td></tr>
<tr><td>584</td>
<td class="normal"> * must always specify the value that should be matched against. Successive
</td></tr>
<tr><td>585</td>
<td class="normal"> * must contain a logical expression or an array with logical expressions.
</td></tr>
<tr><td>586</td>
<td class="normal"> * These expressions will be matched against the first parameter.
</td></tr>
<tr><td>587</td>
<td class="normal"> *
</td></tr>
<tr><td>588</td>
<td class="normal"> * Example:
</td></tr>
<tr><td>589</td>
<td class="normal"> * <code>
</td></tr>
<tr><td>590</td>
<td class="normal"> * $q = new Doctrine_Query();
</td></tr>
<tr><td>591</td>
<td class="normal"> * $q->select('u.*')
</td></tr>
<tr><td>592</td>
<td class="normal"> * ->from('User u')
</td></tr>
<tr><td>593</td>
<td class="normal"> * ->where($q->expr->in( 'id', array(1,2,3)));
</td></tr>
<tr><td>594</td>
<td class="normal"> * </code>
</td></tr>
<tr><td>595</td>
<td class="normal"> *
</td></tr>
<tr><td>596</td>
<td class="normal"> * @param string $column the value that should be matched against
</td></tr>
<tr><td>597</td>
<td class="normal"> * @param string|array(string) values that will be matched against $column
</td></tr>
<tr><td>598</td>
<td class="normal"> * @return string logical expression
</td></tr>
<tr><td>599</td>
<td class="normal"> */
</td></tr>
<tr><td>600</td>
<td class="normal"> public function in($column, $values)
</td></tr>
<tr><td>601</td>
<td class="normal"> {
</td></tr>
<tr><td>602</td>
<td class="covered"> if ( ! is_array($values)) {
</td></tr>
<tr><td>603</td>
<td class="red"> $values = array($values);
</td></tr>
<tr><td>604</td>
<td class="red"> }
</td></tr>
<tr><td>605</td>
<td class="covered"> $values = $this->getIdentifiers($values);
</td></tr>
<tr><td>606</td>
<td class="covered"> $column = $this->getIdentifier($column);
</td></tr>
<tr><td>607</td>
<td class="normal">
</td></tr>
<tr><td>608</td>
<td class="covered"> if (count($values) == 0) {
</td></tr>
<tr><td>609</td>
<td class="red"> throw new Doctrine_Expression_Exception('Values array for IN operator should not be empty.');
</td></tr>
<tr><td>610</td>
<td class="orange"> }
</td></tr>
<tr><td>611</td>
<td class="covered"> return $column . ' IN (' . implode(', ', $values) . ')';
</td></tr>
<tr><td>612</td>
<td class="orange"> }
</td></tr>
<tr><td>613</td>
<td class="normal"> /**
</td></tr>
<tr><td>614</td>
<td class="normal"> * Returns SQL that checks if a expression is null.
</td></tr>
<tr><td>615</td>
<td class="normal"> *
</td></tr>
<tr><td>616</td>
<td class="normal"> * Example:
</td></tr>
<tr><td>617</td>
<td class="normal"> * <code>
</td></tr>
<tr><td>618</td>
<td class="normal"> * $q = new Doctrine_Query();
</td></tr>
<tr><td>619</td>
<td class="normal"> * $q->select('u.*')
</td></tr>
<tr><td>620</td>
<td class="normal"> * ->from('User u')
</td></tr>
<tr><td>621</td>
<td class="normal"> * ->where($q->expr->isNull('id'));
</td></tr>
<tr><td>622</td>
<td class="normal"> * </code>
</td></tr>
<tr><td>623</td>
<td class="normal"> *
</td></tr>
<tr><td>624</td>
<td class="normal"> * @param string $expression the expression that should be compared to null
</td></tr>
<tr><td>625</td>
<td class="normal"> * @return string logical expression
</td></tr>
<tr><td>626</td>
<td class="normal"> */
</td></tr>
<tr><td>627</td>
<td class="normal"> public function isNull($expression)
</td></tr>
<tr><td>628</td>
<td class="normal"> {
</td></tr>
<tr><td>629</td>
<td class="covered"> $expression = $this->getIdentifier($expression);
</td></tr>
<tr><td>630</td>
<td class="covered"> return $expression . ' IS NULL';
</td></tr>
<tr><td>631</td>
<td class="orange"> }
</td></tr>
<tr><td>632</td>
<td class="normal"> /**
</td></tr>
<tr><td>633</td>
<td class="normal"> * Returns SQL that checks if a expression is not null.
</td></tr>
<tr><td>634</td>
<td class="normal"> *
</td></tr>
<tr><td>635</td>
<td class="normal"> * Example:
</td></tr>
<tr><td>636</td>
<td class="normal"> * <code>
</td></tr>
<tr><td>637</td>
<td class="normal"> * $q = new Doctrine_Query();
</td></tr>
<tr><td>638</td>
<td class="normal"> * $q->select('u.*')
</td></tr>
<tr><td>639</td>
<td class="normal"> * ->from('User u')
</td></tr>
<tr><td>640</td>
<td class="normal"> * ->where($q->expr->isNotNull('id'));
</td></tr>
<tr><td>641</td>
<td class="normal"> * </code>
</td></tr>
<tr><td>642</td>
<td class="normal"> *
</td></tr>
<tr><td>643</td>
<td class="normal"> * @param string $expression the expression that should be compared to null
</td></tr>
<tr><td>644</td>
<td class="normal"> * @return string logical expression
</td></tr>
<tr><td>645</td>
<td class="normal"> */
</td></tr>
<tr><td>646</td>
<td class="normal"> public function isNotNull($expression)
</td></tr>
<tr><td>647</td>
<td class="normal"> {
</td></tr>
<tr><td>648</td>
<td class="covered"> $expression = $this->getIdentifier($expression);
</td></tr>
<tr><td>649</td>
<td class="covered"> return $expression . ' IS NOT NULL';
</td></tr>
<tr><td>650</td>
<td class="orange"> }
</td></tr>
<tr><td>651</td>
<td class="normal"> /**
</td></tr>
<tr><td>652</td>
<td class="normal"> * Returns SQL that checks if an expression evaluates to a value between
</td></tr>
<tr><td>653</td>
<td class="normal"> * two values.
</td></tr>
<tr><td>654</td>
<td class="normal"> *
</td></tr>
<tr><td>655</td>
<td class="normal"> * The parameter $expression is checked if it is between $value1 and $value2.
</td></tr>
<tr><td>656</td>
<td class="normal"> *
</td></tr>
<tr><td>657</td>
<td class="normal"> * Note: There is a slight difference in the way BETWEEN works on some databases.
</td></tr>
<tr><td>658</td>
<td class="normal"> * http://www.w3schools.com/sql/sql_between.asp. If you want complete database
</td></tr>
<tr><td>659</td>
<td class="normal"> * independence you should avoid using between().
</td></tr>
<tr><td>660</td>
<td class="normal"> *
</td></tr>
<tr><td>661</td>
<td class="normal"> * Example:
</td></tr>
<tr><td>662</td>
<td class="normal"> * <code>
</td></tr>
<tr><td>663</td>
<td class="normal"> * $q = new Doctrine_Query();
</td></tr>
<tr><td>664</td>
<td class="normal"> * $q->select('u.*')
</td></tr>
<tr><td>665</td>
<td class="normal"> * ->from('User u')
</td></tr>
<tr><td>666</td>
<td class="normal"> * ->where($q->expr->between('id', 1, 5));
</td></tr>
<tr><td>667</td>
<td class="normal"> * </code>
</td></tr>
<tr><td>668</td>
<td class="normal"> *
</td></tr>
<tr><td>669</td>
<td class="normal"> * @param string $expression the value to compare to
</td></tr>
<tr><td>670</td>
<td class="normal"> * @param string $value1 the lower value to compare with
</td></tr>
<tr><td>671</td>
<td class="normal"> * @param string $value2 the higher value to compare with
</td></tr>
<tr><td>672</td>
<td class="normal"> * @return string logical expression
</td></tr>
<tr><td>673</td>
<td class="normal"> */
</td></tr>
<tr><td>674</td>
<td class="normal"> public function between($expression, $value1, $value2)
</td></tr>
<tr><td>675</td>
<td class="normal"> {
</td></tr>
<tr><td>676</td>
<td class="covered"> $expression = $this->getIdentifier($expression);
</td></tr>
<tr><td>677</td>
<td class="covered"> $value1 = $this->getIdentifier($value1);
</td></tr>
<tr><td>678</td>
<td class="covered"> $value2 = $this->getIdentifier($value2);
</td></tr>
<tr><td>679</td>
<td class="covered"> return $expression . ' BETWEEN ' .$value1 . ' AND ' . $value2;
</td></tr>
<tr><td>680</td>
<td class="orange"> }
</td></tr>
<tr><td>681</td>
<td class="normal"> /**
</td></tr>
<tr><td>682</td>
<td class="normal"> * Returns global unique identifier
</td></tr>
<tr><td>683</td>
<td class="normal"> *
</td></tr>
<tr><td>684</td>
<td class="normal"> * @return string to get global unique identifier
</td></tr>
<tr><td>685</td>
<td class="normal"> */
</td></tr>
<tr><td>686</td>
<td class="normal"> public function guid()
</td></tr>
<tr><td>687</td>
<td class="normal"> {
</td></tr>
<tr><td>688</td>
<td class="red"> throw new Doctrine_Expression_Exception('method not implemented');
</td></tr>
<tr><td>689</td>
<td class="orange"> }
</td></tr>
<tr><td>690</td>
<td class="normal"> /**
</td></tr>
<tr><td>691</td>
<td class="normal"> * returns arcus cosine SQL string
</td></tr>
<tr><td>692</td>
<td class="normal"> *
</td></tr>
<tr><td>693</td>
<td class="normal"> * @return string
</td></tr>
<tr><td>694</td>
<td class="normal"> */
</td></tr>
<tr><td>695</td>
<td class="normal"> public function acos($value)
</td></tr>
<tr><td>696</td>
<td class="normal"> {
</td></tr>
<tr><td>697</td>
<td class="covered"> return 'ACOS(' . $value . ')';
</td></tr>
<tr><td>698</td>
<td class="orange"> }
</td></tr>
<tr><td>699</td>
<td class="normal"> /**
</td></tr>
<tr><td>700</td>
<td class="normal"> * __call
</td></tr>
<tr><td>701</td>
<td class="normal"> *
</td></tr>
<tr><td>702</td>
<td class="normal"> * for all native RDBMS functions the function name itself is returned
</td></tr>
<tr><td>703</td>
<td class="normal"> */
</td></tr>
<tr><td>704</td>
<td class="normal"> public function __call($m, $a)
</td></tr>
<tr><td>705</td>
<td class="normal"> {
</td></tr>
<tr><td>706</td>
<td class="covered"> if ($this->conn->getAttribute(Doctrine::ATTR_PORTABILITY) & Doctrine::PORTABILITY_EXPR) {
</td></tr>
<tr><td>707</td>
<td class="covered"> throw new Doctrine_Expression_Exception('Unknown expression ' . $m);
</td></tr>
<tr><td>708</td>
<td class="orange"> }
</td></tr>
<tr><td>709</td>
<td class="covered"> return $m . '(' . implode(', ', $a) . ')';
</td></tr>
<tr><td>710</td>
<td class="orange"> }
</td></tr>
<tr><td>711</td>
<td class="covered">}</td></tr>
</table></body></html>