test.js

Jump To … +

main.js separate.js single.js web-apg-api.js main.js web-conv-api.js ast.js csv.js dangling-else.js display.js flags.js float.js limits.js main.js multiline-mode.js recursive.js replace.js rules.js split.js test.js trace.js udt.js unicode.js web-email.js word-boundaries.js main.js phone-number.js web-main.js web-phone-number.js main.js phone-number.js setup.js translate.js xml.js branch-fail-grammar.js main.js parent-mode-grammar.js setup.js universal-mode-grammar.js colors-app.js colors-callbacks.js colors.js main.js more-app.js more-setup.js more.js ast-callbacks.js bad-input.js basic.js ini-file.js main.js parser-callbacks.js setup.js trace.js anbncn.js and.js c-comment.js compound.js main.js nested.js not.js setup.js boundaries-grammar.js boundaries.js comment-grammar.js comment.js main.js negative-grammar.js negative.js positive-grammar.js positive.js setup.js main.js odata-grammar.js run.js setup.js area-code.js lookaround.js main.js phone-number.js setup.js simple.js all-operators.js default.js fancy-number.js limited-lines.js main.js select-operators.js select-rules.js setup.js main.js minimal.js parent-u.js parent.js phone-number.js setup.js stats.js trace.js universal-u.js universal.js callbacks.js grammar.js main.js parser.js writeHtml.js LICENSE.md README.md index.md

test.js

/*  *************************************************************************************
 *   copyright: Copyright (c) 2021 Lowell D. Thomas, all rights reserved
 *     license: BSD-2-Clause (https://opensource.org/licenses/BSD-2-Clause)
 *   ********************************************************************************* */

Just for completeness, this module demonstrates the test() function. It simply returns true if the phrase is found or false otherwise. It ignores the u and d flags but honors the g and y flags.

(function test() {
  try {
    const { apgExp: ApgExp } = require('apg-js');

    let grammar = '';
    let exp;
    let flags;
    let result;
    let str;
    let count;

Demonstrate with some simple tests.

    grammar += 'rule = "abc"\n';
    exp = new ApgExp(grammar, flags);
    console.log();
    console.log('Demonstrate the test function.');
    console.log();
    console.log(`grammar: ${exp.source}`);
    str = 'abc';
    result = exp.test(str);
    console.log(`  flags: '${exp.flags}'`);
    console.log(`  input: ${str}`);
    console.log(`   test: ${result}`);
    str = '---abc---';
    result = exp.test(str);
    console.log();
    console.log(`  flags: '${exp.flags}'`);
    console.log(`  input: ${str}`);
    console.log(`   test: ${result}`);
    str = '---a-bc---';
    result = exp.test(str);
    console.log();
    console.log(`  flags: '${exp.flags}'`);
    console.log(`  input: ${str}`);
    console.log(`   test: ${result}`);

Demonstrate with the u and d flags.

    flags = 'ud';
    str = 'xyzabc>>>';
    exp = new ApgExp(grammar, flags);
    result = exp.test(str);
    console.log();
    console.log('       : test() ignores the u and d flags');
    console.log(`  flags: '${exp.flags}'`);
    console.log(`  input: ${str}`);
    console.log(`   test: ${result}`);
    str = '---a-bc---';
    result = exp.test(str);
    console.log();
    console.log(`  flags: '${exp.flags}'`);
    console.log(`  input: ${str}`);
    console.log(`   test: ${result}`);

Demonstrate with the g flag.

    flags = 'g';
    str = '---abc---abc---';
    exp = new ApgExp(grammar, flags);
    count = 0;
    const TRUE = true;
    while (TRUE) {
      result = exp.test(str);
      if (result === false) {
        break;
      }
      count += 1;
    }
    console.log();
    console.log('       : test() honors the g flag');
    console.log(`  flags: '${exp.flags}'`);
    console.log(`  input: ${str}`);
    console.log(`   test: ${count > 0}`);
    console.log(`# found: ${count}`);

Demonstrate with the y flag.

    flags = 'y';
    str = '---abc---abc---';
    exp = new ApgExp(grammar, flags);
    count = 0;
    while (TRUE) {
      result = exp.test(str);
      if (result === false) {
        break;
      }
      count += 1;
    }
    console.log();
    console.log('       : test() honors the y flag');
    console.log(`  flags: '${exp.flags}'`);
    console.log(`  input: ${str}`);
    console.log(`   test: ${count > 0}`);
    console.log(`# found: ${count}`);
    str = 'abcabc';
    count = 0;
    while (TRUE) {
      result = exp.test(str);
      if (result === false) {
        break;
      }
      count += 1;
    }
    console.log();
    console.log(`  flags: '${exp.flags}'`);
    console.log(`  input: ${str}`);
    console.log(`   test: ${count > 0}`);
    console.log(`# found: ${count}`);
  } catch (e) {
    console.log(`EXCEPTION: ${e.message}`);
  }
})();