pub fn split<'a>(text: &'a str, delimiter: &str) -> Result<Statements<'a>>Expand description
Cuts a file into the statements it carries, one at a time.
The statements are produced as they are asked for, so what a run of a long file costs is its longest statement and never the whole file cut up. Every refusal the file can earn is still decided here, before the first statement is handed out: a caller that gets a walk has a file that will not be refused halfway through, once part of it has already reached the server.
ยงErrors
Returns a usage failure for an empty separator, and a validation failure when a region of the file is left open or when a redefined separator is never restored.