Bllok Funksion FS_READLINE

Blloku i funksioneve FS_READLINE lexon te dhenat rresht-për-rreshtë nga një file.

Kujdes: Kur lexohen file të mëdha shumë, SPS ose sistemi i plotë mund të bëhet i papërshtatshëm dhe nuk do të niset më.

Shënim: Madhësia maksimale e lexueshme e një rreshti është për arsye sigurie 1024'000 bytes.

Sistemi i fileve duhet të ketë qenë initializuar më parë duke përdorur FS_INIT. Të gjitha operacionet bëhen asinkronisht për çdo mjedis ruajtjeje që është krijuar.

Hyrja READ

Në një anë positive, të dhënat lexohen nga mjedisi i ruajtjes.

Hyrja DEV

Përkufizon pajisjen, nga e cila duhet të aksesohen filet. Pajisja përdoret për projekt dhe mund të administrohet në menun kontekstual nën Projekti ▸ Ruajtje e Jashtme.

Hyrja PATH

Tregon rrugën për në file në mjedisin e ruajtjes. Rruga përgjigjet një rruge të fileve Unix në format UTF-8, nëse kjo mbështetet. Rruga paraqitet si më poshtë:

Folder/Subfolder/File.txt

Hyrja LINE

Përkufizon rreshtin që duhet të lexohet. Rreshti i parë fillon me numrin 0.

Hyrja ENDING

Përkufizon kthimin e rreshtit. Ky caktohet me escape: "\r\n". Nëse hyrja nuk është e përkufizuar, atëherë merrni "\n".

Në raste të mëposhtme shënimi i escape respektohet:

  • "\t" (ASCII 9 (0x09)), një simbol tabulatori.
  • "\n" (ASCII 10 (0x0A)), një kthim në rresht (Line Feed).
  • "\r" (ASCII 13 (0x0D)), një simbol kthimi karroce (Carriage Return).
  • "\0" (ASCII 0 (0x00)), byte NUL.
  • '\xEF' Formë shkruese për bytes.

Shënim: Për të lejuar që karaktere binare, si p.sh. '\xEF', të caktohen, këto duhet të caktohen në thonjëza të thjeshta.

Dalja DONE

Dalja kthen një impuls në rast suksesi për të vazhduar operacionin e ardhshëm. Impulsi ndodh kur procesi mbaron, edhe nëse ka pasur një gabim.

Dalja DATA

Kthen rreshtin e lexuar, duke përfshirë fundin e rreshtit. Gjendja ruhet për përdorim të mëvonshëm.

Dalja EOF

Nëse fundi i fileve është arritur, hyrja është e vërtetë.

Dalja BOM

Nëse UTF-8 Byte Order Mark u gjet, dalja është e vërtetë. BOM përcaktohet në çdo proces leximi.

Dalja ERROR

Kthen një tekst me një mesazh gabimi në rast gabimi. Ky është FALSE, nëse nuk ka pasur asnjë gabim. Gjendja ruhet për përdorim të mëvonshëm.

Arsyet e mundshme:

  • Shërbimi i mjedisit të ruajtjes nuk është nisur.
  • Ruajtja nuk u initializua.
  • Të dhënat e identifikimit janë të pavlefshme.
  • Serveri i largët nuk mund të arrijet.
  • Mjedisi i ruajtjes nuk ekziston.
  • Rruga e caktuar është e pavlefshme.