Troncare testo

Una lunghezza sotto uno viene rifiutata con un errore invalid_input chiaro affinché la validazione dei form e la CI non trattino mai un tetto zero o negativo come successo. Il percorso è logica di stringhe pura e deterministica—senza rete, senza semi casuali, senza dipendenza dall’orologio—così l’esecutore gratuito del browser e l’API prepagata restituiscono lo stesso JSON ogni volta che la invoca.

Cosa significa troncare con puntini rispetto a riscrivere o ritagliare

Se non entra, il solver calcola un budget di contenuto uguale a length meno la lunghezza dei puntini, prende un prefisso fino a quel budget, opzionalmente torna indietro allo spazio bianco precedente quando word_boundary è true, rimuove gli spazi finali del prefisso tenuto perché i puntini non restino dopo un vuoto pendente, e concatena i puntini.

Come chiamare l’API e cosa contiene la risposta

Invii un corpo JSON con text obbligatorio (alias input, value, string, s, content e body) e length obbligatorio (alias max_length, max, n, limit e max_len). Length deve essere un intero da uno a centomila inclusi; valori sotto uno, non interi e limiti sovradimensionati sono invalid_input. L’opzionale word_boundary (alias word, soft, on_word) ha default false e accetta booleano true o false. L’opzionale ellipsis (alias suffix, ending, marker) ha default di tre punti ASCII e può essere qualsiasi stringa fino a trentadue caratteri; quando serve il troncamento l’ellipsis non deve essere più lungo di length o la richiesta fallisce invece di inventare un marcatore tagliato. Text deve restare entro centomila caratteri affinché una singola richiesta non esaurisca la memoria del Worker o del browser. In caso di successo la risposta restituisce input come la stringa originale, text come la stringa finale da mostrare, length come il massimo richiesto, original_length e result_length come conteggi di caratteri, truncated come booleano, word_boundary come il flag inviato (o il default), ellipsis come il suffisso usato, used_word_boundary quando è stato applicato un taglio soft, e message come un breve riepilogo in inglese. La validazione fallita—text o length assenti, text non string, length non intero o sotto uno, payload sovradimensionato, o ellipsis che non entra sotto il limite quando serve un taglio—restituisce invalid_input e non viene mai addebitata. Il prezzo è un $0.002 fisso per richiesta riuscita con unità item e prezzo unitario marginale zero.

Suggerimenti pratici, limiti e ricerche correlate

Usi questa capacità quando l’intento di ricerca è troncare testo, aggiungere puntini alla lunghezza massima o tagliare in soft su un limite di parola online. Un ellipsis personalizzato come un singolo carattere di puntini Unicode o un’etichetta «altro» tra parentesi quadre funziona quando la sua lunghezza entra ancora nel budget. Questa pagina non è un riassuntore IA, non è un contatore di paragrafi o parole, non è un convertitore title-case e non è un ritagliatore solo dei bordi di riga. I controlli andata-e-ritorno per i test sono facili: invii una frase lunga con length venti e si aspetti truncated true e result_length al più venti; attivi word_boundary su una frase multi-parola e si aspetti che l’ultimo carattere tenuto non sia dentro una parola se esisteva uno spazio prima; invii length zero o un intero negativo e si aspetti invalid_input che menzioni lunghezza sotto uno. Preferisca un taglio hard quando le serve una griglia fissa di caratteri come log monospazio; preferisca word_boundary per titoli e anteprime rivolti alle persone dove i tagli a metà parola sembrano rotti. Preferisca text.shorten quando le serve compressione che preserva il senso sotto un budget di parole con un modello linguistico; preferisca str.trim_lines quando le serve solo pulizia spazi per riga; preferisca questa capacità quando il prodotto ha già deciso una lunghezza massima di visualizzazione rigida e deve mostrare un prefisso fedele. Le attività fallite che restituiscono invalid_input non consumano il saldo prepagato, il che mantiene economica la validazione dei form e i test negativi di CI. Formando i revisori, mostri la stessa frase in modalità hard e soft così vedono che cambiano solo la posizione del taglio e il flag used_word_boundary mentre la regola dei puntini resta uguale.