Avvolgere ogni riga con testo

L’input vuoto o solo di spazi viene rifiutato con un errore invalid_input chiaro affinché un modulo bianco non sembri mai un avvolgimento riuscito. 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.

Che cosa significa avvolgere ogni riga e quando serve

I valori predefiniti usano una virgoletta doppia dritta su entrambi i lati, così tre nomi diventano tre nomi tra virgolette, pronti da incollare in JSON, CSV o un file di configurazione. Quando skip_empty è true, una riga di lunghezza zero resta vuota così i vuoti di paragrafo sopravvivono mentre le righe con contenuto vengono avvolte. L’input intero vuoto o solo di spazi è un errore duro: non c’è un documento avvolto significativo da restituire, e chi chiama deve trattarlo come invalid_input e non come un successo a zero righe.

Come chiamare l’API e che cosa contiene la risposta

Quando passa una stringa vuota esplicita da un lato, quel lato resta vuoto così può anteporre soltanto o posporre soltanto. Se entrambi i lati risultano stringhe vuote, la chiamata è rifiutata, perché avvolgere con nulla non è un avvolgimento. Preferisca inviare il corpo multilinea grezzo invece di unire tutto in anticipo quando vuole una semantica reale per riga. Invii un corpo JSON con un campo string obbligatorio text (alias input, value, string, s, content e body). Includa in modo facoltativo prefix (alias pre e left) e suffix (alias post e right) come stringhe di al massimo sessantaquattro caratteri ciascuna, e skip_empty (alias skip_blank, ignore_empty e skip_blanks) come boolean. Quando prefix o suffix è omesso, ciascuno assume per impostazione predefinita una virgoletta doppia dritta. Il valore di text deve essere non vuoto dopo il trim complessivo degli spazi e non deve superare centomila caratteri, così una sola richiesta non esaurisce la memoria del Worker o del browser con incolla enormi. In caso di successo la risposta restituisce input come la stringa originale inviata, text come il risultato interamente avvolto unito con LF, prefix e suffix come gli affissi effettivi, skip_empty come il flag effettivo, line_count come il numero di segmenti dopo la divisione, wrapped_count come quanti di quei segmenti hanno davvero ricevuto gli affissi, lines come un array ordinato delle stringhe avvolte, e message come un breve riepilogo in inglese. La convalida fallita—text assente, un valore che non è string, un carico troppo grande, contenuto vuoto dopo il trim complessivo, un affisso che non è string o è troppo lungo, entrambi gli affissi vuoti o uno skip_empty che non è boolean—restituisce invalid_input e non viene mai addebitata. Il prezzo è un $0.002 fisso per richiesta riuscita con unità item. In integrazione, asserisca su text o lines per il contenuto avvolto, su wrapped_count quando skip_empty entra in gioco, e tratti invalid_input come un errore del client sui moduli bianchi e non come un evento di fatturazione.

Consigli pratici, limiti e ricerche correlate

Imposti prefix su un segno di maggiore e uno spazio con suffix vuoto per trasformare note in una citazione a blocco markdown. Imposti prefix su un tag di elemento elenco di apertura e suffix sul tag di chiusura corrispondente per costruire righe di markup. I controlli andata e ritorno per i test sono semplici: invii tre righe brevi e si aspetti tre righe tra virgolette con line_count tre e wrapped_count tre; invii una riga vuota tra due parole con skip_empty true e si aspetti che la riga di mezzo resti vuota; invii di proposito stringa vuota o solo spazi per confermare invalid_input e il messaggio che chiede una stringa non vuota; invii prefix vuoto e suffix vuoto insieme per confermare il rifiuto di entrambi vuoti. Tenga presenti gli a capo finali intenzionali: un LF finale crea un ultimo segmento vuoto che viene avvolto salvo che skip_empty sia true. Le attività fallite che restituiscono invalid_input non consumano il saldo prepagato, il che mantiene economica la convalida dei moduli e i test negativi di CI.