C 언어에서 현재 파일 위치를 건드리지 않고 특정 위치에 기록하려면 pwrite()를 쓴다.

인수와 옵션의 의미

fd는 대상 파일이나 통신 번호다.
buf는 read 계열에서는 결과를 받을 쓰기 가능한 공간이고 write 계열에서는 보낼 내용이다.
count는 원소 수가 아니라 바이트 수다.
pread()와 pwrite()의 offset은 파일 시작부터의 바이트 위치이며 공유 현재 위치를 바꾸지 않는다.
읽기의 0은 보통 EOF지만 UDP에서는 빈 데이터그램도 가능하다.
쓰기가 일부만 성공하면 남은 구간을 이어 처리한다.

직접 실행할 코드

#define _GNU_SOURCE
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <fcntl.h>
#include <sys/file.h>
#include <sys/stat.h>
#include <sys/uio.h>

int main(void) {
    FILE *fp = tmpfile();
    if (!fp)
        return 1;
    if (fputs("abcdef", fp) == EOF || fflush(fp) == EOF) {
        fclose(fp);
        return 1;
    }
    int fd = fileno(fp);
    if (fd < 0) {
        fclose(fp);
        return 1;
    }
    ssize_t n = pwrite(fd, "XY", 2, 0);
    if (n < 0) {
        fclose(fp);
        return 1;
    }
    printf("written=%zd\n", n);
    if (fclose(fp) == EOF)
        return 1;
    return 0;
}

실행 출력

written=2

현재 파일 위치가 끝에 있어도 offset 0에 XY를 쓴다.
원래 파일 위치는 그대로다.

호출 순서에서 볼 부분

buffer는 호출 동안 유효한 배열이다.
쓰기 예제라면 미리 내용을 채워 둔다.
한 번에 배열 전체가 처리된다고 가정하지 않고 실제 반환 길이를 다음 작업의 기준으로 삼는다.

반환값과 실패 처리

실제 기록 바이트 수를 반환하고 오류는 -1이다.
부분 쓰기를 처리해야 한다.

offset은 바이트 단위다.
리눅스에서 O_APPEND로 연 파일은 지정 위치 대신 파일 끝에 기록되는 문제가 있으므로 위치 기록용 파일의 열기 모드를 구분한다.

빌드하고 출력 확인하기

위 코드를 example.c로 저장한다.
-std=c11은 언어 기준이고 -Wall과 -Wextra는 경고를 켠다.
-lm은 수학 라이브러리 링크이며 소스 파일 뒤에 둔다.
커널 기능이나 libc 확장 함수는 설치 환경의 지원 조건도 맞아야 한다.

gcc -std=c11 -Wall -Wextra example.c -lm -o example
./example

참고: pwrite — Linux man-pages