Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

remove — odstranění souboru

Funkce remove z <stdio.h> odebere přístup k souboru pod zadaným názvem. Při úspěchu vrací nulu a při chybě nenulovou hodnotu.

Verze: C23; repository compiler flag, production runtime not attested

Syntaxe

#include <stdio.h>
int remove(const char *filename);

Po úspěšném volání remove(filename) už soubor není přístupný pod názvem zadaným řetězcem filename. Soubor pod tímto názvem lze později přesto otevřít, například pokud byl na uvolněný název přejmenován jiný existující soubor.

Výsledek ověřujte porovnáním s 0; nepředpokládejte, že chyba znamená konkrétně -1. Chování při otevřeném souboru je definováno implementací, proto před odstraněním zavřete proud.

Příklad vytvoří prázdný soubor pomocí "wx", zavře jej a odstraní. Spouštějte jej v izolovaném testovacím adresáři.

Příklady

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    const char *name = "cktis-remove-demo.tmp";
    FILE *file = fopen(name, "wx");
    if (file == NULL) {
        fputs("create failed\n", stderr);
        return EXIT_FAILURE;
    }
    if (fclose(file) != 0) {
        fputs("close failed\n", stderr);
        return EXIT_FAILURE;
    }
    if (remove(name) != 0) {
        fputs("remove failed\n", stderr);
        return EXIT_FAILURE;
    }
    puts("removed");
    return EXIT_SUCCESS;
}

Výsledek

removed

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje