jQuery.inArray(): Note that inArray campares values strictly. Closes jquery#470

Author: baamenabar

entries/jQuery.inArray.xml

@@ -16,7 +16,9 @@
   <desc>Search for a specified value within an array and return its index (or -1 if not found).</desc>
   <longdesc>
     <p>The <code>$.inArray()</code> method is similar to JavaScript's native <code>.indexOf()</code> method in that it returns -1 when it doesn't find a match. If the first element within the array matches <code>value</code>, <code>$.inArray()</code> returns 0.</p>
-    <p>Because JavaScript treats 0 as loosely equal to false (i.e. 0 == false, but 0 !== false), if we're checking for the presence of <code>value</code> within <code>array</code>, we need to check if it's not equal to (or greater than) -1.</p>
+    <p>Because JavaScript treats 0 as loosely equal to false (i.e. 0 == false, but 0 !== false), to check for the presence of <code>value</code> within <code>array</code>, you need to check if it's not equal to (or greater than) -1.</p>
+    <p>The comparison between values is strict. The following will return <code>-1</code> (not found) because a number is being searched in an array of strings:</p>
+    <pre><code>$.inArray( 5 + 5, [ "8", "9", "10", 10 + "" ] );</code></pre>
   </longdesc>
   <example>
     <desc>Report the index of some elements in the array.</desc>