Add match string filter (cf #68)

Author: ctjhoa

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
 

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);
+  });
+
+});