Blok funkcji FS_RENAME

Blok funkcji FS_RENAME zmienia nazwę plików lub folderów lub przenosi je w inne miejsce.

Uwaga: Istniejące już pliki są bez ostrzeżenia nadpisywane.

System plików musi być wcześniej zainicjowany za pomocą FS_INIT. Wszystkie operacje odbywają się asynchronicznie dla każdego utworzonego medium magazynującego.

Wejście RENAME

W przypadku pozytywnej krawędzi dane na nośniku są przemianowywane lub przenoszone.

Wejście DEV

Definiuje urządzenie, z którego należy uzyskać dostęp do plików. Urządzenie jest używane w projekcie i może być zarządzane w menu kontekstowym pod Projekt ▸ Zewnętrzne Magazynowanie.

Wejście SRC_PATH

Podaje ścieżkę źródłową do pliku lub folderu na nośniku. Ścieżka odpowiada ścieżce plików Unix w formacie UTF-8, jeśli jest on obsługiwany. Ścieżka jest przedstawiana następująco:

Folder/Subfolder/File.txt

Wejście DEST_PATH

Podaje ścieżkę docelową do pliku lub folderu na nośniku. Musi być podana pełna nazwa ścieżki.

Wyjście DONE

Na wyjściu w przypadku powodzenia zwracany jest impuls, aby przeprowadzić następną operację. Impuls następuje po zakończeniu procesu, nawet jeśli wystąpił błąd.

Wyjście ERROR

W przypadku błędu zwraca tekst z komunikatem o błędzie. Jest to FALSE, gdy nie wystąpił żaden błąd. Stan jest zapisywany do późniejszego użycia.

Możliwe przyczyny:

• Usługa nośnika nie została uruchomiona.
• Magazyn nie został zainicjowany.
• Dane logowania są nieprawidłowe.
• Nie można było połączyć się z odległym serwerem.
• Nośnik nie istnieje.
• Podana ścieżka jest nieprawidłowa.
• Do nośnika nie można zapisać.
• Brak miejsca na magazynie lub magazyn jest chroniony przed zapisem.