You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: spec/docs/expressions.md
+10-9Lines changed: 10 additions & 9 deletions
Original file line number
Diff line number
Diff line change
@@ -9,31 +9,32 @@ An <dfn>expression map</dfn> (`rml:ExpressionMap`) is an abstract class, that is
9
9
* 1 `rml:reference`, or
10
10
* 1 `rml:template`.
11
11
12
-
Each of these properties specifies an [=expression=] which, upon evaluation, results in a [=set of values]=.
12
+
Each of these properties specifies an [=expression=] which, upon evaluation, results in an ordered list of values.
13
13
14
14
The <dfn>set of values</dfn> are the values of the [=references expression set=] which are returned by an [=expression=].
15
15
16
-
For each value in the [=set of values=], an [=expression value=] is created. If the [=set of values=] is empty, `NULL` is returned and no [=expression value=] is created.
16
+
For each value in the ordered list of values, an [=expression value=] is created. If the ordered list of values is empty, `NULL` is returned and no [=expression value=] is created.
17
17
18
18
The <dfn>reference expression set</dfn> of an [=expression map=] is the set of expressions which are evaluated on a [=logical iteration=].
19
19
20
20
### Constant expression (`rml:constant`)
21
21
22
-
A <dfn>constant-valued expression map</dfn> is an [=expression map=] that always generates the same expression value. A constant-valued expression map is represented by a resource that has exactly one `rml:constant` property, the value of which is called a <dfn>constant expression</dfn>.
22
+
A <dfn>constant-valued expression map</dfn> is an [=expression map=] that always generates the same value. A constant-valued expression map is represented by a resource that has exactly one `rml:constant` property, the value of which is called a <dfn>constant expression</dfn>.
23
23
24
-
The <dfn>constant value</dfn> is a singleton set containing the [=constant expression=].
24
+
The <dfn>constant value</dfn> is a singleton list containing the [=constant expression=].
25
25
26
-
The [=reference expressions=] of a [constant-valued expression map=] is the empty set.
26
+
The [=reference expressions=] of a [constant-valued expression map=] is an empty list.
27
27
28
28
### Reference (`rml:reference`)
29
29
A <dfn>reference-valued expression map</dfn> is an [=expression map=] that is represented by a resource that has exactly one `rml:reference` property, the value of which is called a <dfn>reference expression</dfn>.
30
30
31
31
The [=reference expression=] MUST be a valid [=expression=] according to the defined [=reference formulation=] in the [=logical source=].
32
32
33
-
The [=reference expression set=] of a [reference-valued expression map=] is the singleton set containing the [=reference expression=].
33
+
The [=reference expression set=] of a [=reference-valued expression map=] is the singleton set containing the [=reference expression=].
34
34
35
-
The <dfn>reference value set</dfn> is a set of values obtained by evaluating a [=reference expression=] against a given [=logical iteration=]. For each value in the set, an expression is created.
36
-
If the reference value set is an empty set, then the processor SHOULD return `NULL` and no expression should be created but a processor COULD allow users to adjust the strategy.
35
+
The <dfn>reference value</dfn> is an ordered list of values obtained by evaluating the [=reference expression=] against a given [=logical iteration=].
36
+
For each value in the ordered list, an expression is created.
37
+
If the reference value set is an empty ordered list, then the processor SHOULD return `NULL` and no expression should be created but a processor COULD allow users to adjust the strategy.
37
38
38
39
### Template (`rml:template`)
39
40
A <dfn>template-valued expression map</dfn> is an [=expression map=] that is represented by a resource that has exactly one `rml:template` property, the value of which is called a <dfn>template expression</dfn>. The [=template expression=] MUST be a valid [=string template=].
@@ -57,7 +58,7 @@ The <dfn>template value</dfn> when evaluating a [=string template=] for a given
57
58
1. Let `result` be the [=reference expression set=] of the [=string template=]
58
59
2. For each [=reference expression=] in `result`:
59
60
1. Let `values` be the [=reference value=] of the [=reference expression=] that is enclosed in the curly braces
60
-
2. If `values` is an empty set, then return `NULL`
61
+
2. If `values` is an empty list, then return `NULL`
61
62
3. For each `value` in `values`:
62
63
1. Let `value` be the [=natural RDF lexical form=] corresponding to `value`
63
64
3. Let `result` be the [=n-ary Cartesian product=] of `result`
0 commit comments