catala/compiler/catala_utils/pos.mli

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

62 lines
2.1 KiB
OCaml
Raw Normal View History

2020-05-25 18:48:02 +03:00
(* This file is part of the Catala compiler, a specification language for tax
and social benefits computation rules. Copyright (C) 2020 Inria, contributor:
Denis Merigoux <denis.merigoux@inria.fr>
Licensed under the Apache License, Version 2.0 (the "License"); you may not
use this file except in compliance with the License. You may obtain a copy of
the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations under
the License. *)
(** Source code position *)
2022-02-18 17:54:40 +03:00
type t
2020-05-25 18:48:02 +03:00
(** A position in the source code is a file, as well as begin and end location
of the form col:line *)
(**{2 Constructor and getters}*)
2021-01-20 17:37:20 +03:00
val from_lpos : Lexing.position * Lexing.position -> t
2020-05-25 18:48:02 +03:00
val from_info : string -> int -> int -> int -> int -> t
val overwrite_law_info : t -> string list -> t
2021-04-03 18:58:31 +03:00
val get_law_info : t -> string list
2020-05-25 18:48:02 +03:00
val get_start_line : t -> int
val get_start_column : t -> int
val get_end_line : t -> int
val get_end_column : t -> int
val get_file : t -> string
val join : t -> t -> t
(** Returns the smallest range including both supplied ranges. @raise Invalid_argument if they don't belong to the same file. The law position used is the one of the earliest position. *)
type input_file = FileName of string | Contents of string
2020-05-25 18:48:02 +03:00
(**{2 Formatters}*)
val to_string : t -> string
(** Formats a position like this:
{v in file <file>, from <start_line>:<start_col> to <end_line>:<end_col> v} *)
val to_string_short : t -> string
(** Formats a position like this:
2023-05-04 19:28:24 +03:00
{v <file>;<start_line>:<start_col>--<end_line>:<end_col> v}
This function is compliant with the
{{:https://www.gnu.org/prep/standards/standards.html#Errors} GNU coding
standards}. *)
2020-05-25 18:48:02 +03:00
val retrieve_loc_text : t -> string
(** Open the file corresponding to the position and retrieves the text concerned
by the position *)
val no_pos : t
(** Placeholder position *)