diff options
Diffstat (limited to 'vendor/futf/README.md')
-rw-r--r-- | vendor/futf/README.md | 18 |
1 files changed, 18 insertions, 0 deletions
diff --git a/vendor/futf/README.md b/vendor/futf/README.md new file mode 100644 index 000000000..325b2e74d --- /dev/null +++ b/vendor/futf/README.md @@ -0,0 +1,18 @@ +# futf + +[![Build Status](https://travis-ci.org/servo/futf.svg?branch=master)](https://travis-ci.org/kmcallister/futf) + +futf is a library for *flexible* UTF-8, or UTF-8 *fragments*. I don't know. +Check out the [API documentation](http://doc.servo.org/futf/index.html). + +Anyway, it takes an index into a byte buffer and tells you things about the +UTF-8 codepoint containing that byte. It can deal with incomplete codepoint +prefixes / suffixes at the ends of a buffer, which is useful for incremental +I/O. It can also handle UTF-16 surrogate code units encoded in the manner of +[CESU-8][] or [WTF-8][]. + +This is a low-level helper for [tendril][] that might be useful more generally. + +[CESU-8]: http://www.unicode.org/reports/tr26/ +[WTF-8]: http://simonsapin.github.io/wtf-8/ +[tendril]: https://github.com/kmcallister/tendril |