Girdi / Çıktı
Dosya Sistemi
dosya, klasör ve yol API'leri.
Dosya ve klasör API’leri UTF-8 metin ve bellek/test dosya sistemi üzerinden çalışır. Kök uygulama çalışma dizinidir.
yol.birleştir / kullanır; kök dışına US1530, sembolik bağ US1531.
Güvenlik ve hata kodları
Olmayan dosya: US1537. Üst klasör yok: US1539. Dolu klasör silme: US1540. Yapılandırma dosyası yokluğu US1532’dir ve dosya.oku değildir.
İlgili konular
JSON · Yapılandırma · Konsol G/Ç
Referans
Bu sayfa 11 katalog öğesini kapsar. Aşağıdaki maddeler language-spec, örnekler ve katalog alanlarından üretilmiştir.
dosya.oku
Nedir?
dosya.oku(yol) uygulama çalışma kökü altındaki metin dosyasını UTF-8 olarak okur ve metin döndürür.
Ne zaman kullanılır?
Yerel metin dosyası içeriğini okumak.
Parametreler ve dönüş
dosya.oku(yol: metin): metin. Kök uygulama çalışma dizinidir. RUNTIME: olmayan dosya US1537. Yol kaçışı US1530, sembolik bağ US1531. US1532 yalnızca yapılandırma dosyası (uygulamaAyar.json) yokluğudur; dosya.oku için dosya-bulunamadı kodu US1537’dir.
Kullanım
syaz dosya.oku("not.txt")Basit örnek
dosya.yaz("not.txt", "İbrahim")syaz dosya.oku("not.txt")Çıktı
İbrahim
Geçersiz örnek
syaz dosya.oku("yok.txt")US1537 FileNotFound — dosya yok.
Dikkat edilmesi gerekenler
- Olmayan dosya → RUNTIME US1537 (US1532 değil).
- Yorumlayıcı/test bellek dosya sistemi kullanır.
- Derleyici SUPPORTED.
İlgili konular
dosya.yaz
Nedir?
dosya.yaz(yol, metin) UTF-8 metni dosyaya yazar; var olan dosyanın üzerine yazar. Üst klasörü kendiliğinden oluşturmaz.
Ne zaman kullanılır?
Dosyayı sıfırdan veya tamamen yeniden yazmak.
Parametreler ve dönüş
dosya.yaz(yol, içerik) — dönüş yok; yan etki dosya içeriğidir. RUNTIME: üst klasör yoksa US1539. Yol kaçışı US1530; sembolik bağ US1531.
Kullanım
dosya.yaz("not.txt", "İbrahim")Basit örnek
dosya.yaz("not.txt", "İbrahim")syaz dosya.oku("not.txt")Çıktı
İbrahim
Geçersiz örnek
dosya.yaz("yokKlasor/a.txt", "x")US1539 InvalidPath — üst klasör yok; kendiliğinden açılmaz.
Dikkat edilmesi gerekenler
- Üzerine yazar; sona eklemek için
dosya.sonaEkle. - Üst klasör yok → US1539.
- Derleyici SUPPORTED.
dosya.sonaEkle
Nedir?
dosya.sonaEkle(yol, metin) UTF-8 metni dosyanın sonuna ekler; üst klasör varsa olmayan dosyayı oluşturur.
Ne zaman kullanılır?
Günlük veya birikimli metin eklemek; yoksa oluşturup yazmak.
Parametreler ve dönüş
dosya.sonaEkle(yol, içerik) — yan etki ekleme/oluşturma. Üst klasör yoksa US1539. Yol kuralları dosya.yaz ile aynı kök/kaçış sözleşmesidir.
Kullanım
dosya.sonaEkle("log.txt", "satır\n")Basit örnek
dosya.yaz("a.txt", "A")dosya.sonaEkle("a.txt", "B")syaz dosya.oku("a.txt")Çıktı
AB
Dikkat edilmesi gerekenler
- Üst klasör yoksa oluşturmaz (US1539).
- Var olan içeriğin üzerine yazmaz; sona ekler.
dosya.sil
Nedir?
dosya.sil(yol) çalışma kökündeki dosyayı siler. Olmayan dosyada çalışma zamanı hatası verir (US1537).
Ne zaman kullanılır?
Metin dosyasını kaldırmak.
Parametreler ve dönüş
dosya.sil(yol) — yan etki silme. RUNTIME: olmayan dosya US1537. varMı ile önce sorgu yapılabilir.
Kullanım
dosya.sil("not.txt")Basit örnek
dosya.yaz("sil.txt", "x")dosya.sil("sil.txt")syaz "{dosya.varMı("sil.txt")}"Çıktı
yanlış
Geçersiz örnek
dosya.sil("yok.txt")US1537 FileNotFound.
Dikkat edilmesi gerekenler
- Olmayan dosya → US1537.
- Klasör silmek için
klasör.silkullanın.
dosya.varMı
Nedir?
dosya.varMı(yol) dosyanın varlığını mantıksal olarak döndürür. Yokluk durumunda hata fırlatmaz; yalnız sorgu yapar.
Ne zaman kullanılır?
Okuma/silmeden önce varlık kontrolü.
Parametreler ve dönüş
dosya.varMı(yol): mantıksal — doğru / yanlış. SEMANTIC tip sonucu; yokluk RUNTIME hata değildir.
Kullanım
syaz "{dosya.varMı("not.txt")}"Basit örnek
dosya.yaz("var.txt", "1")syaz "{dosya.varMı("var.txt")}"Çıktı
doğru
Dikkat edilmesi gerekenler
- Hata fırlatmaz;
oku/silfırlatır. - Derleyici SUPPORTED.
klasör.oluştur
Nedir?
klasör.oluştur(yol) çalışma kökü altında klasör oluşturur. Dosya API’siyle aynı yol kökü ve kaçış kurallarını kullanır.
Ne zaman kullanılır?
Yazmadan önce dizin hazırlamak.
Parametreler ve dönüş
klasör.oluştur(yol) — yan etki oluşturma. Yol kaçışı US1530; sembolik bağ US1531.
Kullanım
klasör.oluştur("veri")Basit örnek
klasör.oluştur("veri")syaz "{klasör.varMı("veri")}"Çıktı
doğru
Dikkat edilmesi gerekenler
- Kök uygulama çalışma dizinidir.
- Derleyici SUPPORTED.
klasör.sil
Nedir?
klasör.sil(yol) yalnız boş klasörü siler. İçinde dosya veya alt klasör varsa reddedilir.
Ne zaman kullanılır?
Boş dizini kaldırmak.
Parametreler ve dönüş
klasör.sil(yol) — yan etki silme. RUNTIME: boş olmayan klasör US1540.
Kullanım
klasör.sil("veri")Basit örnek
klasör.oluştur("bos")klasör.sil("bos")syaz "{klasör.varMı("bos")}"Çıktı
yanlış
Geçersiz örnek
klasör.oluştur("dolu")dosya.yaz("dolu/a.txt", "x")klasör.sil("dolu")US1540 IoError — boş olmayan klasör silinemez.
Dikkat edilmesi gerekenler
- Boş olmayan silme → US1540.
- Önce çocukları silin.
klasör.varMı
Nedir?
klasör.varMı(yol) klasörün varlığını mantıksal olarak döndürür. Yokluk hata değildir; yalnız varlık sorgusudur.
Ne zaman kullanılır?
Oluşturma veya listelemeden önce varlık kontrolü.
Parametreler ve dönüş
klasör.varMı(yol): mantıksal. Hata fırlatmaz.
Kullanım
syaz "{klasör.varMı("veri")}"Basit örnek
klasör.oluştur("kontrol")syaz "{klasör.varMı("kontrol")}"Çıktı
doğru
Dikkat edilmesi gerekenler
dosya.varMıile karıştırmayın; alıcı farklıdır.
klasör.dosyalar
Nedir?
klasör.dosyalar(yol) yalnız doğrudan çocuk adlarını liste\<metin\> olarak döndürür. Sıra ordinaldir; konak sırasına bırakılmaz.
Ne zaman kullanılır?
Bir klasördeki dosya/alt öğe adlarını listelemek (özyinelemesiz).
Parametreler ve dönüş
klasör.dosyalar(yol): liste\<metin\> — yalnız bir düzey. Alt klasörlere inmez.
Kullanım
adlar: liste<metin> = klasör.dosyalar("veri")Basit örnek
klasör.oluştur("k")dosya.yaz("k/a.txt", "1")adlar: liste<metin> = klasör.dosyalar("k")syaz "{adlar.adet}"Çıktı
1
Dikkat edilmesi gerekenler
- Doğrudan çocuklar; özyinelemeli tarama yok.
- Sıra ordinaldir.
İlgili konular
yol.birleştir
Nedir?
yol.birleştir(sol, sağ) US yol metninde / ile birleştirir. Kök uygulama çalışma dizinidir; kök dışına çıkan yol reddedilir.
Ne zaman kullanılır?
Güvenli göreli yol üretmek.
Parametreler ve dönüş
yol.birleştir(sol: metin, sağ: metin): metin. .. çözüldükten sonra kök dışına çıkış RUNTIME US1530. Sembolik bağ US1531. Aşırı iddia etmeyin: yalnız birleştirme + kök denetimi.
Kullanım
syaz yol.birleştir("klasor", "a.txt")Basit örnek
syaz yol.birleştir("a", "b")Çıktı
a/b
Geçersiz örnek
syaz yol.birleştir("..", "gizli")US1530 PathEscape — kök kaçışı.
Dikkat edilmesi gerekenler
- US yolu
/kullanır. - Kök dışı → US1530; symlink → US1531.
- Derleyici SUPPORTED.
Dosya / klasör / yol API
Nedir?
UTF-8 metin dosya/klasör/yol API’si. Kök uygulama çalışma dizinidir. .. çözüldükten sonra kök dışına çıkış US1530; sembolik bağ US1531. Yorumlayıcı/test bellek dosya sistemi kullanır.
Ne zaman kullanılır?
Yerel metin dosyası okuma/yazma, klasör oluşturma veya yol birleştirme.
Parametreler ve dönüş
dosya.oku(yol): metin, dosya.yaz(yol, içerik), dosya.sonaEkle(yol, içerik), dosya.sil(yol), dosya.varMı(yol): mantıksal. klasör.oluştur / sil / varMı / dosyalar(yol): liste\<metin\> (doğrudan çocuk adları, ordinal sıra). yol.birleştir(sol, sağ): metin — US yolunda /.
Kullanım
dosya.yaz("not.txt", "İbrahim")syaz dosya.oku("not.txt")syaz yol.birleştir("klasor", "a.txt")Geçerli örnek
syaz yol.birleştir("a", "b")Çıktı
a/b
Geçersiz örnek
yol.birleştir("..", "gizli")US1530 PathEscape — kök kaçışı.
Dikkat edilmesi gerekenler
dosya.yazüst klasörü kendiliğinden açmaz; yoksa US1539.dosya.oku/silolmayan dosyada US1537; boş olmayan klasör silme US1540.varMıhata fırlatmaz.- Derleyici FS yüzeyi SUPPORTED (process-local).