본문으로 건너뛰기
Folly Code Review · 58/89

folly::Optional vs std::optional

· Hawk · 4분 읽기

#한 줄 요약

folly::Optional<T>는 C++17 이전부터 존재하던 std::optional의 선조다. 지금은 거의 std::optional로 대체되었지만 일부 monadic op(.then, .map)과 value_or_throw, 그리고 fbcode 전반의 일관성을 위해 남아 있다. 신규 코드라면 std::optional이 정답에 가깝다.

#동기 — 역사적 맥락

Folly가 만들어진 시점(2012년경)엔 표준에 std::optional이 없었다. boost::optional은 있었으나 fbcode는 boost 의존을 최소화했다. 그래서 자체 Optional을 만들었다.

C++17에서 std::optional이 표준화되면서 같은 위치를 차지하게 됐다. Folly는 자체 Optional을 deprecated하지 않고 std와 거의 호환되는 API + 약간의 extension으로 유지하고 있다. 이미 fbcode 전반이 folly::Optional을 쓰기 때문이다.

#API — std::optional와 거의 동일

#include <folly/Optional.h>
folly::Optional<int> a; // empty
folly::Optional<int> b = 42; // has_value
folly::Optional<int> c{folly::none};
if (b) {
int v = *b; // dereference
int v2 = b.value();
int v3 = b.value_or(0);
}
// std 호환
b.has_value();
b.reset();
b.emplace(99);

이 부분만 보면 std::optional와 거의 같다.

#추가 기능 — monadic op (std::optional는 C++23부터)

folly::Optional<int> x = 42;
// map (std::optional의 transform과 같음)
auto y = x.map([](int v) { return v * 2; }); // Optional<int> = 84
auto z = x.then([](int v) { return getOpt(v); }); // Optional<int> 또는 flatMap
// or_else
auto w = x.or_else([] { return folly::Optional<int>(99); });
// value_or_throw
int v = x.value_or_throw<std::runtime_error>("missing");

이게 std::optional가 C++23 이전엔 없던 monadic API다. 지금 std::optional도 transform/and_then/or_else를 갖지만, fbcode가 C++17 시절에 작성됐기에 folly::Optional의 monadic op이 코드 전반에 박혀 있다.

#std::optional와의 차이 정리

항목std::optionalfolly::Optional
has_valueyesyes
value_oryesyes
transform (C++23)yesyes (map)
and_then (C++23)yesyes (then)
or_else (C++23)yesyes
value_or_throw<E>xyes (custom exception)
operator== with Tyesyes
호환 변환std::optional 변환 가능
folly::Optional<int> fo = 42;
std::optional<int> so = fo; // 호환 변환 OK

#내부 구현

template <typename T>
class Optional {
union { T value_; }; // alignas(T)
bool hasValue_;
};

std::optional와 같은 SBO 구조. value_가 union에 인라인 저장돼 heap 할당 없음.

생성자/소멸자가 hasValue_에 따라 placement-new / explicit destructor 호출.

#코드 리뷰 포인트

#1. 신규 코드는 std::optional

// 회피 — 신규 코드에 folly::Optional
folly::Optional<int> get();
// Good — 신규는 std::optional
std::optional<int> get();

fbcode 안에서는 folly::Optional이 표준이지만, 외부에 노출되는 lib나 newer code면 std::optional이 호환성이 좋다.

#2. monadic op vs if-then-else

// monadic
auto greeting = name.map([](auto& n) { return "Hello, " + n; });
// if-then-else
folly::Optional<std::string> greeting;
if (name) greeting = "Hello, " + *name;

monadic이 짧지만, 단순 한 줄이면 if도 명료. chain이 두 단계 넘으면 monadic이 가독성 win.

#3. value() throw 처리

// 회피 — empty 시 throw
auto v = opt.value();
// Good — has_value 확인 또는 value_or
if (opt) auto v = *opt;
auto v = opt.value_or(default_v);

value()는 empty면 bad_optional_access throw. 의도된 throw인지 명확히.

#4. Optional 회피

// 회피
folly::Optional<int&> oref; // 정의되어 있지만 비추
// Good
folly::Optional<std::reference_wrapper<int>> oref;
// 또는 nullable pointer (T*)

