feat update

AllowShortBlocksOnASingleLine: Always

AllowShortCaseLabelsOnASingleLine: false

AllowShortFunctionsOnASingleLine: All

AllowShortIfStatementsOnASingleLine: true

AllowShortIfStatementsOnASingleLine: WithoutElse

AllowShortLambdasOnASingleLine: All

AllowShortLoopsOnASingleLine: true

AlwaysBreakTemplateDeclarations: Yes

NamespaceIndentation: None

ObjCSpaceAfterProperty: false

ObjCSpaceBeforeProtocolList: false

PenaltyIndentedWhitespace: 1

PointerAlignment: Right

ReflowComments: false

SortIncludes: CaseSensitive

include(CMakeFindDependencyMacro)

find_dependency(Threads)

include("${CMAKE_CURRENT_LIST_DIR}/Async++.cmake")

# Copyright (c) 2015 Amanieu d'Antras

#

# Permission is hereby granted, free of charge, to any person obtaining a copy

# of this software and associated documentation files (the "Software"), to deal

# in the Software without restriction, including without limitation the rights

# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell

# copies of the Software, and to permit persons to whom the Software is

# furnished to do so, subject to the following conditions:

#

# The above copyright notice and this permission notice shall be included in

# all copies or substantial portions of the Software.

#

# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE

# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,

# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN

# THE SOFTWARE.

cmake_minimum_required(VERSION 3.1)

project(Async++ C CXX)

option(BUILD_SHARED_LIBS "Build Async++ as a shared library" ON)

option(USE_CXX_EXCEPTIONS "Enable C++ exception support" ON)

if (APPLE)

	option(BUILD_FRAMEWORK "Build a Mac OS X framework instead of a library" OFF)

	if (BUILD_FRAMEWORK AND NOT BUILD_SHARED_LIBS)

		message(FATAL_ERROR "Can't build a framework with static libraries")

	endif()

endif()

set(CMAKE_EXPORT_COMPILE_COMMANDS ON)

# Add all source and header files so IDEs can see them

set(ASYNCXX_INCLUDE

	${PROJECT_SOURCE_DIR}/include/async++/aligned_alloc.h

	${PROJECT_SOURCE_DIR}/include/async++/cancel.h

	${PROJECT_SOURCE_DIR}/include/async++/continuation_vector.h

	${PROJECT_SOURCE_DIR}/include/async++/parallel_for.h

	${PROJECT_SOURCE_DIR}/include/async++/parallel_invoke.h

	${PROJECT_SOURCE_DIR}/include/async++/parallel_reduce.h

	${PROJECT_SOURCE_DIR}/include/async++/partitioner.h

	${PROJECT_SOURCE_DIR}/include/async++/range.h

	${PROJECT_SOURCE_DIR}/include/async++/ref_count.h

	${PROJECT_SOURCE_DIR}/include/async++/scheduler.h

	${PROJECT_SOURCE_DIR}/include/async++/scheduler_fwd.h

	${PROJECT_SOURCE_DIR}/include/async++/task.h

	${PROJECT_SOURCE_DIR}/include/async++/task_base.h

	${PROJECT_SOURCE_DIR}/include/async++/traits.h

	${PROJECT_SOURCE_DIR}/include/async++/when_all_any.h

)

set(ASYNCXX_SRC

	${PROJECT_SOURCE_DIR}/src/internal.h

	${PROJECT_SOURCE_DIR}/src/fifo_queue.h

	${PROJECT_SOURCE_DIR}/src/scheduler.cpp

	${PROJECT_SOURCE_DIR}/src/singleton.h

	${PROJECT_SOURCE_DIR}/src/task_wait_event.h

	${PROJECT_SOURCE_DIR}/src/threadpool_scheduler.cpp

	${PROJECT_SOURCE_DIR}/src/work_steal_queue.h

)

source_group(include FILES ${PROJECT_SOURCE_DIR}/include/async++.h ${ASYNCXX_INCLUDE})

source_group(src FILES ${ASYNCXX_SRC})

add_library(Async++ ${PROJECT_SOURCE_DIR}/include/async++.h ${ASYNCXX_INCLUDE} ${ASYNCXX_SRC})

# Async++ only depends on the C++11 standard libraries, but some implementations

# require the -pthread compiler flag to enable threading functionality.

if (NOT MSVC)

	target_compile_options(Async++ PRIVATE -std=c++11)

endif()

