Indentare righe con spazi

L’input vuoto o solo spazi viene rifiutato con un errore invalid_input chiaro affinché l’automazione non tratti mai un incolla vuoto come un’indentazione riuscita. Il percorso è logica di stringhe pura e deterministica—senza rete, senza semi casuali, senza orologio—così l’esecutore gratuito del browser e l’API prepagata restituiscono lo stesso JSON a ogni chiamata.

Cosa significa l’indentazione per riga con spazi e quando usarla

La maggior parte degli editor indenta una selezione inserendo spazi o tabulazioni all’inizio di ogni riga selezionata; questa capacità fa lo stesso lavoro come trasformazione mirata e pronta per l’API. L’input intero vuoto o solo spazi è un errore duro: non c’è un documento indentato significativo da restituire, e i client devono trattarlo come invalid_input e non come un successo a zero righe.

Come chiamare l’API e cosa contiene la risposta

Il valore spaces deve essere un intero finito da zero a duecento inclusi. Preferisca inviare il corpo multilinea grezzo piuttosto che unire le righe in anticipo se desidera semantica reale per riga. Invii un corpo JSON con il campo string obbligatorio text (alias input, value, string, s, content e body) e il campo intero obbligatorio spaces (alias n, indent, count, amount e pad). Il testo deve essere non vuoto dopo un trim globale degli spazi e non deve superare centomila caratteri affinché una sola richiesta non esaurisca la memoria del Worker o del browser con incolli enormi. In caso di successo la risposta restituisce input come la stringa originale inviata, spaces come l’intero normalizzato applicato, text come il risultato completamente indentato unito con LF, line_count come il numero di righe dopo lo split (comprese le vuote), lines come un array ordinato delle stringhe di riga indentate, chars_before e chars_after come le lunghezze delle stringhe originale e indentata, chars_added come quanti caratteri i prefissi hanno introdotto in totale (tipicamente line_count per spaces, regolato se la normalizzazione dei newline ha accorciato l’originale), e message come un breve riepilogo in inglese che riporta conteggio righe, spaces e caratteri aggiunti. La validazione fallita—text assente, valore non string, payload troppo grande, contenuto vuoto dopo il trim globale o spaces non valido—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 indentato, confronti opzionalmente chars_added per le regressioni e tratti invalid_input come errore client su form vuoti e non come evento di fatturazione.

Consigli pratici, limiti e ricerche correlate

I controlli andata e ritorno per i test sono semplici: invii due righe corte con spaces uguale a quattro e si aspetti che ogni riga inizi con quattro spazi; invii una riga vuota tra i contenuti e confermi che anche quella riga vuota porta lo stesso prefisso; invii deliberatamente stringa vuota o solo spazi per confermare invalid_input e il messaggio che chiede una stringa non vuota; invii un spaces negativo o un float per confermare invalid_input sul campo conteggio. Se deve rimuovere spazi iniziali e finali per riga invece di aggiungere spazi, usi lo strumento fratello di trim per riga; se deve riempire una singola stringa a una larghezza totale con un carattere di riempimento a sinistra o a destra, usi il pad di stringa; se serve JSON con indentazione strutturale, usi un formattatore JSON. Le attività fallite che restituiscono invalid_input non consumano saldo prepagato, il che mantiene economiche la validazione dei form e i test negativi di CI. Rispetti i limiti di caratteri e di spaces documentati sopra quando invia dump grandi tramite API.