File Pointers and Modes

In C programming, file pointers and modes are essential concepts for handling files. File pointers are used to point to a file and manage reading and writing operations, while file modes determine the way in which the file is accessed (e.g., reading, writing, or appending).

File Pointers

A file pointer in C is a pointer of type FILE* that is used to manage the position within the file and track open files during program execution. You create a file pointer by using the fopen function, which opens a file and returns a pointer to it.

Syntax:

    FILE *filePointer = fopen("filename", "mode");

Here, filePointer is the file pointer, filename is the name of the file, and mode specifies how the file should be opened.

File Modes

File modes determine how a file is accessed. The most commonly used file modes are:

  • r - Open a file for reading. The file must exist.
  • w - Open a file for writing. Creates a new file if it doesn’t exist, or truncates an existing file.
  • a - Open a file for appending. Creates a new file if it doesn’t exist.
  • r+ - Open a file for both reading and writing. The file must exist.
  • w+ - Open a file for reading and writing. Creates a new file or truncates an existing file.
  • a+ - Open a file for reading and appending. Creates a new file if it doesn’t exist.

Examples of File Modes

1. Opening a File for Reading

When a file is opened with the r mode, it is opened for reading, and the file must already exist.

    #include <stdio.h>

    int main() {
        FILE *file = fopen("example.txt", "r");
        if (file == NULL) {
            printf("Could not open file.\n");
            return 1;
        }
        
        // Reading operations can be performed here
        fclose(file);
        return 0;
    }

2. Opening a File for Writing

When a file is opened with the w mode, it is opened for writing. If the file already exists, its content is erased; if it doesn’t exist, a new file is created.

    #include <stdio.h>

    int main() {
        FILE *file = fopen("example.txt", "w");
        if (file == NULL) {
            printf("Could not open file.\n");
            return 1;
        }
        
        // Writing operations can be performed here
        fclose(file);
        return 0;
    }

3. Opening a File for Appending

When a file is opened with the a mode, it is opened for appending, meaning data will be added to the end of the file without erasing existing content.

    #include <stdio.h>

    int main() {
        FILE *file = fopen("example.txt", "a");
        if (file == NULL) {
            printf("Could not open file.\n");
            return 1;
        }
        
        // Appending operations can be performed here
        fclose(file);
        return 0;
    }

4. Opening a File for Both Reading and Writing

When a file is opened with the r+ mode, it is opened for both reading and writing. The file must already exist.

    #include <stdio.h>

    int main() {
        FILE *file = fopen("example.txt", "r+");
        if (file == NULL) {
            printf("Could not open file.\n");
            return 1;
        }
        
        // Reading and writing operations can be performed here
        fclose(file);
        return 0;
    }

Checking if a File Opened Successfully

After opening a file, it's important to check if the file pointer is NULL. If fopen fails to open the file (e.g., if the file does not exist in read mode), it returns NULL. 

    #include <stdio.h>

    int main() {
        FILE *file = fopen("nonexistent.txt", "r");
        if (file == NULL) {
            printf("File could not be opened.\n");
        } else {
            printf("File opened successfully.\n");
            fclose(file);
        }
        return 0;
    }

Closing a File

Once you are done with a file, you should close it using the fclose function. This releases the file and ensures any buffered data is saved to the disk. 

    #include <stdio.h>

    int main() {
        FILE *file = fopen("example.txt", "w");
        if (file != NULL) {
            // Perform operations
            fclose(file);
            printf("File closed successfully.\n");
        }
        return 0;
    }

Example: Writing and Reading a File Using Different Modes

The following example demonstrates opening a file for writing, adding content, then reopening it for reading to retrieve the content. 

    #include <stdio.h>

    int main() {
        // Opening file for writing
        FILE *file = fopen("sample.txt", "w");
        if (file == NULL) {
            printf("Could not open file.\n");
            return 1;
        }
        fputs("Hello, World!\n", file);
        fclose(file); // Close after writing

        // Reopening file for reading
        file = fopen("sample.txt", "r");
        if (file == NULL) {
            printf("Could not open file.\n");
            return 1;
        }
        
        char line[100];
        while (fgets(line, sizeof(line), file) != NULL) {
            printf("%s", line); // Display each line read
        }

        fclose(file); // Close after reading
        return 0;
    }

Key Points to Remember

  • A file pointer of type FILE* is required to perform file operations.
  • fopen is used to open files in various modes such as r, w, and a.
  • Always check if the file opened successfully by testing if the file pointer is NULL.
  • fclose should be used to close files after operations to free resources.

Conclusion

File pointers and modes are fundamental concepts for handling files in C. By using file pointers, you can access and manipulate files, while file modes allow you to specify the type of access you need. Understanding these concepts is essential for effective file handling in C, enabling you to work with persistent data storage.





Advertisement