Number of bytes from the beginning of the input. The first byte has offset 0.

A range refers to a chunk of the file, from start (included) to stop (excluded). Ranges may be used to remove chunks of the file, or replace them with some alternative text.

t is a mutable type that holds the original contents of the file being rewritten, as well as all the edits that are enqueued to it over time (inserts, replaces and removals).

Initialize a new t from an original contents, initially with no edits. The path supplied is only used for context awareness and error messages, but no I/O occurs on disk.

This may come as a surprise, but offsets refer to the offsets in the original contents, not the ongoing rewritten buffer. Thus, it is OK to insert several texts at the same offset. The order of insertion decides which inserts are applied first. Raises Invalid_argument if offset is not a valid offset in t's original_contents, indicating a programming error that needs to be fixed.

Replace an entire section denoted by the given range by an alternative text. The range refers to the range in the original contents, not the ongoing rewritten buffer. Through the use of this module it is invalid to request replaces with overlapping ranges, and doing so will cause exception Invalid_rewrites to be raised during contents. Raises Invalid_argument if range is not a valid range in t's original_contents, indicating a programming error that needs to be fixed.

This is a small convenient wrapper that is equivalent to replacing a range by the empty string. Raises Invalid_argument if range is not a valid range in t's original_contents, indicating a programming error that needs to be fixed.

You may decide at a given moment that you want to discard all the edits inserted so far, and just start over. This has the same effect than starting fresh with a newly created t.

Build the final result, with all the substitutions applied. If the substitutions requested causes conflicts, this function will raise Invalid_rewrites. The exception is not really meant to be caught in a production path, because it would usually be indicative of a programming error. If you prefer a result type, see contents_result.

Same as contents but wraps the output into a result type rather than raising an exception.

Returns the path that was supplied to create.

Returns the original contents that was supplied to create.