match.js 1.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445
  1. var utils = require('../utils')
  2. , nodes = require('../nodes');
  3. var VALID_FLAGS = 'igm';
  4. /**
  5. * retrieves the matches when matching a `val`(string)
  6. * against a `pattern`(regular expression).
  7. *
  8. * Examples:
  9. * $regex = '^(height|width)?([<>=]{1,})(.*)'
  10. *
  11. * match($regex,'height>=sm')
  12. * // => ('height>=sm' 'height' '>=' 'sm')
  13. * // => also truthy
  14. *
  15. * match($regex, 'lorem ipsum')
  16. * // => null
  17. *
  18. * @param {String} pattern
  19. * @param {String|Ident} val
  20. * @param {String|Ident} [flags='']
  21. * @return {String|Null}
  22. * @api public
  23. */
  24. function match(pattern, val, flags){
  25. utils.assertType(pattern, 'string', 'pattern');
  26. utils.assertString(val, 'val');
  27. var re = new RegExp(pattern.val, validateFlags(flags) ? flags.string : '');
  28. return val.string.match(re);
  29. }
  30. match.params = ['pattern', 'val', 'flags'];
  31. module.exports = match;
  32. function validateFlags(flags) {
  33. flags = flags && flags.string;
  34. if (flags) {
  35. return flags.split('').every(function(flag) {
  36. return ~VALID_FLAGS.indexOf(flag);
  37. });
  38. }
  39. return false;
  40. }