Объяснение функции substrahead.js substringMatcher

Question

Я просто занимаюсь некоторыми исследованиями в Typeahead.js, и это действительно крутая библиотека. Мне удалось получить базовый пример работы с благодарностью к документации, которая тоже очень хороша.

Однако я пытаюсь понять, что делает следующий блок кода?

var substringMatcher = function(strs) { 
    return function findMatches(q, cb) { 
    var matches, substringRegex; 

    // an array that will be populated with substring matches 
    matches = []; 

    // regex used to determine if a string contains the substring `q` 
    substrRegex = new RegExp(q, 'i'); 

    // iterate through the pool of strings and for any string that 
    // contains the substring `q`, add it to the `matches` array 
    $.each(strs, function(i, str) { 
     if (substrRegex.test(str)) { 
     matches.push(str); 
     } 
    }); 

    cb(matches); 
    }; 
}; 

В примере она передается в при инициализации машинописного в качестве опции source. Я могу понять, что он принимает входные данные из текстового поля и сравнивает его с набором данных, но я немного смущен относительно того, что такое q и cb?

Answer 1

q - значение, которое нужно искать. Это передается в соответствие регулярному выражению, а поиск - case-insensitivie («i» param)

- это функция обратного вызова, которая возвращает совпадения, найденные при поиске.

findMatches - это анонимная функция, которая используется как реализация функции substringMatcher.