wsemi/src/binstr.mjs

A support package for web developer.

import each from 'lodash/each'
import isstr from './isstr.mjs'
import isestr from './isestr.mjs'
import isearr from './isearr.mjs'


/**
 * 判斷字串s是否「任一出現於、全部包含於」字串陣列keys內元素
 *
 * Unit Test: {@link https://github.com/yuda-lyu/wsemi/blob/master/test/binstr.test.mjs Github}
 * @memberOf wsemi
 * @param {String} s 輸入要判斷的字串
 * @param {Array|String} keys 輸入字串陣列或字串
 * @param {String} mode 輸入模式，可選'anyone'與'all'，預設為'anyone'
 * @returns {Boolean} 回傳判斷布林值
 * @example
 *
 * console.log(binstr('1.25abc', 'ab'))
 * // => true
 *
 */
function binstr(s, keys, mode = 'anyone') {

    //check
    if (!isestr(s)) {
        return false
    }

    //check mode
    if (mode !== 'anyone' && mode !== 'all') {
        return false
    }

    //keys為字串不是陣列時自動轉陣列
    if (isstr(keys)) {
        if (isestr(keys)) {
            keys = [keys]
        }
        else {
            return false
        }
    }

    //keys需為有效陣列
    if (!isearr(keys)) {
        return false
    }

    //check keys內都需要為字串
    let bNotStr = false
    each(keys, function(key) {
        if (!isestr(key)) {
            bNotStr = true
        }
    })
    if (bNotStr) {
        return false
    }

    //instr
    function instr(s, key) {
        return s.indexOf(key)
    }

    //判斷是否任一出現、全部包含keys元素
    let n = 0
    each(keys, function(key) {
        if (instr(s, key) !== -1) {
            n++
        }
    })

    if (mode === 'anyone') {
        return n > 0
    }
    else if (mode === 'all') {
        return n === keys.length
    }
    return false
}


export default binstr