Rust 구조체와 열거형 | Struct, Enum, Pattern Matching

시리즈 안내

#03 | 📋 전체 목차 | 이전: #02 소유권 · 다음: #04 에러 처리

---

들어가며

구조체·열거형(여러 경우 중 하나를 값으로 나타내는 타입)은 필드를 이름 붙여 묶는 Rust의 기본 재료입니다. 소유권 규칙(값의 열쇠가 누구에게 있는지) 위에서 타입을 설계한다는 점만 기억하시면 됩니다. C++에서는 필드에 Box·Rc에 해당하는 개념을 스마트 포인터와 RAII로 표현하고, 필드 간 이동은 이동 의미론과 연결됩니다. 소유권 기초는 이전 글을, 메모리 결함·도구는 메모리 누수 가이드, Valgrind, 누수 탐지 실전을 참고하면 비교하기 좋습니다.

Rust와의 첫 만남

“빌려주기 검사기(Borrow Checker)와 싸우는 게 프로그래밍의 반”이라는 농담이 있을 정도로, Rust는 처음에 정말 어렵습니다. 저도 첫 프로젝트에서 컴파일러 에러와 씨름하며 “이게 정말 생산성이 높은 언어인가?” 의심했습니다. 하지만 몇 주간 고생 끝에 컴파일이 통과된 코드는 런타임 에러가 거의 없다는 걸 깨달았습니다. C++에서는 세그멘테이션 폴트가 프로덕션에서 터지는 악몽을 자주 겪었는데, Rust는 그런 걱정이 없습니다. 컴파일러가 미리 잡아주니까요. 특히 멀티스레드 코드를 작성할 때 이 차이가 극명합니다. C++에서는 데이터 레이스를 찾느라 디버거와 씨름했지만, Rust는 컴파일 단계에서 “이 코드는 스레드 안전하지 않아”라고 알려줍니다. 처음엔 답답했지만, 지금은 이 엄격함이 감사합니다.

1. 구조체 (Struct)

기본 구조체

struct User {
    name: String,
    age: u32,
    email: String,
}
fn main() {
    let user = User {
        name: String::from("홍길동"),
        age: 25,
        email: String::from("[email protected]"),
    };
    
    println!("이름: {}", user.name);
    println!("나이: {}", user.age);
}

구조체 업데이트

let user1 = User {
    name: String::from("홍길동"),
    age: 25,
    email: String::from("[email protected]"),
};
// 일부 필드만 변경
let user2 = User {
    name: String::from("김철수"),
    ..user1  // 나머지는 user1에서 복사
};

튜플 구조체

struct Color(i32, i32, i32);
struct Point(i32, i32);
let black = Color(0, 0, 0);
let origin = Point(0, 0);
println!("R: {}, G: {}, B: {}", black.0, black.1, black.2);

유닛 구조체

struct AlwaysEqual;
let subject = AlwaysEqual;

---

2. 메서드 (impl)

기본 메서드

Rust의 메서드는 impl 블록 안에 정의합니다:

impl User {
    // 1. 연관 함수 (Associated Function) - 생성자 패턴
    fn new(name: String, age: u32, email: String) -> Self {
        // self 매개변수 없음 (인스턴스 불필요)
        // Self: User 타입의 별칭 (타입 이름 반복 방지)
        // User::new()로 호출 (::는 연관 함수 호출)
        User { name, age, email }
        // 필드 초기화 단축 문법 (name: name → name)
    }
    
    // 2. 불변 참조 메서드 (&self)
    fn introduce(&self) {
        // &self: 인스턴스를 불변 참조로 빌림
        // 읽기만 가능, 수정 불가
        // 소유권을 가져가지 않음 (호출 후에도 사용 가능)
        println!("{}입니다. {}세입니다.", self.name, self.age);
    }
    
    // 3. 가변 참조 메서드 (&mut self)
    fn birthday(&mut self) {
        // &mut self: 인스턴스를 가변 참조로 빌림
        // 수정 가능
        // 소유권을 가져가지 않음
        self.age += 1;  // age 필드 수정
    }
    
