Description
Sum content widths and split target-minus-content-minus-padding into nonnegative remaining padding and overflow.
Alignment requires a declared measure of width. ASCII token characters, supplied display-cell widths and actual rendered glyph widths are different, so a column budget is meaningful only under its stated convention.
Sum content widths and split target-minus-content-minus-padding into nonnegative remaining padding and overflow.
When to use this tool
Use Unicode Cell Padding Remainder when you need a supplied field-width or padding calculation.
How to use the tool and how it works
- Enter suppliedCellWidths, targetCells, existingPaddingCells. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read contentCells, paddingRemaining, overflowCells. Use the output convention below.
Require nonnegative integer supplied cell widths and target/existing padding. Sum content widths and split target-minus-content-minus-padding into nonnegative remaining padding and overflow.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| suppliedCellWidths | Nonnegative caller-supplied whole display-cell counts; fractional widths are rejected. | Required. Array of safe integer; minimum 0; maximum items 256. |
| targetCells | Target Cells | Required. Safe integer; minimum 0. |
| existingPaddingCells | Existing Padding Cells | Required. Safe integer; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| contentCells | Content Cells | Required. Safe integer. |
| paddingRemaining | Padding Remaining | Required. Safe integer. |
| overflowCells | Overflow Cells | Required. Safe integer. |
{
"input": {
"suppliedCellWidths": [
1,
2,
1
],
"targetCells": 8,
"existingPaddingCells": 1
},
"output": {
"contentCells": 4,
"paddingRemaining": 3,
"overflowCells": 0
}
}Limitations and assumptions
- Widths are supplied display-cell measurements, not derived from Unicode text; fractional cell widths are rejected. The result does not insert padding or ensure actual terminal alignment.
- 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
Measure text in the actual font, terminal or output environment when visual alignment matters. Account for encoding, combining marks, wide characters and locale rather than inferring display width from text length alone.
References
Similar or alternative tools
- Mantissa Exponent Field Width
Parse a signed decimal mantissa with optional e/E signed integer exponent.
- Decimal Group Separator Budget
Return floor((integerDigits-1)/groupSize) separators and their total column budget.