User Tools

Site Tools


Sidebar

en:objects:file_os:path_work:rename

rename

rename($path,$new_path); - this function is used to rename the specified file

The function accepts parameters as input:

  • $path – path to the file to rename (string). It can be either absolute or relative (relative to the script folder).
  • $new_path – new file name (file path) (string). It can be either absolute or relative (relative to the script folder).

    After testing, the function returns the result of its work to the script :
  • true – successfully renamed (boolean)
  • false – operation failed (boolean)

    PHP example:

    <?php $xhe_host = "127.0.0.1:7010";
     
    //connect the object to control the emulator, if not already connected
    if(!isset($path))
       $path = "../../../Templates/xweb_human_emulator.php";
    require($path);
     
    //Start
    echo "<hr> <font color = blue> file_os->".basename(__FILE__)."</font> <hr>";
     
    //1
    echo "1.Make a copy of the file:";
    echo $file_os->copy("test \ test1.txt", "test \ test_copy.txt", false)."<br>";
     
    //2
    echo "2.Delete the previous test file:";
    echo $file_os->delete("test \ test_rename.txt")."<br>";
     
    //3
    echo "3.Rename:";
    echo $file_os->rename("test \ test_copy.txt", "test \ test_rename.txt")."<br>";
     
    //4
    echo "4.Check that the file has been renamed:";
    echo $file_os->is_exist("test \ test_rename.txt")."<br>";
     
    //end
    echo "<hr> <br>";
     
    //Quit
    $app->quit();
    ?>

    Python example:

    # Additional paths
    import sys
    sys.path.insert(0, '../../../Templates PY/')
     
    xhe_host = "127.0.0.1:7011"
    from xweb_human_emulator import *
     
    # Start
    echo("<hr> <font color = blue> file_os.xxxxxxxxx </font> <hr>")
     
    # 1
    echo("1.Make a copy of the file:")
    echo(file_os.copy("test \ test1.txt", "test \ test_copy.txt", false), "<br>")
     
    # 2
    echo("2.Delete the previous test file:")
    echo(file_os.delete("test \ test_rename.txt"), "<br>")
     
    # 3
    echo("3.Rename:")
    echo(file_os.rename("test \ test_copy.txt", "test \ test_rename.txt"), "<br>")
     
    # 4
    echo("4.Check that the file has been renamed:")
    echo(file_os.is_exist("test \ test_rename.txt"), "<br>")
     
    # end
    echo("<hr> <br>")
     
    # Quit
    app.quit()

    C# example:

    #region using
     
    using System;
    using System.Diagnostics;
    using System.Collections.Generic;
    using System.Linq;
    using System.IO;
    using System.Text;
    using System.Threading;
     
    using XHE;
    using XHE.XHE_DOM;
    using XHE.XHE_System;
    using XHE.XHE_Window;
    using XHE.XHE_Web;
     
    #endregion
     
     class Program: XHEScript
     {
    static void Main(string [] args)
    {
    //init XHE
    server = "127.0.0.1:7010";
    InitXHE();
     
    //Start
    echo("<hr> <font color = blue> file_os.rename </font> <hr>");
     
    //1 step
    echo("1.Make a copy of the file:");
    echo(file_os.copy("test \ test1.txt", "test \ test_copy.txt", false) + "<br>");
     
    //step 2
    echo("2.Delete the previous test file:");
    echo(file_os.delete("test \ test_rename.txt") + "<br>");
     
    //step 3
    echo("3.Rename:");
    echo(file_os.rename("test \ test_copy.txt", "test \ test_rename.txt") + "<br>");
     
    //step 4
    echo("4.Check that the file has been renamed:");
    echo(file_os.is_exist("test \ test_rename.txt") + "<br>");
     
    //end
    echo("<hr> <br>");
     
    app.quit();
    }
    }

    Java Script example:

    //connect the object to control the emulator, if not already connected
    xhe_host = "127.0.0.1:7010";
    echo = require("../../../Templates JS/xweb_human_emulator.js");
     
    //Start
    echo("<hr> <font color = blue> file_os.rename </font> <hr>");
     
    //1 step
    echo("1.Make a copy of the file:");
    echo(file_os.copy("test \ test1.txt", "test \ test_copy.txt", false) + "<br>");
     
    //step 2
    echo("2.Delete the previous test file:");
    echo(file_os.delete("test \ test_rename.txt") + "<br>");
     
    //step 3
    echo("3.Rename:");
    echo(file_os.rename("test \ test_copy.txt", "test \ test_rename.txt") + "<br>");
     
    //step 4
    echo("4.Check that the file has been renamed:");
    echo(file_os.is_exist("test \ test_rename.txt") + "<br>");
     
    //end
    echo("<hr> <br>");
     
    //Quit
    app.quit();
  • en/objects/file_os/path_work/rename.txt · Last modified: 2020/10/14 12:26 (external edit)