Skip to content

Main content

List Partition Boundary Cursor Map Tool

Compute list partition boundary cursor map from explicit bounded inputs.

Loading tool…

Description

Classify cursor before boundary as left with its original coordinate; otherwise classify right and subtract boundary for localCursor.

A list window uses a start and exclusive end or a center and radius. Boundary clamping, padding, and half-integer centers are separate conventions.

Classify cursor before boundary as left with its original coordinate; otherwise classify right and subtract boundary for localCursor.

When to use this tool

Use List Partition Boundary Cursor Map when you need an explicit window position or edge-padding budget.

How to use the tool and how it works

  1. Enter length, boundary, cursor. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read partition, localCursor. Use the output convention below.

Classify cursor before boundary as left with its original coordinate; otherwise classify right and subtract boundary for localCursor.1

Input fieldMeaning and unitsAccepted input
lengthLength, count, or code length under the stated domain and unit convention.Required. Safe integer; minimum 0.
boundaryBoundaryRequired. Safe integer; minimum 0.
cursorCursorRequired. Safe integer; minimum 0.
Output fieldInterpretationReturned shape
partitionPartitionRequired. Text; maximum UTF-16 length 8192.
localCursorLocal CursorRequired. Safe integer.
json
{
  "input": {
    "length": 8,
    "boundary": 3,
    "cursor": 5
  },
  "output": {
    "partition": "right",
    "localCursor": 2
  }
}

Limitations and assumptions

  • The boundary cursor belongs to the right partition, including an empty right partition at the terminal boundary.
  • 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

Inspect actual list bounds and choose whether to shift, truncate, or pad windows before extracting data.

References

  1. Calculation and input contract: list/list-partition-boundary-cursor-map — tool.io

Similar or alternative tools