Description
Encode a signed exact integer into lexicographic order by biasing against explicit inclusive range endpoints and fixed decimal width; caller retains endpoints for decoding.
An opaque key’s representation can affect equality and ordering even when its underlying value is unchanged. Delimiter joining can be ambiguous, fixed-width padding can preserve numeric order within agreed bounds, and typed length-prefix framing keeps scalar types distinct. Lengths in this family count UTF-16 code units unless a different unit is stated.
Encode a signed exact integer into lexicographic order by biasing against explicit inclusive range endpoints and fixed decimal width; caller retains endpoints for decoding.
When to use this tool
Use this tool to encode a signed exact integer into lexicographic order by biasing against explicit inclusive range endpoints and fixed decimal width; caller retains endpoints for decoding.
How to use the tool and how it works
- Enter value, minimum, maximum using the field definitions below.
- Run the operation. Correct input errors before interpreting an output.
- Read result.key. Use the ordering, boundary rules and absence conditions described below.
Parse exact integer value and inclusive minimum/maximum, subtract minimum, then zero-pad to the decimal width of maximum − minimum.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| value | Exact signed decimal integer text for the bounded value. | Text, at most 8,192 UTF-16 code units; the operation’s grammar also applies. |
| minimum | Exact signed decimal integer text defining the common lower bound. | Text, at most 8,192 UTF-16 code units; the operation’s grammar also applies. |
| maximum | Exact signed decimal integer text defining the common upper bound. | Text, at most 8,192 UTF-16 code units; the operation’s grammar also applies. |
| Output field | Interpretation |
|---|---|
| result | Object containing the named fields below. |
| result.key | Encoded, normalized-affix or padded key under the stated framing/ordering convention. |
{
"input": {
"value": "-2",
"minimum": "-10",
"maximum": "10"
},
"output": {
"result": {
"key": "08"
}
}
}Limitations and assumptions
- All keys must use the same bounds for lexical order to agree with numeric order.
- String framing and alphabet digits use UTF-16 code units, not bytes or grapheme clusters. Exact integer text accepts a signed decimal spelling of at most 256 digits before operation-specific range checks.
- Every declared top-level input field is required and unexpected fields are rejected. Ordinary strings are limited to 8,192 UTF-16 code units and lists to 128 entries, with tighter operation-specific bounds where stated. JSON text has bounded nesting and node counts.
- Numeric outputs must be finite and no larger in absolute magnitude than the safe-integer limit; operations returning exact large integers use decimal text. Positions are zero-based and spans end exclusively unless the operation explicitly states a different convention.
Alternative or Complementary methods
Use typed framing when distinct scalar types or tuple boundaries must remain distinguishable. Keep alphabet, width, normalization and numeric bounds consistent between producers and consumers.
References
Similar or alternative tools
- Opaque Key Sortable Decimal Padding
Format an exact unsigned decimal ordinal as a bounded fixed-width lexicographically sortable key, rejecting overflow; unsafe integers require text.
- Opaque Key Affix Normalizer
Ensure caller prefix and suffix are present after stripping/reapplying at most one matching affix; repeated inner affixes remain literal data, no recursive stripping or path semantics.