[6a3a178] | 1 | var baseToString = require('./_baseToString'),
|
---|
| 2 | baseTrim = require('./_baseTrim'),
|
---|
| 3 | castSlice = require('./_castSlice'),
|
---|
| 4 | charsEndIndex = require('./_charsEndIndex'),
|
---|
| 5 | charsStartIndex = require('./_charsStartIndex'),
|
---|
| 6 | stringToArray = require('./_stringToArray'),
|
---|
| 7 | toString = require('./toString');
|
---|
| 8 |
|
---|
| 9 | /**
|
---|
| 10 | * Removes leading and trailing whitespace or specified characters from `string`.
|
---|
| 11 | *
|
---|
| 12 | * @static
|
---|
| 13 | * @memberOf _
|
---|
| 14 | * @since 3.0.0
|
---|
| 15 | * @category String
|
---|
| 16 | * @param {string} [string=''] The string to trim.
|
---|
| 17 | * @param {string} [chars=whitespace] The characters to trim.
|
---|
| 18 | * @param- {Object} [guard] Enables use as an iteratee for methods like `_.map`.
|
---|
| 19 | * @returns {string} Returns the trimmed string.
|
---|
| 20 | * @example
|
---|
| 21 | *
|
---|
| 22 | * _.trim(' abc ');
|
---|
| 23 | * // => 'abc'
|
---|
| 24 | *
|
---|
| 25 | * _.trim('-_-abc-_-', '_-');
|
---|
| 26 | * // => 'abc'
|
---|
| 27 | *
|
---|
| 28 | * _.map([' foo ', ' bar '], _.trim);
|
---|
| 29 | * // => ['foo', 'bar']
|
---|
| 30 | */
|
---|
| 31 | function trim(string, chars, guard) {
|
---|
| 32 | string = toString(string);
|
---|
| 33 | if (string && (guard || chars === undefined)) {
|
---|
| 34 | return baseTrim(string);
|
---|
| 35 | }
|
---|
| 36 | if (!string || !(chars = baseToString(chars))) {
|
---|
| 37 | return string;
|
---|
| 38 | }
|
---|
| 39 | var strSymbols = stringToArray(string),
|
---|
| 40 | chrSymbols = stringToArray(chars),
|
---|
| 41 | start = charsStartIndex(strSymbols, chrSymbols),
|
---|
| 42 | end = charsEndIndex(strSymbols, chrSymbols) + 1;
|
---|
| 43 |
|
---|
| 44 | return castSlice(strSymbols, start, end).join('');
|
---|
| 45 | }
|
---|
| 46 |
|
---|
| 47 | module.exports = trim;
|
---|