FS_READLINE İş Bloku

FS_READLINE İş Bloku, bir dosyadan satır satır veri okur.

Dikkat: Çok büyük dosyaları okurken SPS veya tüm sistem çökebilir ve çalışmaya devam edemez.

Not: Güvenlik nedenleriyle bir satırın en fazla okunabilir boyutu 1024'000 bayttır.

Dosya sistemi önce FS_INIT kullanılarak başlatılmalıdır. Tüm işlemler, her oluşturulan depolama aracına göre asenkron olarak gerçekleştirilir.

READ Girişi

Bir pozitif kenarda, veri depolama aracından okunur.

DEV Girişi

Dosyalar erişileceği cihazı tanımlar. Cihaz projeye göre kullanılır ve Proje ▸ Dış Depolama bağlam menüsünden yönetilebilir.

PATH Girişi

Depolama aracındaki dosyaya yolunu belirtir. Yol, desteklendiğinde bir Unix dosya yolu UTF-8 formatındadır. Yol aşağıdaki gibidir:

Dizin/Altdizin/Dosya.txt

LINE Girişi

Okunacak satırı tanımlar. İlk satır 0 numarasıyla başlar.

ENDING Girişi

Satır sonunu tanımlar. Bu escape ile belirtilir: "\r\n". Giriş tanımlanmazsa, "\n" kabul edilir.

Aşağıdaki karakterlerde escape dikkate alınır:

  • "\t" (ASCII 9 (0x09)), bir sekme karakteri.
  • "\n" (ASCII 10 (0x0A)), bir satır ileri gitme (Line Feed).
  • "\r" (ASCII 13 (0x0D)), bir araba geri dönüş karakteri (Carriage Return).
  • "\0" (ASCII 0 (0x00)), NUL bayt.
  • '\xEF' Baytlar için yazım şekli.

Not: İkili karakterler, örneğin '\xEF', tanımlanabilmesi için tek tırnak içinde tanımlanmalıdır.

DONE Çıktısı

Başarılı bir durumda, çıkış bir impuls verir sonraki işlemi gerçekleştirmek üzere. Impuls, hatanın oluştuğu durumda bile işlem tamamlandığında gerçekleşir.

DATA Çıktısı

Okunan satırı, satır sonunu dahil eder. Durum daha sonra kullanılmak üzere saklanır.

EOF Çıktısı

Dosyanın sonuna ulaşılırsa giriş doğru olur.

BOM Çıktısı

UTF-8 Bayt Sırası İşareti bulunursa çıkış doğru olur. BOM her okuma işlemi sırasında belirlenir.

ERROR Çıktısı

Hata durumunda bir hata mesajı içeren metin verir. Bu FALSE, hatanın oluştuğu durumda değilse. Durum daha sonra kullanılmak üzere saklanır.

Mümkün nedenler:

  • Depolama aracının hizmeti başlatılmamıştır.
  • Depolama başlatılmamıştır.
  • Giriş bilgileri geçersizdir.
  • Uzak sunucu erişilemez.
  • Depolama araç mevcut değil.
  • Belirtilen yol geçersizdir.