added split filter with test

Author: marchrius

src/_filter/string/split.js

@@ -0,0 +1,40 @@
+/**
+ * @ngdoc filter
+ * @name split
+ * @kind function
+ *
+ * @description
+ * split a string by a provided delimiter (none '' by default) and skip first n-delimiters
+ */
+angular.module('a8m.split', [])
+  .filter('split', function () {
+    function escapeRegExp(str) {
+      return str.replace(/[\-\[\]\/\{\}\(\)\*\+\?\.\\\^\$\|]/g, "\\$&");
+    }
+
+    return function (input, delimiter, skip) {
+      var _regexp, _matches, _splitted, _temp;
+
+      if (isUndefined(input) || !isString(input)) {
+        return null;
+      }
+      if (isUndefined(delimiter)) delimiter = '';
+      if (isNaN(skip)) skip = 0;
+
+      _regexp = new RegExp(escapeRegExp(delimiter), 'g');
+      _matches = input.match(_regexp);
+      
+      if (isNull(_matches) || skip >= _matches.length) {
+        return [input];
+      }
+
+      if (skip === 0) return input.split(delimiter);
+      
+      _splitted = input.split(delimiter);
+      _temp = _splitted.splice(0, skip + 1);
+      _splitted.unshift(_temp.join(delimiter));
+    
+      return _splitted;
+    };
+  })
+;

src/filters.js

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

test/spec/filter/string/split.js

@@ -0,0 +1,28 @@
+'use strict';
+
+describe('splitFilter', function () {
+
+  var filter, sentence = "Today is a beautiful and sunny day!";
+
+  beforeEach(module('a8m.split'));
+
+  beforeEach(inject(function ($filter) {
+    filter = $filter('split');
+  }));
+
+  it('should test a string with given pattern', function() {
+
+    expect(filter(sentence, ' ', 3)).toEqual(['Today is a beautiful', 'and', 'sunny', 'day!']);
+    expect(angular.equals(filter(sentence, '.'), [sentence])).toBeTruthy();
+    expect(filter(sentence, ' ')).toEqual(['Today', 'is', 'a', 'beautiful', 'and', 'sunny', 'day!']);
+
+  });
+
+  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);
+  });
+
+});