Khối Chức Năng FS_READLINE

Khối chức năng FS_READLINE đọc dữ liệu theo dòng từ một tệp.

Chú Ý: Khi đọc các tệp rất lớn có thể khiến SPS hoặc toàn bộ hệ thống bị treo và không thể khởi động lại được.

Lưu Ý: Kích thước tối đa của một dòng có thể đọc được là 1024'000 byte vì lý do bảo mật.

Hệ thống tệp phải được khởi tạo trước đó bằng cách sử dụng FS_INIT. Tất cả các hoạt động đều diễn ra bất đồng bộ cho mỗi thiết bị lưu trữ đã được thiết lập.

Đầu Vào READ

Khi có một cạnh dương, dữ liệu sẽ được đọc từ thiết bị lưu trữ.

Đầu Vào DEV

Xác định thiết bị mà từ đó truy cập vào các tệp. Thiết bị được sử dụng cho mỗi dự án và có thể được quản lý trong menu ngữ cảnh dưới Dự Án ▸ Bộ Nhớ Ngoại.

Đầu Vào PATH

Chỉ định đường dẫn đến tệp trên thiết bị lưu trữ. Đường dẫn tương ứng với một đường dẫn tệp Unix trong định dạng UTF-8, nếu được hỗ trợ. Đường dẫn được biểu diễn như sau:

Thư Mục/Thư Mục Con/Tệp.txt

Đầu Vào LINE

Xác định dòng mà cần đọc. Dòng đầu tiên bắt đầu với số 0.

Đầu Vào ENDING

Xác định ký tự xuống dòng. Ký tự này được chỉ định bằng các escape: "\r\n". Nếu đầu vào không được xác định, thì sẽ sử dụng "\n".

Các ký tự sau đây sẽ được xem xét:

  • "\t" (ASCII 9 (0x09)), một ký tự tab.
  • "\n" (ASCII 10 (0x0A)), một dòng mới (Line Feed).
  • "\r" (ASCII 13 (0x0D)), một ký tự trở về đầu dòng (Carriage Return).
  • "\0" (ASCII 0 (0x00)), byte NUL.
  • '\xEF' Ký hiệu cho các byte.

Lưu Ý: Để có thể định nghĩa các ký tự nhị phân, chẳng hạn như '\xEF', chúng phải được định nghĩa trong dấu ngoặc đơn.

Đầu Ra DONE

Đầu ra trả về một xung thành công để thực hiện hoạt động tiếp theo. Xung xảy ra khi kết thúc quá trình, ngay cả khi có lỗi xảy ra.

Đầu Ra DATA

Trả về dòng được đọc, bao gồm ký tự xuống dòng. Trạng thái được lưu trữ để sử dụng sau này.

Đầu Ra EOF

Nếu đã đến cuối tệp, đầu vào là đúng.

Đầu Ra BOM

Nếu đã tìm thấy UTF-8 Byte Order Mark, đầu ra là đúng. BOM được xác định trong mỗi quá trình đọc.

Đầu Ra ERROR

Trong trường hợp lỗi, trả về một văn bản với thông báo lỗi. Nó là FALSE, nếu không có lỗi xảy ra. Trạng thái được lưu trữ để sử dụng sau này.

Các nguyên nhân có thể:

  • Dịch vụ của thiết bị lưu trữ chưa được khởi động.
  • Bộ nhớ chưa được khởi tạo.
  • Thông tin đăng nhập không hợp lệ.
  • Không thể kết nối đến máy chủ từ xa.
  • Thiết bị lưu trữ không tồn tại.
  • Đường dẫn đã chỉ định không hợp lệ.