folly::ScopeGuard·SCOPE_EXIT — RAII cleanup
#한 줄 요약
SCOPE_EXIT는 scope가 끝날 때(정상이든 예외든) 람다를 실행하는 매크로다. C API를 감싸거나 unique_ptr를 만들기 부담스러운 일회성 cleanup에 가장 잘 맞는다. RAII class를 매번 만드는 보일러플레이트를 한 줄로 줄인다.
#동기 — C API와 cleanup 보일러플레이트
C API를 C++에서 쓰면 cleanup이 까다롭다.
// 회피FILE* f = fopen("data", "rb");if (!f) return;char* buf = (char*)malloc(1024);if (!buf) { fclose(f); return; } // cleanup 중복auto n = fread(buf, 1, 1024, f);if (n == 0) { free(buf); fclose(f); return; } // 또 중복// ...free(buf);fclose(f);cleanup 코드가 모든 early return마다 반복된다. 잊으면 leak. 예외라도 던지면 더 복잡.
전통적 해법.
- unique_ptr with custom deleter: 깔끔하지만 type 정의가 매번 필요.
- RAII wrapper class: 일회성이라면 과한 보일러플레이트.
ScopeGuard는 그 중간이다. 한 줄의 람다로 정리.
#API
#include <folly/ScopeGuard.h>
FILE* f = fopen("data", "rb");if (!f) return;SCOPE_EXIT { fclose(f); };
char* buf = (char*)malloc(1024);if (!buf) return; // SCOPE_EXIT가 fclose(f)SCOPE_EXIT { free(buf); };
// ... 작업// scope 끝: free → fclose 순서로 자동SCOPE_EXIT { ... };는 매크로다. 등록 시점부터 scope 종료까지 람다를 보관하다가, 종료 시점(정상/예외 모두) 실행.
#RAII 원리 — 그림
SCOPE_EXIT는 익명 RAII 객체를 만드는 macro다. 동작은 일반 RAII와 같다.
정상 return이든 throw든 scope를 빠져나가면 destructor가 호출된다 — 그래서 goto cleanup 사다리가 필요 없다.
#dismissible variant — makeGuard
auto guard = folly::makeGuard([&]{ rollback(); });doStep1();doStep2();guard.dismiss(); // 모든 step 성공 → rollback 취소명시적으로 dismiss할 수 있는 guard. 트랜잭션 패턴에 유용.
#SCOPE_FAIL / SCOPE_SUCCESS
SCOPE_FAIL { rollback(); }; // 예외로 종료 시만SCOPE_SUCCESS { commit(); }; // 정상 종료 시만내부적으로 std::uncaught_exceptions()로 종료 경로를 구분.
#내부 구현
template <typename F>class ScopeGuardImpl { F func_; bool dismissed_ = false;public: ScopeGuardImpl(F&& f) : func_(std::move(f)) {} ~ScopeGuardImpl() noexcept { if (!dismissed_) { try { func_(); } catch (...) { /* swallow */ } } } void dismiss() { dismissed_ = true; }};
#define SCOPE_EXIT \ auto SCOPE_EXIT_VAR(__LINE__) = ::folly::detail::ScopeGuardOnExit() + [&]() noexcept매크로의 +가 트릭이다. ScopeGuardOnExit이라는 dummy 객체에 람다를 operator+로 결합 → 결과를 auto 변수에 저장. 변수가 scope 끝에 소멸하며 람다 실행.
#예외 안전
~ScopeGuardImpl은 noexcept(true) 안에서 try-catch로 람다 예외를 삼킨다. 람다가 throw해도 stack unwinding 중 또 다른 예외가 안 됨. C++의 “소멸자에서 throw 금지” 원칙 준수.
#사용 패턴
#자원 해제
auto* socket = create_socket();SCOPE_EXIT { destroy_socket(socket); };
auto* mmap = ::mmap(...);SCOPE_EXIT { ::munmap(mmap, size); };#lock 해제 (mutex 외 케이스)
hardware_lock();SCOPE_EXIT { hardware_unlock(); };mutex라면 lock_guard가 더 낫다. 일회성 lock API에 SCOPE_EXIT.
#트랜잭션 rollback
auto guard = folly::makeGuard([&]{ db.rollback(); });db.begin();db.execute(query1);db.execute(query2);db.commit();guard.dismiss();commit 후 dismiss. 중간에 예외나 early return이면 rollback 자동.
#디버그 로깅
LOG(INFO) << "entering critical section";SCOPE_EXIT { LOG(INFO) << "leaving critical section"; };enter/leave가 한 곳에 있어 가독성 좋음.
#std / abseil 비교
| 기능 | std | folly |
|---|---|---|
| RAII helper | manual class | ScopeGuard |
| scope-exit | C++23 stdlib에 없음 | SCOPE_EXIT |
| dismiss | manual | makeGuard.dismiss() |
| exit/fail/success 구분 | 없음 | SCOPE_FAIL / SCOPE_SUCCESS |
| Abseil | absl::Cleanup | 동일 개념 |
absl::Cleanup이 가장 가까운 비교 대상이다. auto c = absl::MakeCleanup([&]{ ... }); 패턴으로 folly의 makeGuard와 같다. SCOPE_EXIT 같은 매크로 단축형은 Abseil에 없다.
C++26에 std::scope_exit 제안이 있지만 표준화는 미정.
#코드 리뷰 포인트
#1. unique_ptr vs SCOPE_EXIT
// unique_ptr — type 정의 가능, 반복 사용struct FileCloser { void operator()(FILE* f) { fclose(f); } };std::unique_ptr<FILE, FileCloser> f(fopen(...));
// SCOPE_EXIT — 일회성, 짧음FILE* f = fopen(...);SCOPE_EXIT { fclose(f); };같은 cleanup을 여러 곳에서 쓰면 unique_ptr custom deleter, 일회성이면 SCOPE_EXIT.
#2. SCOPE_EXIT 안에서 throw
// 회피SCOPE_EXIT { mayThrow(); }; // 람다가 throw하면 ScopeGuard가 삼킴람다는 noexcept로 작성. throw 가능성이 있으면 try-catch 안에서.
#3. 캡처 by-reference 주의
// 회피{ std::string s = "data"; SCOPE_EXIT { LOG(INFO) << s; }; // s는 SCOPE_EXIT 실행 시점에 유효} // scope 끝 — SCOPE_EXIT 먼저, 그다음 s 소멸. 안전.
// 회피 — 더 큰 scope의 referenceSCOPE_EXIT { LOG(INFO) << *ptr; }; // ptr이 어디서 살아있는지?scope 안 local에 대한 reference는 안전. 그 밖은 lifetime 확인.
#4. dismiss 안 한 makeGuard
// 회피auto g = folly::makeGuard([&]{ rollback(); });// dismiss 없음 → 항상 rollback// → commit 후 rollback도 호출됨makeGuard는 commit/dismiss를 잊으면 무조건 cleanup 실행. SCOPE_FAIL이 더 적합.
#안티패턴
#1. SCOPE_EXIT 안에서 무거운 작업
// 회피SCOPE_EXIT { flushAllBuffers(); uploadToS3(); notifyMonitoring();};scope 끝(특히 예외 경로)에서 무거운 작업이 도는 건 디버깅 어렵게 만든다. cleanup은 가볍게.
#2. SCOPE_EXIT 중첩 의존
// 회피SCOPE_EXIT { unlock(); }; // firstSCOPE_EXIT { releaseBuf(); }; // second실행 순서는 등록 역순(LIFO). 의도와 다르면 코드 깨짐. 의존성 있는 cleanup은 한 람다에 모으거나 단일 RAII class.
#3. early return 후 SCOPE_EXIT
// 회피if (cond) return; // SCOPE_EXIT 등록 전SCOPE_EXIT { cleanup(); };자원 획득 직후 등록 — early return 전에.
#정리
- SCOPE_EXIT은 scope 종료 시 람다 실행, 정상/예외 모두.
- SCOPE_FAIL/SCOPE_SUCCESS로 경로별 분기.
makeGuard+ dismiss는 트랜잭션 패턴.- C API 일회성 cleanup에 가장 잘 맞음.
- 반복 사용 자원은 unique_ptr custom deleter가 더 명확.
- 람다는 noexcept로, 의존 순서는 LIFO.
- absl::Cleanup이 가장 가까운 대안.
#다음 편
Part 13-03 folly::Optional vs std::optional — 왜 Folly에 자체 Optional이 있고 어떻게 다른가.
#관련 항목
- Part 13-01 ExceptionWrapper — SCOPE_FAIL과 함께 쓰기
- Effective Modern C++ Item 14 — 소멸자 noexcept
- GoF Decorator — wrap 패턴 일반론
Folly Code Review · 58 of 89
- 1 Folly Code Review — Meta의 production-grade C++ 라이브러리 코드 분석
- 2 Folly 개요 — Meta가 production에서 검증한 utility 모음 분석
- 3 Folly vs Abseil 철학 비교 — performance-first vs std-compatible
- 4 Folly 빌드와 fbcode 환경 — monorepo의 그림자
- 5 Folly API stability 정책 — 어떤 보장도 없다는 솔직함
- 6 Folly production validation 문화 — peta-scale에서 단련된 코드
- 7 folly::Future 분석 — std::future의 한계를 넘는 composable async
- 8 folly::Promise·makeFuture — Future를 만드는 두 길
- 9 folly::SemiFuture vs Future — executor binding의 명시화
- 10 folly::Future thenValue·thenError·thenTry — continuation 체인 분석
- 11 folly::collect·collectAll·collectAny — fan-in 패턴 분석
- 12 folly::Future retry·window·via — 제어 흐름 조합자
- 13 folly::fibers 분석 — M:N stackful coroutine
- 14 folly::InlineExecutor — 호출자 thread에서 즉시 실행
- 15 folly::CPUThreadPoolExecutor — CPU-bound 작업의 표준 thread pool
- 16 folly::IOThreadPoolExecutor — libevent 기반 I/O pool
- 17 folly::ManualExecutor — 결정적 테스트를 위한 수동 진행
- 18 folly::EventBase 분석 — libevent 이벤트 루프의 핵심
- 19 folly::IOBuf 분석 — zero-copy buffer chain의 기본 단위
- 20 folly::IOBufQueue — chain의 push/pull 추상화
- 21 folly::io::Cursor·RWCursor — chain 위의 stream
- 22 folly Zero-copy 패턴 — IOBuf로 ScatterGather I/O 표현
- 23 folly::IOBuf shared semantics — clone·unshare·takeOwnership
- 24 folly::FBString 분석 — SSO + COW 구현
- 25 folly의 fmt::format 통합 — 모던 포맷팅 채택
- 26 folly::StringPiece — string_view 호환 분석
- 27 folly Join·Split utilities — 문자열 분해와 결합
- 28 folly::to·tryTo — text↔num 변환 분석
- 29 folly Conv Customization — 사용자 타입 지원
- 30 folly Conv 성능 비교 — sprintf·stringstream 대비
- 31 folly::F14ValueMap vs std::unordered_map
- 32 folly::F14NodeMap — stable pointer가 필요할 때
- 33 folly::F14VectorMap — cache-friendly iteration
- 34 folly::F14FastMap — auto-select 동작
- 35 folly F14 internals — SIMD probing 메커니즘
- 36 folly::small_vector — inline storage 분석
- 37 folly::FixedString — compile-time string
- 38 folly::AtomicHashMap — lock-free read 분석
- 39 folly::ConcurrentHashMap — sharded 동시 해시 맵
- 40 folly::EvictingCacheMap — LRU 구현 분석
- 41 folly::Synchronized — lock wrapper 패턴
- 42 folly::SharedMutex 분석
- 43 folly::Baton — one-shot wait 동기화
- 44 folly::RWSpinLock 분석
- 45 folly::PicoSpinLock — 1-byte spinlock
- 46 folly::ProducerConsumerQueue — SPSC 큐 분석
- 47 folly::MPMCQueue — multi-producer multi-consumer
- 48 folly::UnboundedQueue — 동적 크기 lock-free
- 49 folly::fibers::Channel — Go-like channel
- 50 folly::dynamic — JSON-like dynamic type 분석
- 51 folly JSON conversion — toJson·parseJson
- 52 folly dynamic ↔ struct — manual marshaling
- 53 folly dynamic Visitor pattern — type별 분기
- 54 folly::Singleton vs Meyers/static — 왜 Folly의 Singleton인가
- 55 folly::SingletonVault 분석 — 등록·소멸·의존성
- 56 folly::Singleton try_get·try_get_fast — TLS-cached 접근
- 57 folly::ExceptionWrapper — type-erased exception holder
- 58 folly::ScopeGuard·SCOPE_EXIT — RAII cleanup
- 59 folly::Optional vs std::optional
- 60 folly::Function vs std::function
- 61 folly::Lazy — 지연 초기화 wrapper
- 62 folly Meta 스타일 code review 패턴
- 63 folly anti-patterns — 잘못 쓰면 std보다 느림
- 64 folly vs std 선택 기준 분석
- 65 folly::coro 개요 — production C++20 코루틴 어댑터
- 66 folly::coro::Task — lazy single-shot 코루틴
- 67 folly::coro::AsyncGenerator — 비동기 스트림
- 68 folly coro blockingWait·collectAll — 동기 경계와 fan-in
- 69 folly::coro::Baton·Mutex — 코루틴-aware 동기화
- 70 folly::Expected — 결과 또는 오류
- 71 folly::Try — Future 결과 wrapper
- 72 folly::Try vs Expected 선택 기준
- 73 folly::Range — 일반 iterator pair
- 74 folly::Uri — URL 파서
- 75 folly Fingerprint64·128 — 분산 hash
- 76 folly SpookyHashV2 — fast non-crypto hash
- 77 folly::Init — main() 부트스트랩
- 78 folly::Indestructible — global lifetime 패턴
- 79 folly::MicroLock — 1-byte 락
- 80 folly::MicroSpinLock — 가장 좁은 spin lock
- 81 folly::format — legacy formatter 분석
- 82 folly::demangle — typeid 디망글링
- 83 folly::DynamicConverter — dynamic ↔ struct
- 84 folly::RecordIO — append-only 로그 파일 포맷
- 85 folly::io::Compression — zstd·lz4·snappy wrapper
- 86 folly::AsyncIO — io_uring·Linux AIO
- 87 folly::CancellationToken — 코루틴·Future 취소 전파
- 88 folly::observer — hot config의 atomic refresh
- 89 fbcode 패턴 모음 — folly 사용의 실전
관련 글
folly::Synchronized — lock wrapper 패턴
folly::Synchronized<T> — 데이터와 lock을 한 객체에 묶어 잠금 누락을 컴파일 타임에 막는다.
같은 시리즈에서 이어 읽기
fbcode 패턴 모음 — folly 사용의 실전
Meta fbcode 코드 리뷰에서 반복적으로 등장하는 folly 사용 패턴 — overview + 시리즈 마무리.
같은 시리즈에서 이어 읽기
folly::observer — hot config의 atomic refresh
folly::observer — read mostly 값의 atomic refresh, hot config·feature flag·LB weight 같은 패턴의 표준.
같은 시리즈에서 이어 읽기