Press n or j to go to the next uncovered block, b, p or k for the previous block.
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 | 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 56x 56x 56x 56x 56x 56x 8x 8x 56x 1x 1x 56x 19x 10x 10x 9x 19x 2x 2x 56x 28x 28x 56x 21x 9x 9x 12x 12x 16x 56x 1x 1x 1x 1x 1x | /**
* @license Apache-2.0
*
* Copyright (c) 2018 The Stdlib Authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
'use strict';
// MODULES //
var isCollection = require( '@stdlib/assert/is-collection' );
var isInteger = require( '@stdlib/assert/is-integer' ).isPrimitive;
var isString = require( '@stdlib/assert/is-string' ).isPrimitive;
var indexOfSameValue = require( '@stdlib/array/base/index-of-same-value' );
var format = require( '@stdlib/string/format' );
// MAIN //
/**
* Tests if an array-like value contains a search value.
*
* @param {(Collection|string)} value - input value
* @param {*} searchValue - search value
* @param {integer} [position=0] - position at which to start searching for `searchValue`
* @throws {TypeError} first argument must be array-like
* @throws {Error} must provide a search value
* @throws {TypeError} second argument must be a string when the first argument is a string
* @throws {TypeError} third argument must be an integer
* @returns {boolean} boolean indicating whether one value contains another
*
* @example
* var bool = contains( 'last man standing', 'stand' );
* // returns true
*
* @example
* var bool = contains( [ 1, 2, 3, 4 ], 2 );
* // returns true
*
* @example
* var bool = contains( 'presidential election', 'president' );
* // returns true
*
* @example
* var bool = contains( [ NaN, 2, 3, 4 ], NaN );
* // returns true
*
* @example
* var bool = contains( 'javaScript', 'js' );
* // returns false
*
* @example
* var bool = contains( [ 1, 2, 3, {} ], {} );
* // returns false
*
* @example
* var bool = contains( 'Hidden Treasures', '' );
* // returns true
*/
function contains( value, searchValue, position ) {
var isStr;
var pos;
isStr = isString( value );
if ( !isCollection( value ) && !isStr ) {
throw new TypeError( format( 'invalid argument. First argument must be array-like. Value: `%s`.', value ) );
}
if ( arguments.length < 2 ) {
throw new Error( 'insufficient arguments. Must provide a search value.' );
}
if ( arguments.length > 2 ) {
if ( !isInteger( position ) ) {
throw new TypeError( format( 'invalid argument. Third argument must be an integer. Value: `%s`.', position ) );
}
pos = position;
if ( pos < 0 ) {
pos = 0;
}
} else {
pos = 0;
}
if ( isStr ) {
if ( !isString( searchValue ) ) {
throw new TypeError( format( 'invalid argument. Second argument must be a string. Value: `%s`.', searchValue ) );
}
return value.indexOf( searchValue, pos ) !== -1;
}
return indexOfSameValue( value, searchValue, pos ) !== -1;
}
// EXPORTS //
module.exports = contains;
|