1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
//! Read text and locate characters: positions, UTF-8 validity, binary skip.
//!
//! See `src/scan/SPEC.md`. This file declares the node's public type
//! vocabulary and composes the node; it implements nothing, which is the
//! hub's rule for a `mod.rs` (`src/SPEC.md` CONSTRAINTS). The walk lives
//! in `text`, the refusals that come before it in `bytes`, and the order
//! a report goes out in in `order`.
pub use ;
pub use ;
pub use located;
pub use scan_str;
/// Where a character sits, in the three units a reader or a tool needs.
///
/// Line and column are 1-based and the column counts CHARACTERS, because a
/// byte column is wrong for an editor the moment a line holds anything
/// multi-byte. The byte offset is kept beside them for tools that edit.
/// One located character. Whether it is ALLOWED is not decided here: this
/// node reports what is where, and the rules and lint nodes decide what it
/// means.
/// Why a file could not be scanned. Neither case is silent: an unreadable
/// file that reported nothing would be indistinguishable from a clean one.