    // 4. 소유권 이동 메서드 (self)
    fn into_name(self) -> String {
        // self: 인스턴스의 소유권을 가져감
        // 호출 후 원본 인스턴스는 사용 불가
        // 필드를 이동시켜 반환할 때 사용
        self.name
        // name의 소유권이 호출자에게 이동
        // user는 더 이상 유효하지 않음
    }
}
fn main() {
    // 연관 함수로 인스턴스 생성
    let mut user = User::new(
        String::from("홍길동"),
        25,
        String::from("[email protected]")
    );
    // mut: 가변 변수 (birthday 메서드 호출 위해 필요)
    
    // 불변 참조 메서드 호출
    user.introduce();  // 홍길동입니다. 25세입니다.
    // user는 여전히 유효 (빌렸다가 반환)
    
    // 가변 참조 메서드 호출
    user.birthday();  // age가 26으로 증가
    println!("생일 후 나이: {}", user.age);  // 26
    
    // 소유권 이동 메서드 호출
    let name = user.into_name();  // user의 소유권 이동
    println!("이름: {}", name);   // 홍길동
    
    // println!("{}", user.age);  // ❌ 컴파일 에러!
    // 에러: borrow of moved value: `user`
    // user는 into_name()에서 소유권을 잃어 더 이상 사용 불가
}

메서드 호출 방식 비교:

// 연관 함수: Type::function()
let user = User::new(...);
// 메서드: instance.method()
user.introduce();
user.birthday();
// Rust는 자동으로 참조/역참조
// user.introduce() → (&user).introduce()
// 명시적으로 &를 쓸 필요 없음

여러 impl 블록

impl User {
    fn new(name: String, age: u32, email: String) -> Self {
        User { name, age, email }
    }
}
impl User {
    fn introduce(&self) {
        println!("{}", self.name);
    }
}

---

3. 열거형 (Enum)

기본 열거형

enum Status {
    Active,
    Inactive,
    Pending,
}
fn main() {
    let status = Status::Active;
    
    match status {
        Status::Active => println!("활성"),
        Status::Inactive => println!("비활성"),
        Status::Pending => println!("대기"),
    }
}

데이터를 가진 열거형

Rust의 열거형은 각 variant가 서로 다른 타입의 데이터를 가질 수 있습니다:

// 열거형 정의: 4가지 메시지 타입
enum Message {
    // 1. 데이터 없는 variant
    Quit,
    
    // 2. 구조체 스타일 (named fields)
    Move { x: i32, y: i32 },
    // x, y: 필드 이름으로 접근
    
    // 3. 튜플 스타일 (unnamed fields)
    Write(String),
    // 0번 인덱스로 접근
    
    // 4. 여러 값을 가진 튜플
    ChangeColor(i32, i32, i32),
    // RGB 값 (r, g, b)
}
impl Message {
    fn call(&self) {
        // match: 모든 variant를 처리 (필수)
        match self {
            // 1. 데이터 없는 variant
            Message::Quit => println!("종료"),
            
            // 2. 구조체 스타일: 필드 이름으로 추출
            Message::Move { x, y } => {
                // x, y: 패턴 매칭으로 필드 값 추출
                println!("이동: ({}, {})", x, y)
            },
            
            // 3. 튜플 스타일: 변수로 추출
            Message::Write(text) => {
                // text: String 값 추출
                println!("메시지: {}", text)
            },
            
            // 4. 여러 값 추출
            Message::ChangeColor(r, g, b) => {
                // r, g, b: 각 i32 값 추출
                println!("색상: RGB({}, {}, {})", r, g, b)
            },
        }
        // match는 모든 경우를 처리해야 함 (exhaustive)
        // 하나라도 빠뜨리면 컴파일 에러
    }
}
fn main() {
    // 각 variant 생성
    let msg1 = Message::Write(String::from("hello"));
    // Write variant에 String 데이터 포함
    
    let msg2 = Message::Move { x: 10, y: 20 };
    // Move variant에 x, y 필드 포함
    
    let msg3 = Message::ChangeColor(255, 0, 0);
    // ChangeColor variant에 RGB 값 포함
    
    let msg4 = Message::Quit;
    // Quit variant (데이터 없음)
    
    // 메서드 호출
    msg1.call();  // 메시지: hello
    msg2.call();  // 이동: (10, 20)
    msg3.call();  // 색상: RGB(255, 0, 0)
    msg4.call();  // 종료
}

열거형의 강점:

