Rename a known file.

C: The standard rename function reports failure through its return value.

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <ctype.h>
#include <stdint.h>
#include <stdbool.h>
#include <errno.h>
#include <limits.h>
#include <math.h>
#include <time.h>

int main(void) {
    if (rename("draft.txt","final.txt")!=0) return 1;
    FILE *file=fopen("final.txt","r");
    if (file==NULL) return 1;
    char text[32];
    if (fgets(text,sizeof text,file)==NULL) { fclose(file); return 1; }
    puts(text);
    fclose(file);
    return 0;
}

Expected output EXAMPLE

draft

Details

Save as snippet.c; compile with gcc -std=c17 -Wall -Wextra snippet.c -lm -o snippet, then run ./snippet. The standard rename function reports failure through its return value.

Keep in mind

Choose an unused destination; existing-destination behavior can differ by platform.

✓ Verified

Tested on Ubuntu 24.04.5 LTS · 2026-11-02 18:02:36 UTC · gcc (Ubuntu 13.3.0-6ubuntu2~24.04.1) 13.3.0 · gcc 4:13.2.0-7ubuntu1

Test inputs, results and environment

The exact published code ran in a dedicated Linux test container with prepared inputs. Unprivileged snippet process, external networking disabled, read-only root filesystem, and a fresh temporary working directory. Fixtures and output records are isolated from the application database. Testing covers this example and its stated checks, not every input, operating system, or runtime version. The Linux container shares its host's kernel; this is not a native Windows test.

Architecture / host kernel: x86_64 / 6.18.54.1-microsoft-standard-WSL2
Snippet identity / locale: uid=65534, gid=65534 (unprivileged) / C.UTF-8
Interpreter invocation: gcc -std=c17 -Wall -Wextra -Werror snippet.c -lm -o snippet && ./snippet
Container image ID: sha256:32dc2d998158b6554c99b73b533f423696a0f3e31e8cbea9db10b5eee9a2fadd
Code SHA-256: 1de876d27721a2a8acb7e3d67934f06277f3e5f5169da40b07f2ada136ba3aaf
Dependencies: gcc 4:13.2.0-7ubuntu1

Test input setup

These are the prepared inputs used by the test harness. See Details above for the prerequisites and how to run this example.

printf draft > draft.txt

Observed standard output

draft

Exit code: 0. Standard error: empty. Validation: Exact stdout comparison. System-dependent values above are one recorded run.

Additional assertions that passed

Checks recorded by the test harness. Where Python assertions are shown, browser cases use Playwright and simulator cases may inspect pin transitions: result.stdout is captured output, work is the temporary directory, and Path is pathlib.Path. The harness also imports json and csv.

assert not Path('draft.txt').exists() and Path('final.txt').read_text() == 'draft'