npm.io
0.1.1 • Published 7 years ago

@pelevesque/has_prohibited_substring_at_sums

Licence
MIT
Version
0.1.1
Deps
1
Size
33 kB
Vulns
0
Weekly
0

Build Status Coverage Status JavaScript Style Guide

has_prohibited_substring_at_sums

Checks if a string has a prohibited substring after given sums.

https://github.com/pelevesque/has_prohibited_substring_at_indexes
https://github.com/pelevesque/has_required_substrings_at_sums
https://github.com/pelevesque/has_required_substrings_at_indexes

Node Repository

https://www.npmjs.com/package/@pelevesque/has_prohibited_substring_at_sums

Installation

npm install @pelevesque/has_prohibited_substring_at_sums

Tests

Standard Style & Unit Tests

npm test

Unit Tests & Coverage

npm run cover

Usage

Parameters
str                  (required)
prohibitedSubstrings (required)
options              (optional) default = { substringsToDigits = null, sumPlainDigits = true,  allowSubstringBleeding = false }
Requiring
const hasProhibitedSubstringAtSums = require('@pelevesque/has_prohibited_substring_at_sums')
Basic Usage

@see https://github.com/pelevesque/sum-digits to understand how the sum is calculated.

prohibitedSubstrings is an object of sum -> substring pairs. true is returned if at least one substring is found directly following its associated sums.

const str = '123a45'
const prohibitedSubstrings = { 1: 'a' }
const result = hasProhibitedSubstringAtSums(str, prohibitedSubstrings)
// result === false
const str = '123a45'
const prohibitedSubstrings = { 6: 'a' }
const result = hasProhibitedSubstringAtSums(str, prohibitedSubstrings)
// result === true
// only one substring needs to match
const str = '123man45dinosaur'
const prohibitedSubstrings = { 6: 'man', 150: 'dinosaur' }
const result = hasProhibitedSubstringAtSums(str, prohibitedSubstrings)
// result === true
// the substring must come directly after the sum (here b is directly after the sum, not a)
const str = '123ba45'
const prohibitedSubstrings = { 6: 'a' }
const result = hasProhibitedSubstringAtSums(str, prohibitedSubstrings)
// result === false
SubstringsToDigits

You can use the substringsToDigits object to give numeric values to substrings so that they are counted during summing.

const str = '123!$$a'
const prohibitedSubstrings = { 15: 'a' }
const substringsToDigits = { '!': 4, '$
SumPlainDigits Flag

You can set the sumPlainDigits flag to false if you only want to sum substringsToDigits.

In the following example, 1, 2, and 3 are not summed.

const str = '123!a'
const prohibitedSubstrings = { 4: 'a' }
const substringsToDigits = { '!': 4 }
const sumPlainDigits = false
const result = hasProhibitedSubstringAtSums(str, prohibitedSubstrings, {
  substringsToDigits: substringsToDigits,
  sumPlainDigits: sumPlainDigits
})
// result === true
AllowSubstringBleeding Flag

The allowSubstringBleeding flag is false by default. It it used when you want to allow the last substring to be incomplete if the string is too short. In the following example, the last substring canal starts at the correct index, but remains incomplete since the string ends. Normally this would return false. With allowSubstringBleeding set to true, it returns true.

const str = '123can'
const prohibitedSubstrings = { 6: 'canal' }
const allowSubstringBleeding = true
const result = hasProhibitedSubstringAtSums(str, prohibitedSubstrings, {
  allowSubstringBleeding: allowSubstringBleeding
})
// result === true
: 5 } const result = hasProhibitedSubstringAtSums(str, prohibitedSubstrings, { substringsToDigits: substringsToDigits }) // result === true
SumPlainDigits Flag

You can set the __INLINE_CODE_6__ flag to false if you only want to sum __INLINE_CODE_7__.

In the following example, __INLINE_CODE_8__, __INLINE_CODE_9__, and __INLINE_CODE_10__ are not summed.

__CODE_BLOCK_7__
AllowSubstringBleeding Flag

The __INLINE_CODE_11__ flag is __INLINE_CODE_12__ by default. It it used when you want to allow the last substring to be incomplete if the string is too short. In the following example, the last substring __INLINE_CODE_13__ starts at the correct index, but remains incomplete since the string ends. Normally this would return __INLINE_CODE_14__. With __INLINE_CODE_15__ set to __INLINE_CODE_16__, it returns __INLINE_CODE_17__.

__CODE_BLOCK_8__

Keywords