Popularity

4.3

Growing

Activity

5.2

Stars 615

Watchers 17

Forks 61

Last Commit about 1 month ago

Description

Outcome is a C++14 library for reporting and handling function failures. It can be used as a substitute for, or a complement to, the exception handling mechanism.

One use case is for contexts where using C++ exception handling is unsuitable for different reasons:

The high relative cost of throwing and catching a C++ exception. Making some or all control paths explicitly detailed to aid code correctness auditing, as opposed to having hidden control paths caused by exceptions potentially thrown from any place. Company policy to compile with exceptions disabled. Maintaining a code base that was never designed with exception-safety in mind. Parts of the programs/frameworks that themselves implement exception handling and cannot afford to use exceptions, like propagating failure reports across threads, tasks, fibers…

Programming language: C++

License: GNU General Public License v3.0 or later

Tags: Miscellaneous Header Only C++14 Error Handling

Latest version: v2.1.5

outcome alternatives and similar libraries

Based on the "Miscellaneous" category.
Alternatively, view outcome alternatives based on common mentions on social networks and blogs.

ZXing

9.9 4.3 L3 outcome VS ZXing

ZXing ("Zebra Crossing") barcode scanning library for Java, Android
stb

9.8 7.8 L2 outcome VS stb

stb single-file public domain libraries for C/C++

Write Clean C++ Code. Always.

Sonar helps you commit clean C++ code every time. With over 550 unique rules to find C++ bugs, code smells & vulnerabilities, Sonar finds the issues while you focus on the work.

Promo www.sonarsource.com

C++ Format

9.5 8.8 L1 outcome VS C++ Format

A modern formatting library
HTTP Parser

8.9 0.0 L1 outcome VS HTTP Parser

http request/response parser for c
RE2

8.9 9.0 L1 outcome VS RE2

RE2 is a fast, safe, thread-friendly alternative to backtracking regular expression engines like those used in PCRE, Perl, and Python. It is a C++ library.
Cppcheck

8.5 9.8 outcome VS Cppcheck

static analysis of C/C++ code
SDS

8.1 0.0 L2 outcome VS SDS

Simple Dynamic Strings library for C
Klib

7.9 0.0 L4 outcome VS Klib

A standalone and lightweight C library
ZBar

7.8 0.0 L3 outcome VS ZBar

Clone of the mercurial repository http://zbar.hg.sourceforge.net:8000/hgroot/zbar/zbar
American fuzzy lop

7.6 0.0 outcome VS American fuzzy lop

american fuzzy lop - a security-oriented fuzzer
Serial Communication Library

7.4 0.0 L1 outcome VS Serial Communication Library

Cross-platform, Serial Port library written in C++
pdqsort

6.6 0.0 outcome VS pdqsort

Pattern-defeating quicksort.
PHP-CPP

6.5 5.6 L4 outcome VS PHP-CPP

Library to build PHP extensions with C++
libssh2

6.4 5.1 outcome VS libssh2

the SSH library
Better Enums

6.0 0.0 L5 outcome VS Better Enums

C++ compile-time enum to string, iteration, in a single header file
c-smart-pointers

5.8 0.0 outcome VS c-smart-pointers

Smart pointers for the (GNU) C programming language
Mach7

5.7 0.0 L2 outcome VS Mach7

Functional programming style pattern-matching library for C++
Experimental Boost.DI

5.6 0.0 L3 outcome VS Experimental Boost.DI

DI: C++14 Dependency Injection Library
UNITS

5.1 0.0 L3 outcome VS UNITS

a compile-time, header-only, dimensional analysis and unit conversion library built on c++14 with no dependencies.
stdman

5.0 3.8 outcome VS stdman

Formatted C++20 stdlib man pages (cppreference)
constexpr-8cc

4.6 3.3 L3 outcome VS constexpr-8cc

Compile-time C Compiler implemented as C++14 constant expressions
SLRE

4.5 0.0 L3 outcome VS SLRE

Super Light Regexp engine for C/C++
Stage

4.4 0.0 L1 outcome VS Stage

Mobile robot simulator
DynaMix

4.3 0.0 outcome VS DynaMix

:fish_cake: A new take on polymorphism
cxx-prettyprint

4.2 0.0 L5 outcome VS cxx-prettyprint

A header-only library for C++(0x) that allows automagic pretty-printing of any container.
libcpuid

4.0 1.3 L2 outcome VS libcpuid

a small C library for x86 CPU detection and feature extraction
STX

3.9 9.2 outcome VS STX

C++17 & C++ 20 error-handling and utility extensions.
Better String

3.9 0.0 L2 outcome VS Better String

The Better String Library
CppVerbalExpressions

3.8 0.0 L5 outcome VS CppVerbalExpressions

C++ regular expressions made easy
kangaru

3.7 2.1 L5 outcome VS kangaru

🦘 A dependency injection container for C++11, C++14 and later
value-category-cheatsheet

3.6 0.0 outcome VS value-category-cheatsheet

