首頁>編程相關>C/C++
下載

libcopp

C ++中的跨平台Coroutine庫。

CI構建狀態

CI職位矩陣

目標系統工具鏈筆記
Linux海灣合作委員會靜態鏈接
Linux海灣合作委員會動態鏈接
Linux GCC-Latest
Linux GCC-Latest不例外
Linux GCC-Latest線程不安全
Linux GCC 4.8遺產
Linux最叮噹使用libc ++
mingw64海灣合作委員會動態鏈接
視窗Visual Studio 2019靜態鏈接
視窗Visual Studio 2019動態鏈接
視窗Visual Studio 2017遺產，靜態鏈接
macos appleclang使用libc ++

執照

根據MIT許可證的許可證

文件

可以在https://libcopp.atframe.work上找到文檔，API參考CANBE在https://libcopp.atframe.work/doxygen/html/。

從1.3.x-1.4.x升級到2.x

  • using value_type = int;使用cotask::task<T>中的T 。
  • 使用T cotask::task<T>重命名stack_allocator_t到stack_allocator_type 。
  • 使用cotask::task<T>將coroutine_t重命名為T中的coroutine_type 。
  • 重命名libcopp::util::*到copp::util:: 。
  • 我們不允許使用libcopp::util::intrusive_ptr<cotask::impl::task_impl>現在，請改用cotask::task<T>::ptr_type 。

從1.2.x升級到1.3.x-1.4.x

  • 重命名cotask::task::await cotask::task::await_task
  • 替換cotask::task<TCO_MACRO, TTASK_MACRO>用cotask::task<TCO_MACRO> ，我們現在不允許自定義ID分配器。
  • 替換cotask::core::standard_int_id_allocator<uint64_t>用copp::util::uint64_id_allocator ，我們現在不允許現在自定義ID分配器。
  • 需要GCC 4.8+，MSVC 15+（Visual Studio 2017）>）
  • 需要CMAKE 3.12.0或上部

安裝

libcopp使用cmake生成makefile並開關構建工具。

先決條件

  • [必需] GCC或CLANG或MSVC或CLANG-CL支持ISO C ++ 11和上部
  • [必需] CMAKE 3.16.0和上部
  • [可選] GTEST 1.6.0和上部（支持更好的單位測試）
  • [可選] boost.test（支持測試）

Unix

  • [必需] ar, as, ld （Binutils）或LLVM
  • [可選]如果使用gtest，則需要pthread。

視窗

  • [必需] MASM（在MSVC中）
  • [可選]如果使用gtest，則需要pthread。

使用VCPKG安裝

  1. 克隆和設置VCPKG（請參閱https://github.com/microsoft/vcpkg上的更多詳細信息） 
    git clone https://github.com/Microsoft/vcpkg.git
cd vcpkg
PS > bootstrap-vcpkg.bootstrap
Linux: ~ /$ ./bootstrap-vcpkg.sh
  2. 安裝libcopp 
    PS > . v cpkg install libcopp [--triplet x64-windows-static/x64-windows/x64-windows-static-md and etc...]
Linux: ~ /$ ./vcpkg install libcopp

  3. 請參閱：參考：`與cmake <用法使用一起使用cmake>`在下面的cmake中使用。

自定義構建

  1. 克隆並製作一個構建目錄
    git clone --single-branch --depth=1 -b master https://github.com/owent/libcopp.git
mkdir libcopp/build && cd libcopp/build
  2. 運行cmake命令
     # cmake <libcopp dir> [options...]
cmake .. -DPROJECT_ENABLE_UNITTEST=YES -DPROJECT_ENABLE_SAMPLE=YES
  3. 做libcopp 
    cmake --build . --config RelWithDebInfo # or make [options] when using Makefile
  4. 運行test/sample/benchmark [可選] 
     # Run test => Required: PROJECT_ENABLE_UNITTEST=YES
