Bllok Funksion FS_READ

Blloku i funksioneve FS_READ lexon të dhëna nga një skedar.

Kujdes: Kur lexohen skedarë shumë të mëdhenj, SPS ose sistemi i tërë mund të dështojë dhe nuk do të niset më. Përjashtoni me kujdes hyrjen LENGTH=0.

Sistemi i skedarëve 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ë hynë në skedarët. Pajisja përdoret për projekt dhe mund të administrohet në menun kontekstual nën Projekti ▸ Ruajtje e jashtme.

Hyrja PATH

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

Folder/Subfolder/File.txt

Hyrja OFFSET

Përkufizon offsetin në byte, nga e cila duhet të lexohet. Nëse nuk është përkufizuar asnjë offset, leximi fillon nga fillimi i skedarit.

Hyrja LENGTH

Përkufizon gjatësinë maksimale, deri në cilën leximi mbaron. Nëse hyrja nuk është përkufizuar, leximi vazhdon deri në fund të skedarit.

Shënim: Madhësia maksimale e lexueshme kur LENGTH=0 është 1'024'000 byte për arsye sigurie.

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 të dhënat e lexuara. Ky gjendje ruhet për përdorim të mëvonshëm.

Dalja EOF

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

Dalja BOM

Nëse UTF-8 Byte Order Mark është gjetur, 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. Ky gjendje ruhet për përdorim të mëvonshëm.

Arsyet e mundshme:

  • Shërbimi i mjedisit të ruajtjes nuk është nisur.
  • Ruajtja nuk është initializuar.
  • 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.