A C++14 cheat-sheet on lvalues, rvalues, xvalues, and more
leaf

3.4 3.5 outcome VS leaf

Lightweight Error Augmentation Framework
casacore

3.3 9.3 L1 outcome VS casacore

Suite of C++ libraries for radio astronomy data processing
neither

3.3 0.0 outcome VS neither

Either and Maybe monads for better error-handling in C++ ↔️
libusb

3.1 0.0 outcome VS libusb

Access USB devices from Ruby via libusb-1.x
semver.c

3.0 0.0 L5 outcome VS semver.c

Semantic version in ANSI C
StrTk

3.0 0.0 outcome VS StrTk

C++ String Toolkit Library https://www.partow.net/programming/strtk/index.html
gcc-poison

3.0 0.0 outcome VS gcc-poison

gcc-poison
ub-canaries

2.9 0.0 L4 outcome VS ub-canaries

collection of C/C++ programs that try to get compilers to exploit undefined behavior
Boost.Signals

2.7 0.0 L2 outcome VS Boost.Signals

Boost.org signals2 module
libnih

2.7 0.0 L2 outcome VS libnih

NIH Utility Library
sigslot

2.5 0.0 L5 outcome VS sigslot

C++11 signal/slot implementation
QtVerbalExpressions

2.4 0.0 L5 outcome VS QtVerbalExpressions

This Qt lib is based off of the C++ VerbalExpressions library. [MIT]
access_profiler

2.2 0.0 L5 outcome VS access_profiler

a tool to count accesses to member variables in c++ programs
libsigc++

2.1 0.7 L5 outcome VS libsigc++

A typesafe callback system for standard C++. [LGPL]
strf

2.1 0.0 outcome VS strf

Yet another C++ text formatting library.
FastFormat

2.1 0.0 outcome VS FastFormat

The fastest, most robust C++ formatting library
cppq

2.0 10.0 outcome VS cppq

Simple, reliable & efficient distributed task queue for C++17
libevil

1.9 0.0 L4 outcome VS libevil

The Evil License Manager
Scintilla

1.8 0.0 L1 outcome VS Scintilla

A free source code editing component. [MIT]

* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest.

Do you think we are missing an alternative of outcome or a related project?

Add another 'Miscellaneous' Library

Popular Comparisons

README

master branchdevelop branch

CTest dashboard: https://my.cdash.org/index.php?project=Boost.Outcome

All tests passing source tarballs: https://github.com/ned14/outcome/releases

Documentation: https://ned14.github.io/outcome/

Purpose of this library

Outcome is a C++14 library for reporting and handling function failures. It can be used as a substitute for, or a complement to, the exception handling mechanism.

One use case is for contexts where using C++ exception handling is unsuitable for different reasons:

The high relative cost of throwing and catching a C++ exception.
Making some or all control paths explicitly detailed to aid code correctness auditing, as opposed to having hidden control paths caused by exceptions potentially thrown from any place.
Company policy to compile with exceptions disabled.
Maintaining a code base that was never designed with exception-safety in mind.
Parts of the programs/frameworks that themselves implement exception handling and cannot afford to use exceptions, like propagating failure reports across threads, tasks, fibers…

Usage as a single header file

Outcome v2 comes in single header file form. This is regenerated per commit. To fetch on Linux:

wget https://github.com/ned14/outcome/raw/master/single-header/outcome.hpp

On BSD:

fetch https://github.com/ned14/outcome/raw/master/single-header/outcome.hpp

If you have curl installed:

curl -O -J -L https://github.com/ned14/outcome/raw/master/single-header/outcome.hpp

Otherwise, simply download the raw file from above and place it wherever it suits you. If you might be debugging using Microsoft Visual Studio, you may find the debugger visualisation file at https://github.com/ned14/outcome/raw/master/include/outcome/outcome.natvis useful to include into your build.

Commits and tags in this git repository can be verified using:

-----BEGIN PGP PUBLIC KEY BLOCK----- Version: GnuPG v2

mDMEVvMacRYJKwYBBAHaRw8BAQdAp+Qn6djfxWQYtAEvDmv4feVmGALEQH/pYpBC llaXNQe0WE5pYWxsIERvdWdsYXMgKHMgW3VuZGVyc2NvcmVdIHNvdXJjZWZvcmdl IHthdH0gbmVkcHJvZCBbZG90XSBjb20pIDxzcGFtdHJhcEBuZWRwcm9kLmNvbT6I eQQTFggAIQUCVvMacQIbAwULCQgHAgYVCAkKCwIEFgIDAQIeAQIXgAAKCRCELDV4 Zvkgx4vwAP9gxeQUsp7ARMFGxfbR0xPf6fRbH+miMUg2e7rYNuHtLQD9EUoR32We V8SjvX4r/deKniWctvCi5JccgfUwXkVzFAk= =puFk -----END PGP PUBLIC KEY BLOCK-----

outcome

Provides very lightweight outcome<T> and result<T> (non-Boost edition)