// C/Java의 enum: 단순 상수
// enum Status { ACTIVE, INACTIVE }
// Rust의 enum: 각 variant가 다른 타입 데이터 보유
enum Result<T, E> {
    Ok(T),      // 성공 시 T 타입 값
    Err(E),     // 실패 시 E 타입 에러
}
// 타입 안전성: 컴파일 타임에 모든 경우 체크
// match를 사용하면 모든 variant 처리 강제

실전 예시: HTTP 응답:

enum HttpResponse {
    Ok(String),                    // 200: 응답 본문
    NotFound,                      // 404: 데이터 없음
    ServerError { code: u16, msg: String },  // 500: 에러 정보
}
fn handle_response(response: HttpResponse) {
    match response {
        HttpResponse::Ok(body) => {
            println!("성공: {}", body);
        },
        HttpResponse::NotFound => {
            println!("404: 페이지를 찾을 수 없습니다");
        },
        HttpResponse::ServerError { code, msg } => {
            println!("서버 에러 {}: {}", code, msg);
        },
    }
}

---

4. Option

Option 사용

fn divide(a: i32, b: i32) -> Option<i32> {
    if b == 0 {
        None
    } else {
        Some(a / b)
    }
}
fn main() {
    let result = divide(10, 2);
    
    match result {
        Some(value) => println!("결과: {}", value),
        None => println!("0으로 나눌 수 없음"),
    }
    
    // unwrap_or로 기본값
    let result2 = divide(10, 0).unwrap_or(0);
    println!("결과: {}", result2);
}

Option 메서드

let x: Option<i32> = Some(5);
// map
let y = x.map(|v| v * 2);  // Some(10)
// and_then
let z = x.and_then(|v| Some(v + 1));  // Some(6)
// unwrap_or
let value = x.unwrap_or(0);  // 5
// unwrap_or_else
let value2 = x.unwrap_or_else(|| {
    println!("기본값 사용");
});

---

5. Result<T, E>

Result 사용

fn divide_result(a: i32, b: i32) -> Result<i32, String> {
    if b == 0 {
        Err(String::from("0으로 나눌 수 없음"))
    } else {
        Ok(a / b)
    }
}
fn main() {
    match divide_result(10, 2) {
        Ok(value) => println!("결과: {}", value),
        Err(e) => println!("에러: {}", e),
    }
}

? 연산자

fn read_file() -> Result<String, std::io::Error> {
    let content = std::fs::read_to_string("file.txt")?;
    Ok(content)
}

---

6. 패턴 매칭 (match)

기본 매칭

fn main() {
    let number = 7;
    
    match number {
        1 => println!("하나"),
        2 | 3 | 5 | 7 => println!("소수"),
        4..=10 => println!("4~10"),
        _ => println!("기타"),
    }
}

Option 매칭

fn print_value(opt: Option<i32>) {
    match opt {
        Some(value) => println!("값: {}", value),
        None => println!("값 없음"),
    }
}

if let (간단한 매칭)

let some_value = Some(5);
// match 대신 if let
if let Some(value) = some_value {
    println!("값: {}", value);
}
// else 추가 가능
if let Some(value) = some_value {
    println!("값: {}", value);
} else {
    println!("값 없음");
}

---

7. 실전 예제

예제: 사용자 시스템

#[derive(Debug)]
struct User {
    id: u32,
    name: String,
    email: String,
    active: bool,
}
impl User {
    fn new(id: u32, name: String, email: String) -> Self {
        User {
            id,
            name,
            email,
            active: true,
        }
    }
    
    fn deactivate(&mut self) {
        self.active = false;
    }
    
    fn is_active(&self) -> bool {
        self.active
    }
}
fn main() {
    let mut user = User::new(
        1,
        String::from("홍길동"),
        String::from("[email protected]")
    );
    
    println!("{:?}", user);
    
    user.deactivate();
    println!("활성 상태: {}", user.is_active());
}

예제: 도형 계산

