• Stars
    star
    503
  • Rank 84,379 (Top 2 %)
  • Language
    C++
  • License
    Other
  • Created almost 10 years ago
  • Updated about 2 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,148
star
3

hana

Your standard library for metaprogramming
C++
1,598
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,111
star
7

fiber

userland threads
C++
436
star
8

python

Boost.org python module
C++
432
star
9

geometry

Boost.Geometry - Generic Geometry Library | Requires C++14 since Boost 1.75
C++
416
star
10

json

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

stacktrace

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

spirit

Boost.org spirit module
C++
374
star
13

histogram

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

math

Boost.org math module
C++
288
star
15

graph

Boost.org graph module
C++
285
star
16

context

Assembly
279
star
17

leaf

Lightweight Error Augmentation Framework
C++
275
star
18

mysql

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

mp11

C++11 metaprogramming library
C++
225
star
20

build

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

safe_numerics

Replacements to standard numeric types which throw exceptions on errors
C++
205
star
22

redis

An async redis client designed for performance and scalability
C++
204
star
23

thread

Boost.org thread module
C++
196
star
24

url

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

multiprecision

Boost.Multiprecision
C++
176
star
26

log

Boost Logging library
C++
173
star
27

gil

Boost.GIL - Generic Image Library | Requires C++14 since Boost 1.80
C++
171
star
28

nowide

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

test

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

cobalt

Coroutines for C++20 & asio
C++
160
star
31

filesystem

Boost.org filesystem module
C++
153
star
32

core

Boost Core Utilities
C++
131
star
33

callable_traits

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

interprocess

Boost.org interprocess module
C++
120
star
35

coroutine2

Boost.Coroutine2
C++
120
star
36

serialization

Boost.org serialization module
C++
118
star
37

wiki

Boost Wiki
114
star
38

algorithm

Boost.org algorithm module
C++
109
star
39

lockfree

Boost.Lockfree
C++
109
star
40

smart_ptr

Boost.org smart_ptr module
C++
108
star
41

ublas

Boost.uBlas
C++
105
star
42

yap

A C++14-and-later expression template library
C++
105
star
43

process

Boost Process
C++
101
star
44

container

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

program_options

Boost.org program_options module
C++
92
star
46

preprocessor

Boost.org preprocessor module
C++
89
star
47

qvm

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

coroutine

Boost.Coroutine
C++
79
star
49

regex

Boost.org regex module
C++
78
star
50

uuid

Boost.org uuid module
C++
75
star
51

cmake

CMake support infrastructure Boost submodule
CMake
75
star
52

signals2

Boost.org signals2 module
C++
74
star
53

stl_interfaces

A C++14 and later CRTP template for defining iterators
C++
70
star
54

variant2

A never-valueless, strong guarantee implementation of std::variant
C++
68
star
55

config

Boost.org config module
C++
67
star
56

describe

A C++14 reflection library
C++
66
star
57

date_time

Boost.org date_time module
C++
64
star
58

type_traits

Boost.org type_traits module
C++
60
star
59

poly_collection

Fast containers of polymorphic objects.
C++
60
star
60

static_string

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

winapi

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

mpi

Boost.org mpi module
C++
56
star
63

atomic

Boost.Atomic
C++
56
star
64

unordered

Boost.org unordered module
C++
53
star
65

circular_buffer

Boost.org circular_buffer module
C++
51
star
66

sort

Boost.Sort
C++
51
star
67

intrusive

Boost.org intrusive module
C++
50
star
68

optional

Boost.org optional module
C++
50
star
69

polygon

Boost.org polygon module
C++
48
star
70

property_tree

Boost.org property_tree 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

range

Boost.org range module
C++
43
star
75

metaparse

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

endian

Boost Endian library
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++
41
star
80

multi_index

Boost.org multi_index module
C++
41
star
81

contract

Contract programming for C++
C++
40
star
82

odeint

Boost.odeint
C++
39
star
83

outcome

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

pool

Boost.org pool module
C++
37
star
85

dynamic_bitset

Boost.org dynamic_bitset module
C++
36
star
86

random

Boost.org random module
C++
34
star
87

assert

Boost.Assert
C++
32
star
88

any

Boost.org any module
C++
32
star
89

system

Boost.org system module
C++
32
star
90

msm

Boost.org msm module
C++
29
star
91

container_hash

Generic hash function for STL style unordered containers
C++
29
star
92

locale

Boost.Locale
C++
29
star
93

units

Boost.org units module
C++
28
star
94

bind

Boost.org bind module
C++
27
star
95

phoenix

Boost.org phoenix module
C++
27
star
96

multi_array

Boost.org multi_array module
C++
25
star
97

format

Boost.org format module
C++
25
star
98

lexical_cast

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

website

The boost website.
HTML
23
star
100

statechart

Boost.org statechart module
C++
23
star