if (APPLE)

	# Use libc++ on Mac because the shipped libstdc++ version is ancient

	target_compile_options(Async++ PRIVATE -stdlib=libc++)

	set_target_properties(Async++ PROPERTIES LINK_FLAGS -stdlib=libc++)

endif()

set(THREADS_PREFER_PTHREAD_FLAG ON)

find_package(Threads REQUIRED)

target_link_libraries(Async++ PUBLIC Threads::Threads)

# Set up preprocessor definitions

target_include_directories(Async++ PRIVATE ${PROJECT_SOURCE_DIR}/include)

set_target_properties(Async++ PROPERTIES DEFINE_SYMBOL LIBASYNC_BUILD)

if (BUILD_SHARED_LIBS)

	# Minimize the set of symbols exported by libraries

	set_target_properties(Async++ PROPERTIES CXX_VISIBILITY_PRESET hidden VISIBILITY_INLINES_HIDDEN ON)

else()

	target_compile_definitions(Async++ PUBLIC LIBASYNC_STATIC)

endif()

# Enable warnings for strict C++ standard conformance

if (NOT MSVC)

	target_compile_options(Async++ PRIVATE -Wall -Wextra -pedantic)

endif()

# Async++ doesn't make use of RTTI information, so don't generate it.

# There are issues on Apple platforms with exceptions and -fno-rtti, so keep it

# enabled there.

# See https://stackoverflow.com/questions/21737201/problems-throwing-and-catching-exceptions-on-os-x-with-fno-rtti

if (MSVC)

	target_compile_options(Async++ PRIVATE /GR-)

elseif(NOT APPLE)

	target_compile_options(Async++ PRIVATE -fno-rtti)

endif()

# Allow disabling exceptions, but warn the user about the consequences

if (NOT USE_CXX_EXCEPTIONS)

	message(WARNING "Exceptions have been disabled. Any operation that would "

	        "throw an exception will result in a call to std::abort() instead.")

	target_compile_definitions(Async++ PUBLIC LIBASYNC_NO_EXCEPTIONS)

	if (MSVC)

		target_compile_options(Async++ PUBLIC /EHs-c-)

	else()

		target_compile_options(Async++ PUBLIC -fno-exceptions)

	endif()

endif()

# /Zc:__cplusplus is required to make __cplusplus accurate

# /Zc:__cplusplus is available starting with Visual Studio 2017 version 15.7

# (according to https://docs.microsoft.com/en-us/cpp/build/reference/zc-cplusplus)

# That version is equivalent to _MSC_VER==1914

# (according to https://docs.microsoft.com/en-us/cpp/preprocessor/predefined-macros?view=vs-2019)

# CMake's ${MSVC_VERSION} is equivalent to _MSC_VER

# (according to https://cmake.org/cmake/help/latest/variable/MSVC_VERSION.html#variable:MSVC_VERSION)

# GREATER and EQUAL are used because GREATER_EQUAL is available starting with CMake 3.7

# (according to https://cmake.org/cmake/help/v3.7/release/3.7.html#commands)

if ((MSVC) AND ((MSVC_VERSION GREATER 1914) OR (MSVC_VERSION EQUAL 1914)))

    target_compile_options(Async++ PUBLIC /Zc:__cplusplus)

endif()

include(CMakePackageConfigHelpers)

configure_package_config_file("${CMAKE_CURRENT_LIST_DIR}/Async++Config.cmake.in"

	"${PROJECT_BINARY_DIR}/Async++Config.cmake"

	INSTALL_DESTINATION cmake

)

install(FILES "${PROJECT_BINARY_DIR}/Async++Config.cmake"

	DESTINATION cmake

)

# Install the library and produce a CMake export script

include(GNUInstallDirs)

install(TARGETS Async++

	EXPORT Async++

	RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}

	LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}

	ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR}

	FRAMEWORK DESTINATION Frameworks

)

export(EXPORT Async++)

install(EXPORT Async++ DESTINATION cmake)

if (APPLE AND BUILD_FRAMEWORK)

	set_target_properties(Async++ PROPERTIES OUTPUT_NAME Async++ FRAMEWORK ON)

	set_source_files_properties(${ASYNCXX_INCLUDE} PROPERTIES MACOSX_PACKAGE_LOCATION Headers/async++)

	set_source_files_properties(${PROJECT_SOURCE_DIR}/include/async++.h PROPERTIES MACOSX_PACKAGE_LOCATION Headers)

