rename.c

Go to the documentation of this file.

/*!
 * \file lib/gis/rename.c
 *
 * \brief GIS Library - Rename file functions.
 *
 * (C) 2001-2015 by the GRASS Development Team
 *
 * This program is free software under the GNU General Public License
 * (>=v2). Read the file COPYING that comes with GRASS for details.
 *
 * \author Original author CERL
 */

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <grass/gis.h>


/*!
  \brief Rename a file or a directory in the filesystem.
  
  The file or directory <i>oldname</i> is renamed to <i>newname</i>.

  \param oldname current name
  \param newname new name
  
  \return 0 if successful
  \return -1 on error
*/
int G_rename_file(const char *oldname, const char *newname)
{
    int ret;

#ifdef __MINGW32__
    remove(newname);
#endif
    
    ret = rename(oldname, newname);

    if (ret == -1) {
        /* if fails, try to copy file and then remove */
        if (1 == G_copy_file(oldname, newname)) {
            if (remove(oldname) != -1)
                ret = 0;
        }
    }

    return ret;
}

/*!
  \brief Rename a database file.

  The file or directory <i>oldname</i> under the database <i>element</i>
  directory in the current mapset is renamed to <i>newname</i>.

  \bug This routine does not check to see if the <i>newname</i> 
  name is a valid database file name.

  \param element element name
  \param oldname current name
  \param newname new name

  \return 0 if <i>oldname</i> does not exist
  \return 1 if successful
  \return -1 on error
*/
int G_rename(const char *element, const char *oldname, const char *newname)
{
    const char *mapset;
    char xname[GNAME_MAX], xmapset[GMAPSET_MAX];
    char from[GPATH_MAX], to[GPATH_MAX];

    /* name in mapset legal only if mapset is current mapset */
    mapset = G_mapset();
    if (G_name_is_fully_qualified(oldname, xname, xmapset)
        && strcmp(mapset, xmapset))
        return -1;
    if (G_name_is_fully_qualified(newname, xname, xmapset)
        && strcmp(mapset, xmapset))
        return -1;

    /* if file does not exist return 0 */
    if (access(G_file_name(from, element, oldname, mapset), 0) != 0)
        return 0;

    G_file_name(to, element, newname, mapset);

    /* return result of rename */
    return G_rename_file(from, to) == 0 ? 1 : -1;
}