Description
Parse a source-namespaced census reference.
Historical and archival records distinguish source labels, local grid conventions, edition numbers and validity periods. A parsed token or geometric area term cannot establish provenance, historical identity or land rights. Date endpoints, text-counting units and numbering origins must match the original record.
Parse a source-namespaced census reference.
When to use this tool
Use Public Census Enumeration Token when checking the stated archival record, grid, edition or validity-period convention.
How to use the tool and how it works
- Enter reference, editionNamespace, separator. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read namespace, components, unresolvedSuffix. Use the output convention below.
Parse a source-namespaced census reference. Require nonempty namespace/separator and literal prefix; split the remainder into at least two nonempty parts, return the first two components and rejoin any unresolved suffix.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| reference | Caller-supplied comparison value in the same units as the observed quantity. | Required. Text; maximum UTF-16 length 8192. |
| editionNamespace | Edition Namespace | Required. Text; maximum UTF-16 length 8192. |
| separator | Separator | Required. Text; maximum UTF-16 length 8192. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| namespace | Namespace | Required. Text; maximum UTF-16 length 8192. |
| components | Components | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| unresolvedSuffix | Unresolved Suffix | Required. Text; maximum UTF-16 length 8192. |
{
"input": {
"reference": "E1900/ED12/P3/x",
"editionNamespace": "E1900",
"separator": "/"
},
"output": {
"namespace": "E1900",
"components": [
"ED12",
"P3"
],
"unresolvedSuffix": "x"
}
}Limitations and assumptions
- No census edition, field semantics, document locator or source authenticity is resolved.
- 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.
Alternative or Complementary methods
Consult the original archive, survey and applicable authority for historical interpretation, provenance or actual property rights.
References
Similar or alternative tools
- Regional Identifier Era Token
Split a regional identifier into region and era tokens.
- Catalogue Item Edition Suffix
Split a catalogue identifier at its last delimiter.