jQuery.inArray()S2C Home « Utilities « jQuery.inArray()

• <<    jQuery.grep()
• jQuery.makeArray()     >>

Array value present.

Description

The jQuery.inArray() jQuery General utility method, returns a number denoting the index position within the array containing the specified value.

Shorthand version $.inArray()

• The jQuery.inArray() jQuery General utility method will return the -1 if the value isn't found in the array

Syntax

Parameters

Return

An Number object.

jQuery.inArray( value, array [, fromIndex] ) ExamplesTop

Return a number denoting the index position within the array containing the specified value.

In the example below when we press the button the first time we create an array and then output a message showing the index position of the item with a value of 'tie using the $.inArray() general utility method. This outputs a message showing the index as 2. We then output another message showing the index position of the item with a value of 'tie using the $.inArray() general utility method. This outputs a message showing the index as -1. This is because the second time we set the fromIndex parameter to '3' and so the search starts from that index. The 'tie' item is in position 2 (index starts at 0) and therefore we get a value of -1 returned, which equates to 'not found'

$(function(){
  $('#btn18').one('click', function(){
    var arr0 = [ 'belt', 'boots', 'tie', 'bracers', 'shirt' ];
    $('#div14').append('index of tie in array is: ' +  $.inArray( 'tie', arr0 ) + '<br>');
    $('#div14').append('index of tie in array is: ' +  $.inArray( 'tie', arr0, 3 ));
  });
});

• <<    jQuery.grep()
• jQuery.makeArray()     >>