Przejdź do głównej zawartości
Polski

Biblioteka standardowa

Ta strona nie jest dostępna w wybranym języku. Wyświetlana jest angielska dokumentacja tej samej wersji.

Migawka 0.0.18 Dokumentacja

Specyfikacja składni opisuje bibliotekę standardową. Ograniczenia zapleczy podaje macierz obsługi.

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

fs, http, config, task, pg, redis, mysql, bytes i net wymagają jawnych importów. Niektóre historyczne moduły nadal można wywoływać bezpośrednio; nowe przykłady preferują jawne importy, by uwidocznić zależności. std.task jest wewnętrzną przestrzenią nazw obserwacji i testów obciążeniowych, a nie aplikacyjnym API współbieżności.

Moduł Przeznaczenie Ograniczenia
std.string / metody łańcuchów Długość Unicode, długość bajtowa, wyszukiwanie, wycinki Natywne trim/lower/upper nie mają implementacji Unicode
std.array / metody tablic Długość, wyszukiwanie, nowe tablice, map Błąd bezpośredniego indeksowania różni się od obsługiwalnego try_get
std.object Jawna wartość zastępcza wyszukiwania przez get_or Brakujący zwykły indeks nie daje domyślnie null
std.json Ścisłe kodowanie i dekodowanie JSON Nieobsługiwane w natywnym Task i LLVM
std.fs Pliki, sprawdzanie istnienia, listowanie katalogu Ścieżki względne są rozwiązywane względem katalogu bieżącego źródła .ku
std.time Czas, daty, okresy, usypianie Oczekiwanie synchroniczne i Task używa różnych ścieżek wykonania
std.http Klienty HTTP, usługi, odpowiedzi Pozostają różnice zaplecza i cyklu życia; nie jest to pełna uniwersalna implementacja sieciowa Task
std.config Środowisko i konfiguracja Nie zapisuj rzeczywistych danych uwierzytelniających w źródłach
std.pg / std.redis / std.mysql Ujednolicone klienty z ograniczonymi pulami Tylko natywne; rzeczywisty serwer i ograniczenia TLS wymagają osobnej weryfikacji
std.bytes / std.net Dane binarne, klient TCP, opcjonalny TLS Generowana natywna ścieżka C; TLS wymaga odpowiedniego pakietu docelowego
std.lexer / std.parser Pomoc przy debugowaniu kompilatora Zwracają podsumowania debugowania, a nie pełne publiczne struktury Token / AST

To sygnatury dokumentacyjne. & oznacza obsługiwany tryb parametru tylko do odczytu; T! — obsługiwalny wynik:

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() wynosi 2, a .byte_len() — 7. Długość zlicza wartości skalarne Unicode; wycinanie używa indeksów znaków, a nie bajtów UTF-8. array.push i array.concat zwracają nowe tablice bez modyfikacji wejściowych.

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

Najpierw utwórz plik UTF-8 message.txt obok źródła. Brak pliku lub nieudany odczyt zwraca błąd. Przykład zależy od tego pliku wejściowego. try_read i try_write pozostają zgodnymi aliasami z tymi samymi typami wyniku.

read_dir zwraca posortowane ścieżki o niezależnej własności, ograniczone do 10 000 wpisów i 1 000 000 bajtów ścieżek łącznie. Ograniczone natywne operacje plikowe Task używają stałej puli tła. Nie dowodzi to ogólnego oczekiwania sieciowego tym samym mechanizmem.