Offset und Limit für die Paginierung berechnen

Geben Sie die gewünschte Seite, die maximale Anzahl von Datensätzen je Seite und die Gesamtzahl der verfügbaren Elemente an. Der Rechner liefert den bei null beginnenden Offset, das Abfragelimit und die Gesamtzahl der Seiten. Seitennummern oder Seitengrößen unter eins werden abgelehnt, sodass ungültige Datenbankabfragen und widersprüchliche Navigationssteuerelemente frühzeitig vermieden werden.

Überführen Sie eine Seitenangabe in Abfrageparameter

Benutzeroberflächen stellen die Paginierung meist mit verständlichen Seitennummern dar, während Datenbanken und APIs häufig einen bei null beginnenden Offset und ein Limit erwarten. Dieser Rechner verbindet beide Konventionen. Geben Sie eine Seitennummer ab eins, eine Seitengröße und die Gesamtzahl der Elemente in der vollständigen Sammlung ein. Der Offset ergibt sich aus der um eins verringerten Seitennummer, multipliziert mit der Seitengröße. Das Limit entspricht der Seitengröße. Die dritte Seite einer in Gruppen zu fünfundzwanzig dargestellten Sammlung beginnt beispielsweise nach den ersten fünfzig Elementen; ihr Offset beträgt daher fünfzig und ihr Limit fünfundzwanzig. Sie können diese Werte direkt an eine übliche SQL-Klausel mit LIMIT und OFFSET übergeben oder entsprechenden Parametern eines anderen Dienstes zuordnen. Das Ergebnis ist deterministisch und die zugrunde liegenden Datensätze werden weder geprüft noch abgerufen. Es erfolgt ausschließlich die für eine paginierte Anfrage erforderliche Berechnung. Dadurch eignet sich das Werkzeug für Backends, Skripte, Tests, Dokumentationen und Fehlersuchen.

Verstehen Sie Seitenzahl und Randfälle

Die Gesamtzahl der Seiten wird berechnet, indem die Gesamtzahl der Elemente durch die Seitengröße geteilt und das Ergebnis aufgerundet wird. Das Aufrunden ist entscheidend, weil auch eine nur teilweise gefüllte letzte Seite als Seite zählt. Werden einhunderteins Elemente in Gruppen zu fünfundzwanzig angezeigt, enthalten vier Seiten einhundert Elemente und eine fünfte das verbleibende Element. Bei null Elementen beträgt die Seitenzahl ebenfalls null, da keine Ergebnisseite vorhanden ist. Die gewünschte Seite wird nicht automatisch auf diese Anzahl begrenzt. Eine Anfrage nach Seite zehn kann somit einen gültigen Offset erzeugen, obwohl die Sammlung nur drei Seiten umfasst. Dieses Verhalten ist beabsichtigt: Der Rechner liefert die Paginierungsarithmetik, während Sie die Anwendungsrichtlinie festlegen. Ihre Anwendung kann die gewünschte Seite mit total_pages vergleichen und anschließend ein leeres Ergebnis zurückgeben, auf die letzte Seite umleiten oder eine Nicht-gefunden-Antwort anzeigen. Die Trennung von Berechnung und Richtlinie sorgt in Datenbanken, REST-Diensten und Oberflächen für vorhersehbare Ergebnisse.

Prüfen Sie Eingaben vor dem Aufbau der Abfrage

page und page_size müssen sichere ganze Zahlen größer oder gleich eins sein. Null oder ein negativer Wert würde die bei eins beginnende Seitenkonvention verletzen oder ein sinnloses Limit erzeugen; deshalb führt beides zu einem Fehler wegen ungültiger Eingabe. total_items muss eine sichere ganze Zahl größer oder gleich null sein, da eine Sammlung keine negative oder gebrochene Datensatzanzahl enthalten kann. Die Prüfung sicherer Ganzzahlen verhindert außerdem unbemerkte Genauigkeitsverluste in JavaScript, wenn sehr große Werte multipliziert werden. Überschreitet der berechnete Offset den sicheren Bereich, wird die Anfrage abgelehnt, anstatt eine ungenaue Zahl zurückzugeben. Dieselben Regeln schützen auch eine API-Grenze davor, dass fehlerhafte Parameter den Datenbankadapter erreichen. Die Fähigkeit stellt keine Netzwerkanfragen, speichert keine Daten und verwendet weder Zufalls- noch Zeitwerte. Gleiche Eingaben liefern stets gleiche Ausgaben. Jede automatisierte API-Anfrage kostet $0.002; im Browser können Sie Beispiele während der Entwicklung oder Fehleranalyse prüfen.