Skip to content

Main content

Escaped Newline Visible Width Delta Tool

Count visible UTF-16 width after replacing each CRLF, CR or LF with an explicitly supplied display token width.

Loading tool…

Description

Count visible UTF-16 width after replacing each CRLF, CR or LF with an explicitly supplied display token width.

Text positions can be measured in UTF-16 code units, Unicode code points, grapheme clusters, or modeled display columns. These coordinates are not interchangeable. Invisible markers and delimiter policies can also affect interpretation even when a string looks unchanged, so the chosen representation needs to stay explicit.

Count visible UTF-16 width after replacing each CRLF, CR or LF with an explicitly supplied display token width.

When to use this tool

Use Escaped Newline Visible Width Delta when you need the stated marker, coordinate, delimiter, or normalization operation under an explicit text representation.

How to use the tool and how it works

  1. Enter text, newlineVisibleWidth. 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 newlineCount, originalCodeUnits, displayedCodeUnits, delta. Use the output convention below.

Count CRLF, CR, and LF newline tokens, subtract their original UTF-16 lengths, and add newlineVisibleWidth per token for displayedCodeUnits and delta.1

Input fieldMeaning and unitsAccepted input
textTextRequired. Text; maximum UTF-16 length 8192.
newlineVisibleWidthNewline Visible WidthRequired. Safe integer; minimum 0.
Output fieldInterpretationReturned shape
newlineCountNewline CountRequired. Safe integer.
originalCodeUnitsOriginal Code UnitsRequired. Safe integer.
displayedCodeUnitsDisplayed Code UnitsRequired. Safe integer.
deltaDeltaRequired. Safe integer.
json
{
  "input": {
    "text": "a\r\nb\n",
    "newlineVisibleWidth": 2
  },
  "output": {
    "newlineCount": 2,
    "originalCodeUnits": 5,
    "displayedCodeUnits": 6,
    "delta": 1
  }
}

Limitations and assumptions

  • The nonnegative integer width is a supplied replacement width. CRLF counts once but occupies two original code units; this estimate does not transform text or measure terminal cells.
  • The field tables state structural bounds; the mechanics also specify cross-field constraints. Malformed inputs and unsupported domains cause errors. A successful false flag, empty branch value, or zero placeholder has the meaning stated above and is distinct from an input error.

Alternative or Complementary methods

Choose the coordinate system required by the consumer. Use a full parser, renderer, or segmentation method when a local marker or delimiter rule cannot determine the complete text behavior.

References

  1. Calculation and input contract: text/escaped-newline-visible-width-delta — tool.io

Similar or alternative tools