Auto-generated commit

Author: stdlib-bot

README.md

@@ -84,6 +84,15 @@ var out = countSameValue( x, 1 );
 // returns 2
 ```
 
+In contrast to an implementation using the strict equality operator `===`, the function distinguishes between `+0` and `-0` and treats `NaNs` as the same value.
+
+```javascript
+var x = [ NaN, NaN, NaN ];
+
+var out = countSameValue( x, NaN );
+// returns 3
+```
+
 </section>
 
 <!-- /.usage -->
@@ -92,6 +101,10 @@ var out = countSameValue( x, 1 );
 
 <section class="notes">
 
+## Notes
+
+-   The function uses the [SameValue Algorithm][@stdlib/assert/is-same-value] as specified in ECMAScript 5.
+
 </section>
 
 <!-- /.notes -->
@@ -209,6 +222,8 @@ Copyright &copy; 2016-2024. The Stdlib [Authors][stdlib-authors].
 
 [stdlib-license]: https://raw.githubusercontent.com/stdlib-js/array-base-count-same-value/main/LICENSE
 
+[@stdlib/assert/is-same-value]: https://github.com/stdlib-js/assert-is-same-value
+
 </section>
 
 <!-- /.links -->

dist/index.js.map

@@ -3,6 +3,8 @@
     Counts the number of elements in an array that are equal to a specified
     value.
 
+    The function treats `-0` and `+0` as distinct and `NaNs` as the same.
+
     Parameters
     ----------
     x: ArrayLikeObject

docs/repl.txt

@@ -25,6 +25,13 @@ import { Collection } from '@stdlib/types/array';
 /**
 * Counts the number of elements in an array that are equal to a specified value.
 *
+* ## Notes
+*
+* -   The function uses the [SameValue Algorithm][ecma-262-same-value-algorithm], as specified in ECMAScript 5.
+* -   In contrast to the strict equality operator `===`, `-0` and `+0` are distinguishable and `NaNs` are the same.
+*
+* [ecma-262-same-value-algorithm]: http://ecma-international.org/ecma-262/5.1/#sec-9.12
+*
 * @param x - input array
 * @param value - search value
 * @returns number of elements that are equal to a specified value

docs/types/index.d.ts

@@ -138,6 +138,13 @@ function complex( x, value ) {
 /**
 * Counts the number of elements in an array that are equal to a specified value.
 *
+* ## Notes
+*
+* -   The function uses the [SameValue Algorithm][ecma-262-same-value-algorithm], as specified in ECMAScript 5.
+* -   In contrast to the strict equality operator `===`, `-0` and `+0` are distinguishable and `NaNs` are the same.
+*
+* [ecma-262-same-value-algorithm]: http://ecma-international.org/ecma-262/5.1/#sec-9.12
+*
 * @param {Collection} x - input array
 * @param {*} value - search value
 * @returns {NonNegativeInteger} number of elements that are equal to a specified value