toLower.js 592 B

1234567891011121314151617181920212223242526272829
  1. var toString = require('./toString');
  2. /**
  3. * Converts `string`, as a whole, to lower case just like
  4. * [String#toLowerCase](https://mdn.io/toLowerCase).
  5. *
  6. * @static
  7. * @memberOf _
  8. * @since 4.0.0
  9. * @category String
  10. * @param {string} [string=''] The string to convert.
  11. * @returns {string} Returns the lower cased string.
  12. * @example
  13. *
  14. * _.toLower('--Foo-Bar--');
  15. * // => '--foo-bar--'
  16. *
  17. * _.toLower('fooBar');
  18. * // => 'foobar'
  19. *
  20. * _.toLower('__FOO_BAR__');
  21. * // => '__foo_bar__'
  22. */
  23. function toLower(value) {
  24. return toString(value).toLowerCase();
  25. }
  26. module.exports = toLower;