
Khối chức năng FS_WRITE ghi dữ liệu vào một hệ thống tệp.
Chú Ý: Các tệp đã tồn tại sẽ bị ghi đè mà không có cảnh báo nào.
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ữ đã thiết lập.
Khi có một cạnh dương, dữ liệu sẽ được ghi vào thiết bị lưu trữ.
Xác định thiết bị 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.
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
Xác định dữ liệu cần được ghi.
Chỉ định chế độ mà tệp sẽ được ghi. Các chế độ có thể là:
| Chế Độ | Mô Tả |
|---|---|
| "r" | Chỉ mở để đọc. Đặt con trỏ tệp vào đầu tệp. |
| "r+" | Mở để đọc và ghi. Đặt con trỏ tệp vào đầu tệp. |
| "w" | Chỉ mở để ghi. Đặt con trỏ tệp vào đầu tệp. Xóa nội dung của tệp. Nếu tệp không tồn tại, tệp sẽ được tạo. |
| "w+" | Mở để ghi và đọc. Đặt con trỏ tệp vào đầu tệp. Xóa nội dung của tệp. Nếu tệp không tồn tại, tệp sẽ được tạo. |
| "a" | Chỉ mở để ghi. Đặt con trỏ tệp vào cuối tệp. Nếu tệp không tồn tại, tệp sẽ được tạo. Dữ liệu được thêm vào cuối. |
| "a+" | Mở để ghi và đọc. Đặt con trỏ tệp vào cuối tệp. Nếu tệp không tồn tại, tệp sẽ được tạo. Dữ liệu được thêm vào cuối. |
| "x" | Chỉ mở để ghi. Đặt con trỏ tệp vào đầu tệp. Nếu tệp tồn tại, quá trình sẽ bị hủy bỏ. |
| "x+" | Mở để ghi và đọc. Đặt con trỏ tệp vào đầu tệp. Nếu tệp tồn tại, quá trình sẽ bị hủy bỏ. |
| "c" | Chỉ mở để ghi. Đặt con trỏ tệp vào đầu tệp. Nếu tệp không tồn tại, tệp sẽ được tạo. Ghi đè nội dung của tệp. |
| "c+" | Mở để ghi và đọc. Đặt con trỏ tệp vào đầu tệp. Nếu tệp không tồn tại, tệp sẽ được tạo. Ghi đè nội dung của tệp. |
Nếu đầu vào khi ghi là đúng, thì UTF-8 Byte Order Mark sẽ được thêm vào đầu tệp. Điều này chỉ xảy ra nếu tệp bị ghi đè hoặc tạo mới. Nếu BOM không được viết ở đầu tệp, nó không thể được thêm sau.
Đầu ra trả về một xung khi 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.
Trả về số lượng byte đã được ghi. Trạng thái được lưu trữ cho sử dụng sau này.
Trong trường hợp lỗi, đầu ra 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 nào xảy ra. Trạng thái được lưu trữ cho sử dụng sau này.
Các nguyên nhân có thể: