Standardbibliothek

Diese Dokumentation beschreibt den eingefrorenen Umfang der experimentellen Vorabversion v0.0.18. Der tatsächliche Veröffentlichungsstatus und die Downloads stehen in GitHub Releases. Diese grundlegenden Einstiegspunkte wurden anhand des Quelltexts geprüft; dies ist keine vollständige API-Referenz. Der Syntaxvertrag definiert das Verhalten. Backend-Grenzen stehen in der Unterstützungsmatrix.

Module importieren

import fs from "std.fs"
import json from "std.json"
import { http, time } from "std"

fs, http, config, task, pg, redis, mysql, bytes und net erfordern explizite Imports. Einige ältere Module lassen sich weiterhin direkt aufrufen; neue Beispiele bevorzugen explizite Imports, um Abhängigkeiten sichtbar zu machen. std.task ist ein interner Namensraum für Beobachtung und Stresstests, keine Nebenläufigkeits-API für Anwendungen.

Modul	Zweck	Zu beachtende Grenzen
std.string / Stringmethoden	Unicode-Länge, Bytelänge, Suche, Ausschnitte	Nativem trim/lower/upper fehlt eine Unicode-Implementierung
std.array / Arraymethoden	Länge, Suche, neue Arrays, map	Fehler bei direktem Indexzugriff unterscheiden sich vom behebbaren try_get
std.object	Explizite Ersatzwertsuche mit get_or	Ein fehlender gewöhnlicher Index liefert nicht standardmäßig null
std.json	Strenge JSON-Kodierung und -Dekodierung	In nativen Tasks und LLVM nicht unterstützt
std.fs	Dateien, Existenzprüfungen, Verzeichnislisten	Relative Pfade werden vom Verzeichnis der aktuellen .ku-Quelldatei aus aufgelöst
std.time	Zeit, Datum, Dauer, Schlafen	Synchrone Wartevorgänge und Task-Wartevorgänge verwenden unterschiedliche Ausführungspfade
std.http	HTTP-Clients, Dienste, Antworten	Backend- und Lebenszyklusunterschiede bestehen fort; keine vollständige generische Task-Netzwerkimplementierung
std.config	Umgebung und Konfiguration	Keine echten Zugangsdaten im Quelltext committen
std.pg / std.redis / std.mysql	Einheitliche Clients mit begrenzten Pools	Nur nativ; echte Servervalidierung und TLS-Grenzen müssen separat geprüft werden
std.bytes / std.net	Binärdaten, TCP-Client, optionales TLS	Generierter nativer C-Pfad; TLS erfordert ein passendes Zielpaket
std.lexer / std.parser	Compiler-Debugginghilfen	Geben Debug-Zusammenfassungen zurück, keine vollständigen öffentlichen Token-/AST-Strukturen

Häufige Signaturen

Dies sind Dokumentationssignaturen. & bezeichnet einen unterstützten schreibgeschützten Parametermodus; T! bezeichnet ein behebbares Ergebnis:

len(&value:any): int
str(&value:any): str
println(&value:any): null
string.len(&text:str): int
string.byte_len(&text:str): int
string.slice(text:str, start:int, end:int): str!
array.len(&values:[T]): int
array.try_get(values:[T], index:int): T!
fs.read(path:str): str!
fs.write(path:str, text:str): null!
fs.exists(path:str): bool
fs.read_dir(path:str): [str]!

"中😀".len() ergibt 2 und .byte_len() ergibt 7. Die Länge zählt Unicode-Skalarwerte; Ausschnitte verwenden Zeichenindizes statt UTF-8-Bytes. array.push und array.concat geben neue Arrays zurück, ohne ihre Eingaben zu verändern.

Eine Datei lesen

import fs from "std.fs"

fn main(): null! {
    text = fs.read("message.txt")?
    println(text)
    return ok(null)
}

Erstellen Sie zuerst eine UTF-8-Datei message.txt neben dem Quelltext. Eine fehlende Datei oder ein fehlgeschlagener Lesevorgang gibt einen Fehler zurück. Dieses Beispiel hängt von dieser Eingabedatei ab. try_read und try_write bleiben kompatible Aliasse mit denselben Ergebnistypen.

read_dir gibt sortierte Pfade mit unabhängigem Besitz zurück, begrenzt auf 10.000 Einträge und insgesamt 1.000.000 Pfadbytes. Eingeschränkte native Task-Dateioperationen verwenden einen festen Hintergrundpool. Das belegt kein generisches Warten auf Netzwerkvorgänge über denselben Mechanismus.

Die Referenz pflegen

Metadaten öffentlicher Schnittstellen liegen in src/stdlib/metadata.rs. Sie werden zusammen mit Implementierungen und Verträgen geprüft. Diese Website pflegt derzeit eine ausgewählte manuelle Referenz; ein vorhandener Befehl ku doc wurde nicht bestätigt.