enum Shape {
    Circle { radius: f64 },
    Rectangle { width: f64, height: f64 },
    Triangle { base: f64, height: f64 },
}
impl Shape {
    fn area(&self) -> f64 {
        match self {
            Shape::Circle { radius } => std::f64::consts::PI * radius * radius,
            Shape::Rectangle { width, height } => width * height,
            Shape::Triangle { base, height } => 0.5 * base * height,
        }
    }
}
fn main() {
    let shapes = vec![
        Shape::Circle { radius: 5.0 },
        Shape::Rectangle { width: 10.0, height: 20.0 },
        Shape::Triangle { base: 8.0, height: 12.0 },
    ];
    
    for shape in shapes {
        println!("넓이: {:.2}", shape.area());
    }
}

---

정리

핵심 요약

1. struct: 데이터 구조, impl로 메서드 추가
2. enum: 여러 가능한 값, 데이터 포함 가능
3. Option: Some/None, Null 안전성
4. Result: Ok/Err, 에러 처리
5. match: 패턴 매칭, 모든 경우 처리

다음 단계

• Rust 에러 처리
• Rust 트레이트
• Rust 컬렉션

---

관련 글

• Swift 클래스와 구조체 | Class, Struct, Enum
• C++ Aggregate Initialization |
• C++ Aggregate Initialization 완벽 가이드 | 집합 초기화
• C++ struct vs class |
• C++20 Designated Initializers 완벽 가이드 | 명확한 구조체 초기화

심화 부록: 구현·운영 관점

이 부록은 앞선 본문에서 다룬 주제(「Rust 구조체와 열거형 | Struct, Enum, Pattern Matching」)를 구현·런타임·운영 관점에서 다시 압축합니다. 도메인별 세부 구현은 글마다 다르지만, 입력 검증 → 핵심 연산 → 부작용(I/O·네트워크·동시성) → 관측의 흐름으로 장애를 나누면 원인 추적이 빨라집니다.

내부 동작과 핵심 메커니즘

flowchart TD
  A[입력·요청·이벤트] --> B[파싱·검증·디코딩]
  B --> C[핵심 연산·상태 전이]
  C --> D[부작용: I/O·네트워크·동시성]
  D --> E[결과·관측·저장]

sequenceDiagram
  participant C as 클라이언트/호출자
  participant B as 경계(런타임·게이트웨이·프로세스)
  participant D as 의존성(API·DB·큐·파일)
  C->>B: 요청/이벤트
  B->>D: 조회·쓰기·RPC
  D-->>B: 지연·부분 실패·재시도 가능
  B-->>C: 응답 또는 오류(코드·상관 ID)

• 불변 조건(Invariant): 버퍼 경계, 프로토콜 상태, 트랜잭션 격리, FD 상한 등 단계별로 문장으로 적어 두면 디버깅 비용이 줄어듭니다.
• 결정성: 순수 층과 시간·네트워크·스케줄에 의존하는 층을 분리해야 테스트와 장애 분석이 쉬워집니다.
• 경계 비용: 직렬화, 인코딩, syscall 횟수, 락 경합, 할당·GC, 캐시 미스를 의심 목록에 둡니다.
• 백프레셔: 생산자가 소비자보다 빠를 때 버퍼·큐·스트림에서 속도를 줄이는 신호를 어디에 둘지 정의합니다.

프로덕션 운영 패턴

영역	운영 관점 질문
관측성	요청 단위 상관 ID, 에러율·지연 p95/p99, 의존성 타임아웃·재시도가 대시보드에 보이는가
안전성	입력 검증·권한·비밀·감사 로그가 코드 경로마다 일관적인가
신뢰성	재시도는 멱등 연산에만 적용되는가, 서킷 브레이커·백오프·DLQ가 있는가
성능	캐시·배치 크기·커넥션 풀·인덱스·백프레셔가 데이터 규모에 맞는가
배포	롤백 룬북, 카나리/블루그린, 마이그레이션·피처 플래그가 문서화되어 있는가
용량	피크 트래픽·디스크·FD·스레드 풀 상한을 주기적으로 검증하는가

스테이징은 데이터 양·네트워크 RTT·동시성을 프로덕션에 가깝게 맞출수록 재현율이 올라갑니다.

확장 예시: 엔드투엔드 미니 시나리오

앞선 본문 주제(「Rust 구조체와 열거형 | Struct, Enum, Pattern Matching」)를 배포·운영 흐름에 맞춰 옮긴 체크리스트입니다. 도메인에 맞게 단계 이름만 바꿔 적용할 수 있습니다.