else()

	set_target_properties(Async++ PROPERTIES OUTPUT_NAME async++)

	target_include_directories(Async++ INTERFACE $<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}/include> $<INSTALL_INTERFACE:include>)

	install(FILES ${PROJECT_SOURCE_DIR}/include/async++.h DESTINATION include)

	install(FILES ${ASYNCXX_INCLUDE} DESTINATION include/async++)

endif()

SET(CPACK_GENERATOR "DEB")

SET(CPACK_DEBIAN_PACKAGE_MAINTAINER "none") #required

INCLUDE(CPack)

Copyright (c) 2015 Amanieu d'Antras

Permission is hereby granted, free of charge, to any person obtaining a copy

of this software and associated documentation files (the "Software"), to deal

in the Software without restriction, including without limitation the rights

to use, copy, modify, merge, publish, distribute, sublicense, and/or sell

copies of the Software, and to permit persons to whom the Software is

furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in

all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE

AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,

OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN

THE SOFTWARE.

Async++

=======

Async++ is a lightweight concurrency framework for C++11. The concept was inspired by the [Microsoft PPL library](http://msdn.microsoft.com/en-us/library/dd492418.aspx) and the [N3428](http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2012/n3428.pdf) C++ standard proposal.

Example

-------

Here is a short example which shows some features of Async++:

```c++

#include <iostream>

#include <async++.h>

int main()

{

    auto task1 = async::spawn([] {

        std::cout << "Task 1 executes asynchronously" << std::endl;

    });

    auto task2 = async::spawn([]() -> int {

        std::cout << "Task 2 executes in parallel with task 1" << std::endl;

        return 42;

    });

    auto task3 = task2.then([](int value) -> int {

        std::cout << "Task 3 executes after task 2, which returned "

                  << value << std::endl;

        return value * 3;

    });

    auto task4 = async::when_all(task1, task3);

    auto task5 = task4.then([](std::tuple<async::task<void>,

                                          async::task<int>> results) {

        std::cout << "Task 5 executes after tasks 1 and 3. Task 3 returned "

                  << std::get<1>(results).get() << std::endl;

    });

    task5.get();

    std::cout << "Task 5 has completed" << std::endl;

    async::parallel_invoke([] {

        std::cout << "This is executed in parallel..." << std::endl;

    }, [] {

        std::cout << "with this" << std::endl;

    });

    async::parallel_for(async::irange(0, 5), [](int x) {

        std::cout << x;

    });

    std::cout << std::endl;

    int r = async::parallel_reduce({1, 2, 3, 4}, 0, [](int x, int y) {

        return x + y;

    });

    std::cout << "The sum of {1, 2, 3, 4} is " << r << std::endl;

}

// Output (order may vary in some places):

// Task 1 executes asynchronously

// Task 2 executes in parallel with task 1

// Task 3 executes after task 2, which returned 42

// Task 5 executes after tasks 1 and 3. Task 3 returned 126

// Task 5 has completed

// This is executed in parallel...

// with this

// 01234

// The sum of {1, 2, 3, 4} is 10

```

Supported Platforms

-------------------

The only requirement to use Async++ is a C++11 compiler and standard library. Unfortunately C++11 is not yet fully implemented on most platforms. Here is the list of OS and compiler combinations which are known to work.

- Linux: Works with GCC 4.7+, Clang 3.2+ and Intel compiler 15+.

- Mac: Works with Apple Clang (using libc++). GCC also works but you must get a recent version (4.7+).

- iOS: Works with Apple Clang (using libc++). Note: because iOS has no thread local support, the library uses a workaround based on pthreads.

- Windows: Works with GCC 4.8+ (with pthread-win32) and Visual Studio 2013+.

Building and Installing

-----------------------

Instructions for compiling Async++ and using it in your code are available on the [Building and Installing](https://github.com/Amanieu/asyncplusplus/wiki/Building-and-Installing) page.

Documentation

------------

The Async++ documentation is split into four parts:

- [Tasks](https://github.com/Amanieu/asyncplusplus/wiki/Tasks): This describes task objects which are the core Async++. Reading this first is strongly recommended.

- [Parallel algorithms](https://github.com/Amanieu/asyncplusplus/wiki/Parallel-algorithms): This describes functions to run work on ranges in parallel.

- [Schedulers](https://github.com/Amanieu/asyncplusplus/wiki/Schedulers): This describes the low-level details of Async++ and how to customize it.

- [API Reference](https://github.com/Amanieu/asyncplusplus/wiki/API-Reference): This gives detailed descriptions of all the classes and functions available in Async++.

Contact

-------

You can contact me by email at amanieu@gmail.com.