textutil

Documentation

Overview

Package textutil holds small string helpers shared across packages.

The truncation helpers exist because ad-hoc byte slicing (s[:n]) can split a multibyte UTF-8 rune, producing invalid UTF-8 in transcripts, tool results, and terminal output. Use these instead of slicing by byte.

Index

• func ClipBytes(s string, max int) string
• func ClipRunes(s string, max int) string
• func ClipRunesEllipsis(s string, max int) string

Functions

func ClipBytes

func ClipBytes(s string, max int) string

ClipBytes returns s truncated to at most max bytes without splitting a UTF-8 rune: the cut backs up to the nearest rune boundary. Use when the budget is genuinely in bytes (wire limits, log caps).

func ClipRunes

func ClipRunes(s string, max int) string

ClipRunes returns s truncated to at most max runes.

func ClipRunesEllipsis

func ClipRunesEllipsis(s string, max int) string

ClipRunesEllipsis returns s truncated to at most max runes, appending an ellipsis when truncation occurred.