reference에 대한 optional은 reference rebinding의 모호함이 있다.

#std::optional와 비교 — 어떤 걸 골라야 하나

상황선택
fbcode 내부 신규 모듈folly::Optional (관행)
외부 lib / open-source 노출 APIstd::optional
C++20 이하 코드 + monadic 필요folly::Optional
C++23 이상 사용std::optional
value_or_throw<E> 필요folly::Optional

Folly 팀도 새 코드는 std::optional을 점진적으로 권장한다. folly::Optional은 fbcode 일관성과 monadic op(C++17 시절)이 주된 존재 이유.

#안티패턴

#1. Optional을 출력 인자로

// 회피 — 출력 인자
void get(folly::Optional<int>& out);
// Good — 반환
folly::Optional<int> get();

Optional은 “값 또는 없음”의 의도가 반환 타입에 가장 잘 드러난다.

#2. Optional을 tri-state로 남용

folly::Optional<bool> flag; // empty / true / false — 의미 모호

명확한 enum이 가독성에 더 낫다.

enum class FlagState { Unset, On, Off };

#3. Optional<unique_ptr>

// 회피 — 중복 nullable
folly::Optional<std::unique_ptr<T>> opt;

unique_ptr<T>가 이미 nullable. 그냥 unique_ptr<T>로.

#정리

  • folly::Optional은 std::optional의 선조, 호환 가능.
  • C++17 이전에 필요했던 monadic op(map/then/or_else)을 일찍 도입.
  • 추가 메서드: value_or_throw<E>, std::optional와 변환 가능.
  • 신규 코드는 std::optional, fbcode 내부는 folly::Optional 관행 유지.
  • Optional나 Optional<unique_ptr> 같은 중복 nullable은 회피.

#다음 편

Part 13-04 folly::Function — move-only callable. std::function이 못 담는 unique_ptr capture를 어떻게 처리하나.

#관련 항목

