C Academy · 강의

CLI 도구 만들기

실용적인 예제를 만들어 봅니다

CLI 도구 만들기은(는) CoddyKit의 무료 C Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 C Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. C Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

하나로 결합하기

이제 인수, 옵션, 분석을 결합하여 작지만 완전한 CLI 도구를 만들어 보겠습니다.

예제는 값을 몇 가지 옵션과 함께 읽은 다음 결과를 출력하는 숫자 서식 지정 유틸리티입니다.

#include <stdio.h>

int main(int argc, char *argv[]) {
    if (argc < 2) {
        printf("Usage: %s <number>\n", argv[0]);
        return 1;
    }
    printf("You passed: %s\n", argv[1]);
    return 0;
}

인터페이스 설계하기

좋은 CLI 도구는 인터페이스를 미리 정의합니다. 여기서는 다음을 지원합니다.

-v 자세한 output
-r N output을 N번 반복
하나의 위치 인수: 출력할 텍스트

#include <stdio.h>

int main(void) {
    printf("Interface: prog [-v] [-r N] <text>\n");
    return 0;
}

설정 선언하기

각 구성 가능한 동작을 적절한 기본값이 있는 변수에 저장합니다. 이렇게 하면 분석과 실제 작업을 분리할 수 있습니다.

#include <stdio.h>

int main(void) {
    int verbose = 0;
    int repeat = 1;
    const char *text = NULL;
    printf("defaults: verbose=%d repeat=%d\n", verbose, repeat);
    return 0;
}

getopt로 분석하기

getopt를 사용하여 플래그를 채웁니다. -r은 값을 받으므로 optstring 항목은 r:입니다.

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

int main(int argc, char *argv[]) {
    int verbose = 0, repeat = 1, opt;
    while ((opt = getopt(argc, argv, "vr:")) != -1) {
        if (opt == 'v') verbose = 1;
        else if (opt == 'r') repeat = atoi(optarg);
    }
    printf("verbose=%d repeat=%d\n", verbose, repeat);
    return 0;
}

위치 인수 읽기

getopt가 끝나면 optind는 첫 번째 옵션이 아닌 인수를 가리킵니다. 그 위치에서 텍스트를 가져옵니다.

없으면 사용법을 출력하고 오류 코드와 함께 종료합니다.

#include <stdio.h>
#include <unistd.h>

int main(int argc, char *argv[]) {
    while (getopt(argc, argv, "vr:") != -1) { }
    if (optind >= argc) {
        printf("Error: missing text argument\n");
        return 1;
    }
    printf("text = %s\n", argv[optind]);
    return 0;
}

숫자 입력 검증하기

견고한 도구는 -r에 적절한 숫자가 전달되었는지 확인합니다. 0 또는 음수인 반복 횟수는 거부합니다.

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

int main(int argc, char *argv[]) {
    int repeat = 1, opt;
    while ((opt = getopt(argc, argv, "r:")) != -1) {
        if (opt == 'r') repeat = atoi(optarg);
    }
    if (repeat < 1) {
        printf("Error: repeat must be >= 1\n");
        return 1;
    }
    printf("repeat = %d\n", repeat);
    return 0;
}

작업 수행하기

설정을 분석하고 검증했으면 실제 작업을 수행합니다. 여기서는 텍스트를 repeat번 출력합니다.

#include <stdio.h>

int main(void) {
    const char *text = "hello";
    int repeat = 3;
    for (int i = 0; i < repeat; i++) {
        printf("%s\n", text);
    }
    return 0;
}

자세한 output

자세한 정보 표시 플래그를 사용하면 진단 정보를 추가할 수 있습니다. 일반 output을 깔끔하게 유지하려면 이러한 출력을 플래그가 설정된 경우에만 수행하세요.

#include <stdio.h>

int main(void) {
    int verbose = 1;
    const char *text = "hi";
    if (verbose) printf("[debug] about to print text\n");
    printf("%s\n", text);
    return 0;
}

완성된 도구

모든 요소를 하나로 연결한 전체 프로그램은 다음과 같습니다. 분석하고, 검증한 다음 실행합니다.

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

int main(int argc, char *argv[]) {
    int verbose = 0, repeat = 1, opt;
    while ((opt = getopt(argc, argv, "vr:")) != -1) {
        if (opt == 'v') verbose = 1;
        else if (opt == 'r') repeat = atoi(optarg);
    }
    if (optind >= argc) { printf("Usage: prog [-v] [-r N] <text>\n"); return 1; }
    const char *text = argv[optind];
    if (verbose) printf("[debug] repeat=%d\n", repeat);
    for (int i = 0; i < repeat; i++) printf("%s\n", text);
    return 0;
}

종료 코드의 중요성

CLI 도구는 종료 코드를 통해 성공 여부를 전달합니다. 성공하면 0을 반환하고, 오류가 발생하면 0이 아닌 값을 반환합니다.

스크립트와 다른 프로그램은 이를 바탕으로 다음에 수행할 작업을 결정합니다.

#include <stdio.h>

int main(int argc, char *argv[]) {
    if (argc < 2) {
        printf("failure\n");
        return 2;
    }
    printf("success\n");
    return 0;
}

stderr에 오류 쓰기

관례상 일반 output은 stdout으로 보내고 오류는 fprintf(stderr, ...)를 통해 stderr로 보냅니다.

이렇게 하면 output을 리디렉션할 때 결과와 진단 정보를 분리할 수 있습니다.

#include <stdio.h>

int main(int argc, char *argv[]) {
    if (argc < 2) {
        fprintf(stderr, "Error: need an argument\n");
        return 1;
    }
    printf("%s\n", argv[1]);
    return 0;
}

빠른 확인

CLI 도구의 관례에 대한 이해도를 확인해 보세요.

복습

완전한 CLI 도구를 만들었습니다.

인터페이스를 정의하고 기본값과 함께 설정을 선언합니다.
getopt로 플래그를 분석하고, optind에서 위치 인수를 읽습니다.
작업을 수행하기 전에 입력을 검증합니다.
의미 있는 종료 코드를 반환하고 오류를 stderr로 보냅니다.

자주 묻는 질문

“CLI 도구 만들기” 강의는 무료인가요?

네 — “CLI 도구 만들기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 C Academy 강의 전체를 잠금 해제할 수 있습니다. C Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“CLI 도구 만들기”에서 뭘 배우나요?

실용적인 예제를 만들어 봅니다 브라우저에서 직접 실행하는 실습 코드로 C Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

C Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 C Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.

“CLI 도구 만들기” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 C Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 C Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

argc와 argv
옵션 파싱
getopt
CLI 도구 만들기

← C Academy(으)로 돌아가기