Description
Advance start by one when includeStart is false and advance end by one when includeEnd is true.
Half-open list ranges include their start and exclude their end. Empty and touching ranges can be disjoint even when their boundary coordinates coincide.
Advance start by one when includeStart is false and advance end by one when includeEnd is true.
When to use this tool
Use List Marker Delimited Span Endpoint when you need a precise range relationship for a list operation.
How to use the tool and how it works
- Enter start, end, includeStart, includeEnd. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read first, exclusiveEnd, count. Use the output convention below.
Advance start by one when includeStart is false and advance end by one when includeEnd is true. Return first, exclusiveEnd, and their zero-floored difference.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| start | Start | Required. Safe integer; minimum 0. |
| end | End | Required. Safe integer. |
| includeStart | Include Start | Required. Boolean. |
| includeEnd | Include End | Required. Boolean. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| first | First value or boundary under the stated formula. | Required. Safe integer. |
| exclusiveEnd | Excluded terminal boundary of the indicated span. | Required. Safe integer. |
| count | Count | Required. Safe integer. |
{
"input": {
"start": 2,
"end": 6,
"includeStart": false,
"includeEnd": false
},
"output": {
"first": 3,
"exclusiveEnd": 6,
"count": 3
}
}Limitations and assumptions
- Equal marker positions can produce first greater than exclusiveEnd with count zero; list bounds are not supplied.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
- Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.
Alternative or Complementary methods
Validate ranges against the actual list length and the operation's overlap policy before mutating data.
References
Similar or alternative tools
- List: List Half Open Slice Length
Require start and end independently within [0, length] and return max(0, end - start).
- List Circular Slice Length
Return the forward modular distance from start to end.