• Stars
    star
    504
  • Rank 87,537 (Top 2 %)
  • Language
    C++
  • License
    Other
  • Created over 10 years ago
  • Updated 4 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Higher-order functions for c++

Boost.Hof Travis status Appveyor status

About

HigherOrderFunctions is a header-only C++11/C++14 library that provides utilities for functions and function objects, which can solve many problems with much simpler constructs than what's traditionally been done with metaprogramming.

HigherOrderFunctions is:

  • Modern: HigherOrderFunctions takes advantages of modern C++11/C++14 features. It supports both constexpr initialization and constexpr evaluation of functions. It takes advantage of type deduction, variadic templates, and perfect forwarding to provide a simple and modern interface.
  • Relevant: HigherOrderFunctions provides utilities for functions and does not try to implement a functional language in C++. As such, HigherOrderFunctions solves many problems relevant to C++ programmers, including initialization of function objects and lambdas, overloading with ordering, improved return type deduction, and much more.
  • Lightweight: HigherOrderFunctions builds simple lightweight abstraction on top of function objects. It does not require subscribing to an entire framework. Just use the parts you need.

HigherOrderFunctions is divided into three components:

  • Function Adaptors and Decorators: These enhance functions with additional capability.
  • Functions: These return functions that achieve a specific purpose.
  • Utilities: These are general utilities that are useful when defining or using functions

GitHub: https://github.com/boostorg/hof/

Documentation: http://boost-hof.readthedocs.io/

Motivation

  • Improve the expressiveness and capabilities of functions, including first-class citizens for function overload set, extension methods, infix operators and much more.
  • Simplify constructs in C++ that have generally required metaprogramming
  • Enable point-free style programming
  • Workaround the limitations of lambdas in C++14

Requirements

This requires a C++11 compiler. There are no third-party dependencies. This has been tested on clang 3.5-3.8, gcc 4.6-7, and Visual Studio 2015 and 2017.

Constexpr support

Both MSVC and gcc 4.6 have limited constexpr support due to many bugs in the implementation of constexpr. However, constexpr initialization of functions is supported when using the BOOST_HOF_STATIC_FUNCTION and BOOST_HOF_STATIC_LAMBDA_FUNCTION constructs.

Noexcept support

On older compilers such as gcc 4.6 and gcc 4.7, noexcept is not used due to many bugs in the implementation. Also, most compilers don't support deducing noexcept with member function pointers. Only newer versions of gcc(4.9 and later) support this.

Building

Boost.HigherOrderFunctions library uses cmake to build. To configure with cmake create a build directory, and run cmake:

mkdir build
cd build
cmake ..

Installing

To install the library just run the install target:

cmake --build . --target install

Tests

The tests can be built and run by using the check target:

cmake --build . --target check

The tests can also be run using Boost.Build, just copy library to the boost source tree, and then:

cd test
b2

Documentation

The documentation is built using Sphinx. First, install the requirements needed for the documentation using pip:

pip install -r doc/requirements.txt

Then html documentation can be generated using sphinx-build:

sphinx-build -b html doc/ doc/html/

The final docs will be in the doc/html folder.

More Repositories

1

boost

Super-project for modularized Boost
HTML
6,236
star
2

beast

HTTP and WebSocket built on Boost.Asio in C++11
C++
4,355
star
3

hana

Your standard library for metaprogramming
C++
1,690
star
4

compute

A C++ GPU Computing Library for OpenCL
C++
1,487
star
5

pfr

std::tuple like methods for user defined types without any macro or boilerplate code
C++
1,221
star
6

asio

Boost.org asio module
C++
1,212
star
7

geometry

Boost.Geometry - Generic Geometry Library | Requires C++14 since Boost 1.75
C++
457
star
8

fiber

userland threads
C++
457
star
9

json

A C++11 library for parsing and serializing JSON to and from a DOM container in memory.
C++
434
star
10

python

Boost.org python module
C++
432
star
11

spirit

Boost.org spirit module
C++
390
star
12

stacktrace

C++ library for storing and printing backtraces.
C++
374
star
13

histogram

Fast multi-dimensional generalized histogram with convenient interface for C++14
C++
315
star
14

math

Boost.org math module
C++
310
star
15

context

Assembly
299
star
16

graph

Boost.org graph module
C++
285
star
17

leaf

Lightweight Error Augmentation Framework
C++
275
star
18

mysql

MySQL C++ client based on Boost.Asio
C++
254
star
19

mp11

C++11 metaprogramming library
C++
239
star
20

build

B2 makes it easy to build C++ projects, everywhere.
C++
224
star
21

redis

An async redis client designed for performance and scalability
C++
223
star
22

cobalt

Coroutines for C++20 & asio
C++
222
star
23

safe_numerics

Replacements to standard numeric types which throw exceptions on errors
C++
208
star
24

thread

Boost.org thread module
C++
198
star
25

multiprecision

