diff --git a/icu4c/source/common/unicode/normlzr.h b/icu4c/source/common/unicode/normlzr.h index e6129378012..946f4c9ded4 100644 --- a/icu4c/source/common/unicode/normlzr.h +++ b/icu4c/source/common/unicode/normlzr.h @@ -464,7 +464,13 @@ public: /** * Return the next character in the normalized text. * (Post-increment semantics.) - * If the end of the text has already been reached, {@link #DONE} is returned. + * If the end of the text has already been reached, DONE is returned. + * The DONE value could be confused with a U+FFFF non-character code point + * in the text. If this is possible, you can test getIndex()startIndex() || first()!=DONE). (Calling first() will change + * the iterator state!) + * + * The C API unorm_previous() is more efficient and does not have this ambiguity. * * @return the previous normalized code point * @stable ICU 2.0