rename, _wrename

Per rinominare un file o una directory.

int rename(
   const char *oldname,
   const char *newname 
);
int _wrename(
   const wchar_t *oldname,
   const wchar_t *newname 
);

Parametri

• oldname
  Puntatore al nome precedente.

• newname
  Puntatore al nuovo nome.

Valore restituito

Ognuna di queste funzioni restituisce 0 se ha esito positivo.Su un errore, la funzione restituirà un valore diverso da zero e set errno su uno dei seguenti valori:

• EACCES
  File o directory specificata da newname è già presente o non è stato possibile creare (percorso non valido); o oldname è una directory e newname specifica un percorso diverso.

• ENOENT
  File o il percorso specificato da oldname non trovato.

• EINVAL
  Il nome contiene caratteri non validi.

per altri valori restituiti possibili, vedere _doserrno, _errno, syserrlist e _sys_nerr.

Note

rinominare la funzione rinomina il file o la directory specificata da oldname il nome fornito da l newname.Il nome precedente deve essere il percorso di un file o di una directory.Il nuovo nome non deve essere il nome di un file o di una directory.È possibile utilizzare rinominare per spostare un file da una directory o dispositivo a un altro fornendo un percorso diverso in newname argomento.Tuttavia, non è possibile utilizzare rinominare per spostare una directory.Le directory è possibile rinominare, ma non essere spostato.

_wrename è una versione a caratteri estesi di _rename; gli argomenti a _wrename sono le stringhe di caratteri estesi._wrename e _rename comportano in modo identico in caso contrario.

Mapping di routine a testo generico

routine di TCHAR.H	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_trename	rinominare	rinominare	_wrename

Requisiti

routine	Intestazione di associazione
rinominare	<io.h> o <stdio.h>
_wrename	<stdio.h> o <wchar.h>

per informazioni di compatibilità aggiuntive, vedere compatibilità nell'introduzione.

Librerie

Tutte le versioni di Librerie di runtime del linguaggio C.

Esempio

// crt_renamer.c
/* This program attempts to rename a file named
 * CRT_RENAMER.OBJ to CRT_RENAMER.JBO. For this operation
 * to succeed, a file named CRT_RENAMER.OBJ must exist and
 * a file named CRT_RENAMER.JBO must not exist.
 */

#include <stdio.h>

int main( void )
{
   int  result;
   char old[] = "CRT_RENAMER.OBJ", new[] = "CRT_RENAMER.JBO";

   /* Attempt to rename file: */
   result = rename( old, new );
   if( result != 0 )
      printf( "Could not rename '%s'\n", old );
   else
      printf( "File '%s' renamed to '%s'\n", old, new );
}

Output

File 'CRT_RENAMER.OBJ' renamed to 'CRT_RENAMER.JBO'

Equivalente .NET Framework

System:: I:: file:: Spostamento

Vedere anche

Riferimenti

Gestione dei file