aboutsummaryrefslogtreecommitdiff
path: root/node_modules/string-length/readme.md
diff options
context:
space:
mode:
Diffstat (limited to 'node_modules/string-length/readme.md')
-rw-r--r--node_modules/string-length/readme.md43
1 files changed, 43 insertions, 0 deletions
diff --git a/node_modules/string-length/readme.md b/node_modules/string-length/readme.md
new file mode 100644
index 0000000..6156940
--- /dev/null
+++ b/node_modules/string-length/readme.md
@@ -0,0 +1,43 @@
+# string-length
+
+> Get the real length of a string - by correctly counting astral symbols and ignoring [ansi escape codes](https://github.com/sindresorhus/strip-ansi)
+
+`String#length` erroneously counts [astral symbols](https://web.archive.org/web/20150721114550/http://www.tlg.uci.edu/~opoudjis/unicode/unicode_astral.html) as two characters.
+
+## Install
+
+```
+$ npm install string-length
+```
+
+## Usage
+
+```js
+const stringLength = require('string-length');
+
+'🐴'.length;
+//=> 2
+
+stringLength('🐴');
+//=> 1
+
+stringLength('\u001B[1municorn\u001B[22m');
+//=> 7
+```
+
+## Related
+
+- [string-length-cli](https://github.com/LitoMore/string-length-cli) - CLI for this module
+- [string-width](https://github.com/sindresorhus/string-width) - Get visual width of a string
+
+---
+
+<div align="center">
+ <b>
+ <a href="https://tidelift.com/subscription/pkg/npm-string-length?utm_source=npm-string-length&utm_medium=referral&utm_campaign=readme">Get professional support for this package with a Tidelift subscription</a>
+ </b>
+ <br>
+ <sub>
+ Tidelift helps make open source sustainable for maintainers while giving companies<br>assurances about security, maintenance, and licensing for their dependencies.
+ </sub>
+</div>