Add match string feature

README.md

@@ -51,6 +51,7 @@
   - [stripTags](#striptags)
   - [stringular](#stringular)
   - [test](#test)
+  - [match](#match)
   - [trim](#trim)
   - [ltrim](#ltrim)
   - [rtrim](#rtrim)
@@ -1086,8 +1087,18 @@ Test if a string match a pattern<br/>
 **Usage:** ```string | test: pattern: flag[optional]```
 ```html
 <p>{{ '15/12/2003' | test: '^[0-9]{2}[/]{1}[0-9]{2}[/]{1}[0-9]{4}$': 'i' }}</p>
+<p>{{ '0123456' | test: '\\D': 'i' }}</p>
 <!--result:
 true
+true
+```
+###match
+Return an array of matched element in a string<br/>
+**Usage:** ```string | match: pattern: flag[optional]```
+```html
+<p>{{ '15/12/2003' | match: '\\d+': 'g' }}</p>
+<!--result:
+['15', '12', '2003']
 ```
 #Math
 

dist/angular-filter.js

@@ -1,6 +1,6 @@
 /**
  * Bunch of useful filters for angularJS(with no external dependencies!)
- * @version v0.5.3 - 2015-02-18 * @link https://github.com/a8m/angular-filter
+ * @version v0.5.3 - 2015-02-19 * @link https://github.com/a8m/angular-filter
  * @author Ariel Mashraki <ariel@mashraki.co.il>
  * @license MIT License, http://www.opensource.org/licenses/MIT
  */
@@ -1729,6 +1729,27 @@ angular.module('a8m.ltrim', [])
     }
   });
 
+/**
+ * @ngdoc filter
+ * @name match
+ * @kind function
+ *
+ * @description
+ * Return the matched pattern in a string.
+ */
+angular.module('a8m.match', [])
+
+  .filter('match', function () {
+    return function (input, pattern, flag) {
+
+      var reg = new RegExp(pattern, flag);
+
+      return isString(input)
+        ? input.match(reg)
+        : null;
+    }
+  });
+
 /**
  * @ngdoc filter
  * @name repeat
@@ -2167,6 +2188,7 @@ angular.module('angular.filter', [
   'a8m.rtrim',
   'a8m.repeat',
   'a8m.test',
+  'a8m.match',
 
   'a8m.to-array',
   'a8m.concat',

src/_filter/string/match.js

@@ -0,0 +1,20 @@
+/**
+ * @ngdoc filter
+ * @name match
+ * @kind function
+ *
+ * @description
+ * Return the matched pattern in a string.
+ */
+angular.module('a8m.match', [])
+
+  .filter('match', function () {
+    return function (input, pattern, flag) {
+
+      var reg = new RegExp(pattern, flag);
+
+      return isString(input)
+        ? input.match(reg)
+        : null;
+    }
+  });

src/filters.js

@@ -23,6 +23,7 @@ angular.module('angular.filter', [
   'a8m.rtrim',
   'a8m.repeat',
   'a8m.test',
+  'a8m.match',
 
   'a8m.to-array',
   'a8m.concat',

test/spec/filter/string/match.js

@@ -0,0 +1,28 @@
+'use strict';
+
+describe('matchFilter', function () {
+
+  var filter;
+
+  beforeEach(module('a8m.match'));
+
+  beforeEach(inject(function ($filter) {
+    filter = $filter('match');
+  }));
+
+  it('should test a string with given pattern', function() {
+
+    expect(filter('15/12/2003', '\\d+', 'g')).toEqual(['15', '12', '2003']);
+    expect(angular.equals(filter('foobarbaz', '[a-z]{3}'), ['foo'])).toBeTruthy();
+    expect(filter('foobarbaz', '[a-z]{3}', 'g')).toEqual(['foo', 'bar', 'baz']);
+
+  });
+
+  it('should get a !string and return null', function() {
+    expect(filter({})).toEqual(null);
+    expect(filter([])).toEqual(null);
+    expect(filter(1)).toEqual(null);
+    expect(filter(!1)).toBeFalsy(null);
+  });
+
+});

test/spec/filter/string/test.js

@@ -16,7 +16,8 @@ describe('testFilter', function () {
     expect(filter('foobarbaz', '^[a-z]{3,}$')).toEqual(true);
     expect(filter('FOOBARBAZ', '^[a-z]{3,}$', 'i')).toEqual(true);
     expect(filter('FOOBARBAZ', '^[a-z]{3,}$')).toEqual(false);
-    expect(filter('foobarbaz', '\W')).toEqual(false);
+    expect(filter('foobarbaz', '\\W')).toEqual(false);
+    expect(filter('foobarbaz', '\\w')).toEqual(true);
     expect(filter('1a/bb/2003', '^[0-9]{2}[/]{1}[0-9]{2}[/]{1}[0-9]{4}$', 'i')).toEqual(false);
 
   });