From c875b3ed7380bbb35c8b77c8723edfa0efdeadaa Mon Sep 17 00:00:00 2001 From: Markus Scherer Date: Tue, 27 Feb 2018 20:21:25 +0000 Subject: [PATCH] ICU-13515 improve API docs X-SVN-Rev: 40995 --- icu4c/source/common/unicode/utf8.h | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/icu4c/source/common/unicode/utf8.h b/icu4c/source/common/unicode/utf8.h index 8ccc7dfebab..8fdedbd1100 100644 --- a/icu4c/source/common/unicode/utf8.h +++ b/icu4c/source/common/unicode/utf8.h @@ -615,6 +615,10 @@ utf8_back1SafeBody(const uint8_t *s, int32_t start, int32_t i); * the lead byte of that incomplete sequence. * For example, if the string ends with E1 80, the length is reduced by 2. * + * In all other cases (the string ends with a complete sequence, or it is not + * possible for any further trail byte to extend the trailing sequence) + * the length remains unchanged. + * * Useful for processing text split across multiple buffers * (save the incomplete sequence for later) * and for optimizing iteration @@ -627,7 +631,7 @@ utf8_back1SafeBody(const uint8_t *s, int32_t start, int32_t i); * * @param s const uint8_t * string * @param start int32_t starting string offset (usually 0) - * @param length int32_t string length, must be start<=length + * @param length int32_t string length (usually start<=length) * @see U8_SET_CP_START * @draft ICU 61 */ -- 2.50.1