match


RegExp → String → [String | Undefined]

Parameters

  • rxA regular expression.
  • strThe string to match against

Returns Array The list of matches or empty array.

Added in v0.1.0

Tests a regular expression against a String. Note that this function will return an empty array when there are no matches. This differs from String.prototype.match which returns null when there are no matches.

See also test.

  1. R.match(/([a-z]a)/g, 'bananas'); //=> ['ba', 'na', 'na']
  2. R.match(/a/, 'b'); //=> []
  3. R.match(/a/, null); //=> TypeError: null does not have a method named "match"

split


(String | RegExp) → String → [String]

Parameters

  • sepThe pattern.
  • strThe string to separate into an array.

Returns Array The array of strings from str separated by sep.

Added in v0.1.0

Splits a string into an array of strings based on the given separator.

See also join.

  1. const pathComponents = R.split('/');
  2. R.tail(pathComponents('/usr/local/bin/node')); //=> ['usr', 'local', 'bin', 'node']
  3. R.split('.', 'a.b.c.xyz.d'); //=> ['a', 'b', 'c', 'xyz', 'd']

trim


String → String

Parameters

  • strThe string to trim.

Returns String Trimmed version of str.

Added in v0.6.0

Removes (strips) whitespace from both ends of the string.

  1. R.trim(' xyz '); //=> 'xyz'
  2. R.map(R.trim, R.split(',', 'x, y, z')); //=> ['x', 'y', 'z']

replace


RegExp|String → String → String → String

Parameters

  • patternA regular expression or a substring to match.
  • replacementThe string to replace the matches with.
  • strThe String to do the search and replacement in.

Returns String The result.

Added in v0.7.0

Replace a substring or regex match in a string with a replacement.

The first two parameters correspond to the parameters of the String.prototype.replace() function, so the second parameter can also be a function.

  1. R.replace('foo', 'bar', 'foo foo foo'); //=> 'bar foo foo'
  2. R.replace(/foo/, 'bar', 'foo foo foo'); //=> 'bar foo foo'
  3. // Use the "g" (global) flag to replace all occurrences:
  4. R.replace(/foo/g, 'bar', 'foo foo foo'); //=> 'bar bar bar'