Zeilen mit Leerzeichen einrücken

Leere oder nur aus Weißraum bestehende Eingaben werden mit einem klaren invalid_input-Fehler abgelehnt, damit Automatisierung nie einen leeren Einfügevorgang als erfolgreiches Einrücken behandelt.

Was zeilenweises Einrücken mit Leerzeichen bedeutet und wann Sie es nutzen

Die meisten Editoren rücken eine Auswahl ein, indem sie Leerzeichen oder Tabs am Anfang jeder ausgewählten Zeile einfügen; diese Fähigkeit leistet dieselbe Arbeit als fokussierte, API-taugliche Transformation. Eine ganz leere oder nur aus Weißraum bestehende Eingabe ist ein harter Fehler: es gibt kein sinnvolles eingerücktes Dokument zurückzugeben, und Aufrufer sollten das als invalid_input behandeln, nicht als Erfolg mit null Zeilen.

So rufen Sie die API auf und was die Antwort enthält

Der spaces-Wert muss eine endliche Ganzzahl von null bis einschließlich zweihundert sein. Bevorzugen Sie den rohen mehrzeiligen Body statt vorab zusammengefügter Zeilen, wenn Sie echte pro-Zeile-Semantik wollen. Senden Sie einen JSON-Body mit dem Pflicht-Stringfeld text (Aliase input, value, string, s, content und body) und dem Pflicht-Ganzzahlfeld spaces (Aliase n, indent, count, amount und pad). Der Text muss nach globalem Trimmen des Weißraums nicht leer sein und darf hunderttausend Zeichen nicht überschreiten, damit eine einzelne Anfrage Worker- oder Browser-Speicher bei riesigen Einfügungen nicht erschöpft. Bei Erfolg spiegelt die Antwort input als die gesendete Originalzeichenkette, spaces als die angewandte normalisierte Ganzzahl, text als das vollständig eingerückte Ergebnis verbunden mit LF, line_count als die Anzahl der Zeilen nach dem Split (einschließlich leerer), lines als geordnetes Array der eingerückten Zeilenstrings, chars_before und chars_after als Längen der Original- und eingerückten Zeichenketten, chars_added als wie viele Zeichen die Präfixe insgesamt einführten (typisch line_count mal spaces, angepasst wenn die Newline-Normalisierung das Original verkürzte), und message als kurze englische Zusammenfassung mit Zeilenzahl, spaces und hinzugefügten Zeichen. Fehlgeschlagene Validierung—fehlendes text, kein String-Wert, zu große Nutzlast, leerer Inhalt nach globalem Trim oder ungültiges spaces—liefert invalid_input und wird nie berechnet. Der Preis ist pauschal $0.002 pro erfolgreicher Anfrage mit Einheit item. Beim Integrieren assertieren Sie auf text oder lines für den eingerückten Inhalt, vergleichen optional chars_added für Regressionen und behandeln invalid_input als Client-Fehler bei leeren Formularen, nicht als Abrechnungsereignis.

Praktische Tipps, Grenzen und verwandte Suchen

Round-Trip-Prüfungen für Tests sind einfach: senden Sie zwei kurze Zeilen mit spaces gleich vier und erwarten Sie, dass jede Zeile mit vier Leerzeichen beginnt; senden Sie eine Leerzeile zwischen Inhalten und bestätigen Sie, dass diese leere Zeile dasselbe Präfix trägt; senden Sie absichtlich leere Zeichenkette oder nur Leerzeichen, um invalid_input und die Meldung für eine nicht leere Zeichenkette zu bestätigen; senden Sie negatives spaces oder eine Gleitkommazahl, um invalid_input am Zählfeld zu bestätigen. Wenn Sie führende und abschließende Weißräume pro Zeile entfernen statt Leerzeichen hinzuzufügen, nutzen Sie das Schwesterwerkzeug zum zeilenweisen Trimmen; wenn Sie eine einzelne Zeichenkette auf Gesamtbreite mit Füllzeichen links oder rechts auffüllen wollen, nutzen Sie String-Pad; wenn Sie pretty-printed JSON mit struktureller Einrückung brauchen, nutzen Sie einen JSON-Formatierer. Fehlgeschlagene Aufgaben mit invalid_input verbrauchen kein vorausbezahltes Guthaben, was Formularvalidierung und negative CI-Tests günstig hält. Bleiben Sie bei großen Dumps über die API innerhalb der dokumentierten Zeichen- und spaces-Obergrenzen.