Searching

import {
  contains, containsAll, containsAny, count, between, betweenAll,
} from '@ppabari/strio/str';

contains

contains(str: string, substring: string, caseSensitive?: boolean): boolean

caseSensitive defaults to true.

contains('Hello World', 'World');        // → true
contains('Hello World', 'world');        // → false
contains('Hello World', 'world', false); // → true

containsAll

containsAll(str: string, substrings: string[], caseSensitive?: boolean): boolean

containsAll('the quick fox', ['the', 'fox']); // → true
containsAll('the quick fox', ['the', 'dog']); // → false

containsAny

containsAny(str: string, substrings: string[], caseSensitive?: boolean): boolean

containsAny('the quick fox', ['cat', 'fox']); // → true
containsAny('the quick fox', ['cat', 'dog']); // → false

count

count(str: string, substring: string, overlapping?: boolean): number

Count occurrences. Pass overlapping = true to count overlapping matches.

count('banana', 'a');      // → 3
count('aaaa', 'aa');       // → 2
count('aaaa', 'aa', true); // → 3

between

between(str: string, start: string, end: string): string

Extract the first substring between start and end. Returns '' if not found.

between('[a][b]', '[', ']');     // → 'a'
between('key=value;', '=', ';'); // → 'value'

betweenAll

betweenAll(str: string, start: string, end: string): string[]

Extract every non-overlapping substring between the delimiters.

betweenAll('[a][b][c]', '[', ']'); // → ['a', 'b', 'c']