SysFileRename, redenumirea fișierului

Listă

Această pagină face parte din Manual de programare IEC 61131-3. Mergeți la index.

Această funcție de la rulați în sarcina Înapoi, vă permite să schimbați numele unui fișier. În OldName trebuie să definiți numele fișierului care urmează să fie redenumit prin specificarea întregii căi (Exemplu C:\Directory\OldFile.txt), În NewName trebuie să definiți noul nume de fișier specificând întreaga cale (Exemplu C:\Directory\NewFile.txt).

Dacă operația de redenumire are succes, funcția revine TRUE, în caz de eroare, este returnat FALSE.

Înlocuiește Sysrename

Înlocuiește funcția Sysrename schimbarea tipului de parametri de intrare de la string la pointer la string. Declarația anterioară:

i:=Sysrename('C:\Directory\OldFile.txt', 'C:\Directory\NewFile.txt');

devine:

i:=SysFileRename(ADR('C:\Directory\OldFile.txt'), ADR('C:\Directory\NewFile.txt'));
Cercul de informații

funzione

CODESYS: Indisponibil

LogicLab: eLLabXUnified12Lib

Descriere

OldName (@STRING) Numele fișierului care urmează să fie redenumit, inclusiv calea.
NewName (@STRING) Nume nou de dat fișierului, inclusiv calea.

Funcția returnează un (BOOL), FALSE dacă eroare de execuție, TRUE dacă alerg ok.

Imagine F SysFileRename

Exemple

Cum se utilizează exemplele.
În exemplu, prin activarea variabilei din debug Rename, fișierul C:\Directory\OldFile.txt dacă este prezent, este redenumit C:\Directory\NewFile.txt iar variabila este resetată. În caz de eroare de execuție, codul de eroare este stocat în variabilă ECode.

LogicLab (Ptp116, ST_SysFileRename)
PROGRAM ST_SysFileRename
VAR
    Rename : BOOL; (* Rename command *)
    ECode : UDINT; (* Error code *)
END_VAR

// *****************************************************************************
// PROGRAM "ST_SysFileRename"
// *****************************************************************************
// By setting the Rename command a file is renamed.
// -----------------------------------------------------------------------------

    IF (Rename) THEN
        Rename:=FALSE; //Rename command

        IF (SysGetFileLen(ADR('C:\Directory\OldFile.txt')) <> eEOF) THEN
            IF NOT(SysFileRename(ADR('C:\Directory\OldFile.txt'), ADR('C:\Directory\NewFile.txt'))) THEN
                ECode:=SysGetLastError(TRUE); //Error code
            END_IF;
        END_IF;
    END_IF;

// [End of file]
A fost util acest articol?