ctest -VV . -C RelWithDebInfo -L libcopp.unit_test
# Run sample => Required: PROJECT_ENABLE_SAMPLE=YES
ctest -VV . -C RelWithDebInfo -L libcopp.sample
# Run benchmark => Required: PROJECT_ENABLE_SAMPLE=YES
ctest -VV . -C RelWithDebInfo -L libcopp.benchmark
  5. 安裝[可選] 
    cmake --build . --config RelWithDebInfo --target install # or make install when using Makefile

  6. 然後只需包含並鏈接libcopp.*/libcotask.* ，或參見：ref：`與cmake <使用cmake-usage-using-make> make>`對於下面的cmake。

CMAKE選項

選項可以是CMAKE選項。例如控制構建操作的LIBCOPP的設置編譯工具鏈，源目錄或選項。 LIBCOPP選項如下：

選項描述
build_shared_libs = yes |否[default = no]構建動態庫。
libcopp_enable_seginged_stacks = yes |否[default = no]啟用拆分堆棧支持的上下文。
libcopp_enable_valgrind = yes |否[default = yes]啟用valgrind支持的上下文。
project_enable_unittest = yes |否[默認值=否]構建單元測試。
project_enable_sample = yes |否[默認值= no]構建樣本。
libcopp_lock_disable_this_mt = yes |否[default = no]禁用對copp::this_coroutine和cotask::this_task多線程支持。
libcopp_disable_atomic_lock = yes |否[default = no]禁用多線程支持。
libcotask_enable = yes |否[default = yes]啟用構建libcotask。
libcopp_fcontext_use_tsx = yes |否[default = yes]啟用英特爾交易同步擴展（TSX）。
libcopp_macro_tls_stack_protector = yes |否[default = no]用戶需要設置libcopp_macro_tls_stack_protector = on用-fstack-protector編譯時。因為它更改了默認上下文切換邏輯。
gtest_root = [路徑]設置GTEST庫安裝前綴路徑
boost_root = [路徑]設置boost.test庫安裝前綴路徑

用法

與Cmake一起使用

  1. 使用set(Libcopp_ROOT <where to find libcopp/INSTALL_PREFIX>)
  2. 僅使用Find_package（libcopp）使用libcopp模塊。
  3. 示例：（我們假設目標名稱存儲在${CUSTOM_TARGET_NAME}中） 
 find_package (Libcopp CONFIG REQUIRED)
target_link_libraries ( ${CUSTOM_TARGET_NAME} libcopp::cotask)
# Or just using copp by target_link_libraries(${CUSTOM_TARGET_NAME} libcopp::copp)

