6.43 Source Locations

8.12

6.43 Source Locations🔗ℹ

The . operator can be used on a source location expression as equivalent to calling Srcloc functions:

srcloc.source
is
Srcloc.source(srcloc)
srcloc.line
is
Srcloc.line(srcloc)
srcloc.column
is
Srcloc.column(srcloc)
srcloc.position
is
Srcloc.position(srcloc)
srcloc.span
is
Srcloc.span(srcloc)
srcloc.to_report_string
is
Srcloc.to_report_string(srcloc)

annotation

Srcloc

Matches a source location value.

function

fun Srcloc(source :: Any,

line :: maybe(PosInt),

column :: maybe(NonnegInt),

position :: maybe(PosInt),

span :: maybe(NonnegInt))

:: Srcloc

Constructs a source location.

binding operator

Matches a source location where the components match the corresponding binding forms.

function

fun Srcloc.source(srcloc :: Srcloc) :: Any

function

fun Srcloc.line(srcloc :: Srcloc) :: maybe(PosInt)

function

fun Srcloc.column(srcloc :: Srcloc) :: maybe(NonnegInt)

function

fun Srcloc.position(srcloc :: Srcloc) :: maybe(PosInt)

function

fun Srcloc.span(srcloc :: Srcloc) :: maybe(NonnegInt)

Extracts a component of a source location.

function

fun Srcloc.to_report_string(srcloc :: Srcloc) :: String

Converts a source location into a human-readable string suitable for error messages and other reporting.

> Srcloc("demo.rhm", 1, 14, 500, 10).to_report_string()
"demo.rhm:1:14"

1	Rhombus Essentials
2	Collections and Iteration
3	Syntax Objects and Macros
4	Classes and Interfaces
5	Static Information and Binding
6	Core Reference
7	Meta and Macros Reference
8	Rhombus Static by Default
9	Libraries
10	Naming Conventions

6.1	General Forms
6.2	Definitions
6.3	Namespaces
6.4	Import
6.5	Export
6.6	Functions
6.7	Operators
6.8	Classes and Interfaces
6.9	Veneers
6.10	Mutable Variables and Assignment
6.11	Repetitions
6.12	Block
6.13	Conditionals
6.14	Matching
6.15	Iteration
6.16	Recursion
6.17	Context Parameters
6.18	Exceptions
6.19	Continuations
6.20	Implicit Forms
6.21	Static and Dynamic Lookup
6.22	Modules and Submodules
6.23	Booleans
6.24	Numbers
6.25	Characters
6.26	Strings
6.27	Keywords
6.28	Symbols
6.29	Byte Strings
6.30	Lists
6.31	Pairs and Pair Lists
6.32	Mutable Lists
6.33	Arrays
6.34	Maps
6.35	Sets
6.36	Boxes
6.37	Indexables
6.38	Listables
6.39	Sequences
6.40	Appendables
6.41	Comparables
6.42	Paths
6.43	Source Locations
6.44	Void
6.45	Equality
6.46	Dot
6.47	Multiple Values
6.48	Annotations
6.49	Enumerations
6.50	Input and Output
6.51	Eval
6.52	Syntax Objects
6.53	Syntax Classes
6.54	Simple Expression Macros
6.55	Unit Testing

srcloc.source	is	Srcloc.source(srcloc)
srcloc.line	is	Srcloc.line(srcloc)
srcloc.column	is	Srcloc.column(srcloc)
srcloc.position	is	Srcloc.position(srcloc)
srcloc.span	is	Srcloc.span(srcloc)
srcloc.to_report_string	is	Srcloc.to_report_string(srcloc)