1. 입력 계약 고정: 스키마·버전·최대 페이로드·타임아웃·에러 코드를 경계에 둔다.
2. 핵심 경로 계측: 요청 ID, 단계별 지연, 외부 호출 결과 코드를 로그·메트릭·트레이스에서 한 흐름으로 본다.
3. 실패 주입: 의존성 타임아웃·5xx·부분 데이터·락 대기를 스테이징에서 재현한다.
4. 호환·롤백: 설정/마이그레이션/클라이언트 버전을 되돌릴 수 있는지 확인한다.
5. 부하 후 검증: 피크 대비 p95/p99, 에러율, 리소스 상한, 알림 임계값을 점검한다.

handle(request):
  ctx = newCorrelationId()
  validated = validateSchema(request)
  authorize(validated, ctx)
  result = domainCore(validated)
  persistOrEmit(result, idempotentKey)
  recordMetrics(ctx, latency, outcome)
  return result

문제 해결(Troubleshooting)

증상	가능 원인	조치
간헐적 실패	레이스, 타임아웃, 외부 의존성, DNS	최소 재현 스크립트, 분산 트레이스·로그 상관관계, 재시도·서킷 설정 점검
성능 저하	N+1, 동기 I/O, 락 경합, 과도한 직렬화, 캐시 미스	프로파일러·APM으로 핫스팟 확인 후 한 가지씩 제거
메모리 증가	캐시 무제한, 구독/리스너 누수, 대용량 버퍼, 커넥션 미반납	상한·TTL·힙/FD 스냅샷 비교
빌드·배포만 실패	환경 변수, 권한, 플랫폼 차이, lockfile	CI 로그와 로컬 diff, 런타임·이미지 버전 핀
설정 불일치	프로필·시크릿·기본값, 리전	스키마 검증된 설정 단일 소스와 배포 매트릭스 표준화
데이터 불일치	비멱등 재시도, 부분 쓰기, 캐시 무효화 누락	멱등 키·아웃박스·트랜잭션 경계 재검토

권장 순서: (1) 최소 재현 (2) 최근 변경 범위 축소 (3) 환경·의존성 차이 (4) 관측으로 가설 검증 (5) 수정 후 회귀·부하 테스트.

배포 전에는 git add → git commit → git push 후 npm run deploy 순서를 권장합니다.

---

자주 묻는 질문 (FAQ)

Q. 이 내용을 실무에서 언제 쓰나요?

A. Rust 구조체와 열거형: Struct, Enum, Pattern Matching. 구조체 (Struct)·메서드 (impl)로 흐름을 잡고 원리·코드·실무 적용을 한글로 정리합니다. Start now. 실무에서는 위 본문의 예제와 선택 가이드를 참고해 적용하면 됩니다.

Q. 선행으로 읽으면 좋은 글은?

A. 각 글 하단의 이전 글 또는 관련 글 링크를 따라가면 순서대로 배울 수 있습니다. C++ 시리즈 목차에서 전체 흐름을 확인할 수 있습니다.

Q. 더 깊이 공부하려면?

A. cppreference와 해당 라이브러리 공식 문서를 참고하세요. 글 말미의 참고 자료 링크도 활용하면 좋습니다.

---

같이 보면 좋은 글 (내부 링크)

이 주제와 연결되는 다른 글입니다.

• Rust 소유권 | Ownership, Borrowing, Lifetime
• Rust 에러 처리 | Result, Option, ? 연산자
• C++ 스마트 포인터 | 3일 동안 찾지 못한 순환 참조 버그 해결법
• C++ RAII | ‘파일을 열 수 없습니다’ 장애의 원인과 자동 리소스 관리
• C++ Move Semantics | std::move로 불필요한 복사 제거하고 성능 최적화
• C++ 메모리 누수 완벽 가이드 | 5가지 원인과 해결 방법 (Valgrind/ASan)
• C++ Valgrind 완벽 가이드 | 메모리 누수 탐지와 디버깅 (실전 예제)
• C++ 메모리 누수 찾기 | Valgrind·ASan으로 ‘leak 0 bytes’ 만들기

---

이 글에서 다루는 키워드 (관련 검색어)

Rust, Struct, Enum, 패턴매칭 등으로 검색하시면 이 글이 도움이 됩니다.