Roman Emperor by Year Imperial List Lookup
Match every caller verified imperial year interval using half-open positive-CE bounds, retaining co-rule and rival overlaps; no invented complete imperial list or partial-year date inference.
Description
An imperial chronology can contain overlapping claimants and regional recognition.
An imperial chronology can contain overlapping claimants and regional recognition.1
Interval lookup should return every matching caller record rather than assume exactly one emperor. Use Roman Emperor by Year Imperial List Lookup to evaluate the supplied inputs under the model explained below.
When to use Roman Emperor by Year Imperial List Lookup
Use Roman Emperor by Year Imperial List Lookup to evaluate the supplied inputs under the model explained below. Choose the applicable era, source or grammatical convention and independently establish the annotations or numerical assumptions.
How to use Roman Emperor by Year Imperial List Lookup and understand its results
- Choose the applicable era, source or grammatical convention and independently establish the annotations or numerical assumptions.
- Enter Caller ruler ids, Verified start years, Verified end years exclusive, Query year using the field table and validation rules below, then run the tool.
- Read Matching Ruler Ids in the Result object; interpret the units, signs, ordering and unknown-value placeholders described below.
- Correct reported input errors and rerun. Apply successful results according to their specific meanings and check the assumptions before using them in a decision.
| Input field | Meaning | Value type | Requirement |
|---|---|---|---|
| callerRulerIds | Caller ruler ids | array of string | Required; constraints below |
| verifiedStartYears | Verified start years | array of number | Required; constraints below |
| verifiedEndYearsExclusive | Verified end years exclusive | array of number | Required; constraints below |
| queryYear | Query year | number | Required; constraints below |
Enter nonempty unique nonblank ruler IDs and aligned integer start and exclusive-end years. Starts are 1 to 9999, ends must be greater than their starts and at most 10000, and query year is 1 to 9999. Return all IDs with start≤query<end in supplied order. Overlapping reigns are allowed and no match returns empty. This input uses positive year labels; there is no BCE/CE conversion or installed emperor list.
matchingRulers = IDs whose startYear≤queryYear<endYearExclusive Use the field order, units and branch conditions described above.
| Output field | Meaning | Value type |
|---|---|---|
| result | Object containing the named result fields below. | object |
| result.matchingRulerIds | Matching Ruler Ids | array of string |
{
"input": {
"callerRulerIds": [
"a",
"b",
"c"
],
"verifiedStartYears": [
96,
98,
98
],
"verifiedEndYearsExclusive": [
98,
117,
100
],
"queryYear": 99
},
"output": {
"result": {
"matchingRulerIds": [
"b",
"c"
]
}
}
}Limitations and assumptions
Interval lookup should return every matching caller record rather than assume exactly one emperor. Apply the exact scope and assumptions explained above.
All listed fields require explicit values. Unexpected fields, incorrect types, nonfinite numbers and sparse arrays fail validation. Domain-specific bounds, alignments and supported tokens are explained above; extremely large inputs or outputs can also be rejected. Input errors differ from successful false results, empty match lists and unknown-evidence placeholders.
Alternative or Complementary methods
Use Year of Four Emperors68/69 Succession Sequence Lookup for a related task: A succession list can summarize a civil-war year while rival claims overlap.
Use Tetrarchy Diocletian Four Rulers Division Abdication Structure for a related task: Tetrarchic roles distinguish senior and junior imperial positions.
References
Similar or alternative tools
- Year of Four Emperors68/69 Succession Sequence Lookup
A succession list can summarize a civil-war year while rival claims overlap.
- Tetrarchy Diocletian Four Rulers Division Abdication Structure
Tetrarchic roles distinguish senior and junior imperial positions.