Boost.Multiprecision
C++
195
star
26

url

Boost.URL is a library for manipulating Uniform Resource Identifiers (URIs) and Locators (URLs).
C++
186
star
27

test

The reference C++ unit testing framework (TDD, xUnit, C++03/11/14/17)
C++
178
star
28

gil

Boost.GIL - Generic Image Library | Requires C++14 since Boost 1.80
C++
178
star
29

log

Boost Logging library
C++
173
star
30

nowide

Boost.Nowide - Standard library functions with UTF-8 API on Windows
C++
171
star
31

filesystem

Boost.org filesystem module
C++
158
star
32

core

Boost Core Utilities
C++
133
star
33

interprocess

Boost.org interprocess module
C++
132
star
34

callable_traits

modern C++ type traits and metafunctions for callable types
C++
129
star
35

coroutine2

Boost.Coroutine2
C++
127
star
36

lockfree

Boost.Lockfree
C++
120
star
37

serialization

Boost.org serialization module
C++
119
star
38

process

Boost Process
C++
117
star
39

wiki

Boost Wiki
115
star
40

algorithm

Boost.org algorithm module
C++
112
star
41

ublas

Boost.uBlas
C++
108
star
42

smart_ptr

Boost.org smart_ptr module
C++
108
star
43

yap

A C++14-and-later expression template library
C++
107
star
44

container

STL-like containers from Boost
C++
101
star
45

program_options

Boost.org program_options module
C++
92
star
46

preprocessor

Boost.org preprocessor module
C++
91
star
47

cmake

CMake support infrastructure Boost submodule
CMake
87
star
48

uuid

Boost.org uuid module
C++
84
star
49

regex

Boost.org regex module
C++
84
star
50

qvm

Boost Quaternions, Vectors, Matrices library
C++
80
star
51

coroutine

Boost.Coroutine
C++
79
star
52

signals2

Boost.org signals2 module
C++
74
star
53

config

Boost.org config module
C++
72
star
54

stl_interfaces

A C++14 and later CRTP template for defining iterators
C++
69
star
55

describe

A C++14 reflection library
C++
67
star
56

variant2

A never-valueless, strong guarantee implementation of std::variant
C++
66
star
57

date_time

Boost.org date_time module
C++
65
star
58

poly_collection

Fast containers of polymorphic objects.
C++
63
star
59

unordered

Boost.org unordered module
C++
62
star
60

static_string

A fixed capacity dynamically sized string
C++
62
star
61

type_traits

Boost.org type_traits module
C++
61
star
62

winapi

Windows API declarations without <windows.h>, for internal Boost use.
C++
58
star
63

atomic

Boost.Atomic
C++
57
star
64

mpi

Boost.org mpi module
C++
56
star
65

property_tree

Boost.org property_tree module
C++
56
star
66

intrusive

Boost.org intrusive module
C++
54
star
67

circular_buffer

Boost.org circular_buffer module
C++
53
star
68

sort

Boost.Sort
C++
50
star
69

optional

Boost.org optional module
C++
50
star
70

polygon

Boost.org polygon module
C++
48
star
71

fusion

Boost.org fusion module
C++
47
star
72

utility

Boost.org utility module
C++
47
star
73

variant

Boost.org variant module
C++
45
star
74

endian

Boost Endian library
C++
45
star
75

odeint

Boost.odeint
C++
44
star
76

range

Boost.org range module
C++
43
star
77

mpl

Boost.org mpl module
C++
43
star
78

predef

Boost.Predef (a Boost C++ Library)
C
43
star
79

iostreams

Boost.org iostreams module
C++
43
star
80

metaparse

A library for generating compile time parsers parsing embedded DSL code as part of the C++ compilation process
C++
42
star
81

multi_index

Boost.org multi_index module
C++
41
star
82

outcome

Provides very lightweight outcome<T> and result<T> (Boost edition)
C++
40
star
83

contract

Contract programming for C++
C++
39
star
84

pool

Boost.org pool module
C++
37
star
85

dynamic_bitset

Boost.org dynamic_bitset module
C++
36
star
86

system

Boost.org system module
C++
35
star
87

random

Boost.org random module
C++
34
star
88

assert

Boost.Assert
C++
32
star
89

container_hash

Generic hash function for STL style unordered containers
C++
32
star
90

any

Boost.org any module
C++
32
star
91

locale

Boost.Locale
C++
31
star
92

msm

Boost.org msm module
C++
30
star
93

phoenix

Boost.org phoenix module
C++
28
star
94

units

Boost.org units module
C++
28
star
95

bind

Boost.org bind module
C++
26
star
96

charconv

C++11 compatible charconv
C++
26
star
97

format

Boost.org format module
C++
25
star
98

multi_array

Boost.org multi_array module
C++
25
star
99

lexical_cast

General literal text conversions, such as an int represented as a string, or vice versa
C++
25
star
100

website

The boost website.
HTML
24
star