Folly Code Review · 59 of 89

  1. 1 Folly Code Review — Meta의 production-grade C++ 라이브러리 코드 분석
  2. 2 Folly 개요 — Meta가 production에서 검증한 utility 모음 분석
  3. 3 Folly vs Abseil 철학 비교 — performance-first vs std-compatible
  4. 4 Folly 빌드와 fbcode 환경 — monorepo의 그림자
  5. 5 Folly API stability 정책 — 어떤 보장도 없다는 솔직함
  6. 6 Folly production validation 문화 — peta-scale에서 단련된 코드
  7. 7 folly::Future 분석 — std::future의 한계를 넘는 composable async
  8. 8 folly::Promise·makeFuture — Future를 만드는 두 길
  9. 9 folly::SemiFuture vs Future — executor binding의 명시화
  10. 10 folly::Future thenValue·thenError·thenTry — continuation 체인 분석
  11. 11 folly::collect·collectAll·collectAny — fan-in 패턴 분석
  12. 12 folly::Future retry·window·via — 제어 흐름 조합자
  13. 13 folly::fibers 분석 — M:N stackful coroutine
  14. 14 folly::InlineExecutor — 호출자 thread에서 즉시 실행
  15. 15 folly::CPUThreadPoolExecutor — CPU-bound 작업의 표준 thread pool
  16. 16 folly::IOThreadPoolExecutor — libevent 기반 I/O pool
  17. 17 folly::ManualExecutor — 결정적 테스트를 위한 수동 진행
  18. 18 folly::EventBase 분석 — libevent 이벤트 루프의 핵심
  19. 19 folly::IOBuf 분석 — zero-copy buffer chain의 기본 단위
  20. 20 folly::IOBufQueue — chain의 push/pull 추상화
  21. 21 folly::io::Cursor·RWCursor — chain 위의 stream
  22. 22 folly Zero-copy 패턴 — IOBuf로 ScatterGather I/O 표현
  23. 23 folly::IOBuf shared semantics — clone·unshare·takeOwnership
  24. 24 folly::FBString 분석 — SSO + COW 구현
  25. 25 folly의 fmt::format 통합 — 모던 포맷팅 채택
  26. 26 folly::StringPiece — string_view 호환 분석
  27. 27 folly Join·Split utilities — 문자열 분해와 결합
  28. 28 folly::to·tryTo — text↔num 변환 분석
  29. 29 folly Conv Customization — 사용자 타입 지원
  30. 30 folly Conv 성능 비교 — sprintf·stringstream 대비
  31. 31 folly::F14ValueMap vs std::unordered_map
  32. 32 folly::F14NodeMap — stable pointer가 필요할 때
  33. 33 folly::F14VectorMap — cache-friendly iteration
  34. 34 folly::F14FastMap — auto-select 동작
  35. 35 folly F14 internals — SIMD probing 메커니즘
  36. 36 folly::small_vector — inline storage 분석
  37. 37 folly::FixedString — compile-time string
  38. 38 folly::AtomicHashMap — lock-free read 분석
  39. 39 folly::ConcurrentHashMap — sharded 동시 해시 맵
  40. 40 folly::EvictingCacheMap — LRU 구현 분석
  41. 41 folly::Synchronized — lock wrapper 패턴
  42. 42 folly::SharedMutex 분석
  43. 43 folly::Baton — one-shot wait 동기화
  44. 44 folly::RWSpinLock 분석
  45. 45 folly::PicoSpinLock — 1-byte spinlock
  46. 46 folly::ProducerConsumerQueue — SPSC 큐 분석
  47. 47 folly::MPMCQueue — multi-producer multi-consumer
  48. 48 folly::UnboundedQueue — 동적 크기 lock-free
  49. 49 folly::fibers::Channel — Go-like channel
  50. 50 folly::dynamic — JSON-like dynamic type 분석
  51. 51 folly JSON conversion — toJson·parseJson
  52. 52 folly dynamic ↔ struct — manual marshaling
  53. 53 folly dynamic Visitor pattern — type별 분기
  54. 54 folly::Singleton vs Meyers/static — 왜 Folly의 Singleton인가
  55. 55 folly::SingletonVault 분석 — 등록·소멸·의존성
  56. 56 folly::Singleton try_get·try_get_fast — TLS-cached 접근
  57. 57 folly::ExceptionWrapper — type-erased exception holder
  58. 58 folly::ScopeGuard·SCOPE_EXIT — RAII cleanup
  59. 59 folly::Optional vs std::optional
  60. 60 folly::Function vs std::function
  61. 61 folly::Lazy — 지연 초기화 wrapper
  62. 62 folly Meta 스타일 code review 패턴
  63. 63 folly anti-patterns — 잘못 쓰면 std보다 느림
  64. 64 folly vs std 선택 기준 분석
  65. 65 folly::coro 개요 — production C++20 코루틴 어댑터
  66. 66 folly::coro::Task — lazy single-shot 코루틴
  67. 67 folly::coro::AsyncGenerator — 비동기 스트림
  68. 68 folly coro blockingWait·collectAll — 동기 경계와 fan-in
  69. 69 folly::coro::Baton·Mutex — 코루틴-aware 동기화
  70. 70 folly::Expected — 결과 또는 오류
  71. 71 folly::Try — Future 결과 wrapper
  72. 72 folly::Try vs Expected 선택 기준
  73. 73 folly::Range — 일반 iterator pair
  74. 74 folly::Uri — URL 파서
  75. 75 folly Fingerprint64·128 — 분산 hash
  76. 76 folly SpookyHashV2 — fast non-crypto hash
  77. 77 folly::Init — main() 부트스트랩
  78. 78 folly::Indestructible — global lifetime 패턴
  79. 79 folly::MicroLock — 1-byte 락
  80. 80 folly::MicroSpinLock — 가장 좁은 spin lock
  81. 81 folly::format — legacy formatter 분석
  82. 82 folly::demangle — typeid 디망글링
  83. 83 folly::DynamicConverter — dynamic ↔ struct
  84. 84 folly::RecordIO — append-only 로그 파일 포맷
  85. 85 folly::io::Compression — zstd·lz4·snappy wrapper
  86. 86 folly::AsyncIO — io_uring·Linux AIO
  87. 87 folly::CancellationToken — 코루틴·Future 취소 전파
  88. 88 folly::observer — hot config의 atomic refresh
  89. 89 fbcode 패턴 모음 — folly 사용의 실전