如果使用MSVC和VCPKG，則CRT必須與VCPKG的三重態匹配，以下這些代碼可能很有幫助： 

 if ( MSVC AND VCPKG_TOOLCHAIN)
    if ( DEFINED ENV{VCPKG_DEFAULT_TRIPLET} AND NOT DEFINED VCPKG_TARGET_TRIPLET)
        set (VCPKG_TARGET_TRIPLET " $ENV{VCPKG_DEFAULT_TRIPLET} " CACHE STRING "" )
    endif ()
    if (VCPKG_TARGET_TRIPLET MATCHES "^.*windows-static$" )
        set (CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>" CACHE STRING "" )
    else ()
        set (CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>DLL" CACHE STRING "" )
    endif ()
endif ()

在https://github.com/microsoft/vcpkg/tree/master/master/ports/libcopp上查看更多詳細信息。

直接使用標題和庫

只需包括標題和鏈接平台的庫文件以使用libcopp即可。 

LIBCOPP_PREFIX= < WHERE TO INSTALL libcopp >

# Example command for build sample with gcc 4.9 or upper on Linux
for source in sample_readme_ * .cpp ; do
    g++ -std=c++14 -O2 -g -ggdb -Wall -Werror -fPIC -rdynamic -fdiagnostics-color=auto -Wno-unused-local-typedefs 
        -I $LIBCOPP_PREFIX /include -L $LIBCOPP_PREFIX /lib64 -lcopp -lcotask $source -o $source .exe ;
done

# Example command for build sample with clang 3.9 or upper and libc++ on Linux
for source in sample_readme_ * .cpp ; do
    clang++ -std=c++17 -stdlib=libc++ -O2 -g -ggdb -Wall -Werror -fPIC -rdynamic        
        -I $LIBCOPP_PREFIX /include -L $LIBCOPP_PREFIX /lib64 -lcopp -lcotask -lc++ -lc++abi  
        $source -o $source .exe ;
done

# AppleClang on macOS just like those scripts upper.
# If you are using MinGW on Windows, it's better to add -static-libstdc++ -static-libgcc to
#     use static linking and other scripts are just like those on Linux. 
 # Example command for build sample with MSVC 1914 or upper on Windows & powershell(Debug Mode /MDd)
foreach ( $source in Get-ChildItem -File -Name . s ample_readme_ * .cpp) {
    cl /nologo /MP /W4 /wd " 4100 " /wd " 4125 " /EHsc /std:c++17 /Zc:__cplusplus /O2 /MDd /I $LIBCOPP_PREFIX /include $LIBCOPP_PREFIX /lib64/copp.lib $LIBCOPP_PREFIX /lib64/cotask.lib $source
}

開始和示例

服務器示例用於使用copp::coroutine_context ， copp::coroutine_context_fiber和cotask::task ：

  1. 使用Coroutine上下文
  2. 使用Coroutine任務
  3. 使用Coroutine任務管理器
  4. 使用堆棧池
  5. 使用task::then或task::await_task
  6. 使用C ++ 20 Coroutine的copp::callable_promise
  7. 使用copp::generator_future for C ++ 20 Coroutine
  8. 自定義錯誤（例如超時）使用C ++ 20 Coroutine
  9. 讓C ++ 20 Coroutine與cotask::task
  10. 使用cotask::task在Windows上使用Windows Fiber和SetUnhandledExceptionFilter

所有示例代碼均可在：ref：`示例<示例_doc_anchor>` and sample。

注意

拆分堆棧支持：如果在Linux和用戶GCC 4.7.0或upper中，請添加-DLIBCOPP_ENABLE_SEGMENTED_STACKS=YES使用拆分堆棧支持的上下文。

建議使用堆棧池代替GCC拆分堆棧。

基準

請參閱CI輸出以獲取最新的基準報告。點擊訪問GitHub動作。

常問問題

問：如何啟用C ++ 20 Coroutine

ANS：ADD /std:c++latest /await MSVC 1932及以下或以下或-std=c++20 -fcoroutines-ts -stdlib=libc++ clang 13及以下或以下或以下或以下或-std=c++20 -fcoroutines for GCC 10。

如果您只能使用-std=c++20 -stdlib=libc++ clang 14或更高，則為GCC 11或更高版本-astd=c++20 ，和/std:c++latest MSVC 1932或更新。

問：libcopp會處理異常嗎？

回答：使用C ++ 11或更高時，LibCopp會捕獲所有未經手的異常，並在恢復Coroutine後將其重新拋棄。

問：為什麼SetUnhandledExceptionFilter無法在coroutine中捕獲未經治療的異常？

ANS： SetUnhandledExceptionFilter僅與Windows光纖一起使用，請參閱sample/sample_readme_11.cpp有關詳細信息。

回饋

如果您有任何疑問，請創建一個問題並提供您的環境信息。例如：

  • OS ：Windows 10 Pro 19041 （可以在運行``MSINFO32``````
  • 編譯器：Visual Studio 2019 C ++ 16.5.5與2019 C ++ V14.25或MSVC 1925/ GCC 9.3.0
  • cmake命令： cmake .. -G "Visual Studio 16 2019" -A x64 -DLIBCOPP_FCONTEXT_USE_TSX=ON -DPROJECT_ENABLE_UNITTEST=ON -DPROJECT_ENABLE_SAMPLE=ON-DCMAKE_BUILD_TYPE=RelWithDebInfo -DCMAKE_INSTALL_PREFIX=%cd%/install-prefix / cmake .. -G Ninja -DLIBCOPP_FCONTEXT_USE_TSX=ON -DPROJECT_ENABLE_UNITTEST=ON -DPROJECT_ENABLE_SAMPLE=ON -DCMAKE_BUILD_TYPE=RelWithDebInfo -DCMAKE_INSTALL_PREFIX=/opt/libcopp
  • 編譯命令： cmake --build . -j
  • 相關環境變量：請CXX所有將CC CMAKE工具鏈AR環境變量

約束

  • Owent

由於

  • Mutouyun
展開
附加信息
相關應用
爲您推薦
相關資訊 全部