Unnamed repository; edit this file 'description' to name the repository.
Improve doc
Ariel Davis 2023-05-07
parent 1cf7480 · commit 369e430
-rw-r--r--lib/line-index/src/lib.rs4
1 files changed, 3 insertions, 1 deletions
diff --git a/lib/line-index/src/lib.rs b/lib/line-index/src/lib.rs
index 2c71e8e763..23f9d989c0 100644
--- a/lib/line-index/src/lib.rs
+++ b/lib/line-index/src/lib.rs
@@ -214,7 +214,9 @@ impl LineIndex {
Some(LineCol { line: line_col.line, col })
}
- /// Returns an iterator over the ranges for the lines.
+ /// Given a range [start, end), returns a sorted iterator of non-empty ranges [start, x1), [x1,
+ /// x2), ..., [xn, end) where all the xi, which are positions of newlines, are inside the range
+ /// [start, end).
pub fn lines(&self, range: TextRange) -> impl Iterator<Item = TextRange> + '_ {
let lo = self.newlines.partition_point(|&it| it < range.start());
let hi = self.newlines.partition_point(|&it| it <= range.end());