为确保你提交的代码身份被 Gitee 正确识别,请执行以下命令完成配置

git config --global user.name userName git config --global user.email userEmail

初次使用 SSH 协议进行代码克隆、推送等操作时,需按下述提示完成 SSH 配置

1 生成 RSA 密钥

2 获取 RSA 公钥内容,并配置到 SSH公钥 中

在 Gitee 上使用 SVN,请访问 使用指南

使用 HTTPS 协议时,命令行会出现如下账号密码验证步骤。基于安全考虑,Gitee 建议 配置并使用私人令牌 替代登录密码进行克隆、推送等操作

Username for 'https://gitee.com': userName

Password for 'https://userName@gitee.com': # 私人令牌

新建文件 新建 Diagram 文件

.github

docs

include

project/cmake

sample

src

test

tools

.clang-format

.clang_complete

.cmake-format.yaml

.gcc-flags.json

.gitattributes

.gitignore

.scan-build.disable

.scan-build.enable

.travis.yml

BOOST_LICENSE_1_0.txt

CHANGELOG.md

CMakeLists.txt

LICENSE

README.rst

appveyor.yml

cmake_dev.bat

cmake_dev.sh

libcopp-config.cmake.in

libcopp

Cross-platform coroutine library in C++ .

Linux+OSX(Clang+GCC)	Windows(VC+MinGW)	Coveralls	Dev branch
Build & Unit Test	AppVeyor build status	Coveralls coverage
Compilers	linux-gcc-4.8	MSVC 14(Visual Studio 2015)
linux-gcc-10	MSVC 15(Visual Studio 2017)
macos-apple-clang-9	MSVC 16(Visual Studio 2019)
macos-apple-clang-12	MinGW64-gcc

https://img.shields.io/github/v/release/owt5008137/libcopp https://img.shields.io/github/languages/code-size/owt5008137/libcopp https://img.shields.io/github/repo-size/owt5008137/libcopp https://img.shields.io/github/forks/owt5008137/libcopp?style=social https://img.shields.io/github/stars/owt5008137/libcopp?style=social

LICENSE

License under the Document

Documents can be found at https://libcopp.atframe.work/doxygen/html/ .(Generated by sphinx and doxygen with docs/libcopp.doxyfile.in).

UPGRADE FROM 1.2.X

• Rename cotask::task::await into cotask::task::await_task
• Replace cotask::task<TCO_MACRO, TTASK_MACRO> with cotask::task<TCO_MACRO> , we don't allow to custom id allocator now.
• Replace cotask::core::standard_int_id_allocator<uint64_t> with copp::util::uint64_id_allocator , we don't allow to custom id allocator now.
• Require gcc 4.7+, MSVC 14+(Visual Studio 2015)>)
• Require INSTALL
  libcopp use Prerequisites

  • [required] GCC or Clang or MSVC or clang-cl support ISO C++ 11 and upper
  • [required] gtest 1.6.0 and upper (Better unit test supported)
  • [optional] Boost.Test (Boost.Test supported)

  Unix

  • [required] ar, as, ld (llvm
  • [optional] if using Windows
    • [required] masm (in MSVC)
    • [optional] if using Install with vcpkg

      1. Clone and setup https://github.com/Microsoft/vcpkg)

         git clone https://github.com/Microsoft/vcpkg.git
         cd vcpkg
         PS> bootstrap-vcpkg.bootstrap
         Linux:~/$ ./bootstrap-vcpkg.sh
         

      2. Install libcopp

         PS> .\vcpkg install libcopp [--triplet x64-windows-static/x64-windows/x64-windows-static-md and etc...]
         Linux:~/$ ./vcpkg install libcopp
         

      3. See :ref:`using with cmake <usage-using with-cmake>` for cmake below.

      Custom Build

      1. Clone and make a build directory

         git clone --single-branch --depth=1 -b master https://github.com/owt5008137/libcopp.git
         mkdir libcopp/build && cd libcopp/build
         

      2. Run cmake command

         # cmake <libcopp dir> [options...]
         cmake .. -DPROJECT_ENABLE_UNITTEST=YES -DPROJECT_ENABLE_SAMPLE=YES
         

      3. Make libcopp

         cmake --build . --config RelWithDebInfo # or make [options] when using Makefile
         

      4. Run test/sample/benchmark [optional]

         # Run test => Required: PROJECT_ENABLE_UNITTEST=YES
         cmake --build . --config RelWithDebInfo --target run_test # or make run_test when using Makefile
         # Run sample => Required: PROJECT_ENABLE_SAMPLE=YES
         cmake --build . --config RelWithDebInfo --target run_sample # or make run_sample when using Makefile
         # Run benchmark => Required: PROJECT_ENABLE_SAMPLE=YES
         cmake --build . --config RelWithDebInfo --target benchmark # or make benchmark when using Makefile
         

      5. Install [optional]

         cmake --build . --config RelWithDebInfo --target install # or make install when using Makefile
         

      6. Then just include and link libcopp.*/libcotask.*, or see :ref:`using with cmake <usage-using with-cmake>` for cmake below.

      CMake Options

      Options can be cmake options. such as set compile toolchains, source directory or options of libcopp that control build actions. libcopp options are listed below:

      Option	Description
      BUILD_SHARED_LIBS=YES|NO	[default=NO] Build dynamic library.
      LIBCOPP_ENABLE_SEGMENTED_STACKS=YES|NO	[default=NO] Enable split stack supported context.(it's only availabe in linux and gcc 4.7.0 or upper)
      LIBCOPP_ENABLE_VALGRIND=YES|NO	[default=YES] Enable valgrind supported context.
      PROJECT_ENABLE_UNITTEST=YES|NO	[default=NO] Build unit test.
      PROJECT_ENABLE_SAMPLE=YES|NO	[default=NO] Build samples.
      LIBCOPP_DISABLE_THIS_MT=YES|NO	[default=NO] Disable multi-thread support for copp::this_coroutine and cotask::this_task.
      LIBCOPP_DISABLE_ATOMIC_LOCK=YES|NO	[default=NO] Disable multi-thread support.
      LIBCOTASK_ENABLE=YES|NO	[default=YES] Enable build libcotask.
      LIBCOPP_FCONTEXT_USE_TSX=YES|NO	[default=YES] Enable USAGE Using with cmake Using set(Libcopp_ROOT <where to find libcopp/INSTALL_PREFIX>) Just using 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) If using MSVC and vcpkg, CRT must match the triplet of vcpkg, these codes below may be helpful: 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 () See more detail on Directly use headers and libraries Just include headers and linking library file of your platform to use 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 .\sample_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 } Get Start & Example There serveral samples to use copp::coroutine_context 、 copp::coroutine_context_fiber and cotask::task : Using coroutine context Using coroutine task Using coroutine task manager Using stack pool Using task::then or task::await_task Using copp::future::future_t and prepare for c++20 coroutine Using c++20 coroutine Using c++20 coroutine with custom generator Custom error (timeout for example) when polling c++20 coroutine task or generator Let c++20 coroutine work with cotask::task Using Windows fiber and SetUnhandledExceptionFilter on Windows with cotask::task All sample codes can be found on :ref:`EXAMPLES <examples_doc_anchor>` and NOTICE Split stack support: if in Linux and user gcc 4.7.0 or upper, add -DLIBCOPP_ENABLE_SEGMENTED_STACKS=YES to use split stack supported context. It's recommanded to use stack pool instead of gcc splited stack. BENCHMARK Please see CI output for latest benchmark report. Click to visit benchmark on Windows . Github Actions . FAQ Q: How to enable c++20 coroutine ANS: Add /std:c++latest /await for MSVC or -std=c++20 -fcoroutines-ts -stdlib=libc++ for clang or -std=c++20 -fcoroutines for gcc. Q: Will libcopp handle exception? ANS: When using c++11 or above, libcopp will catch all unhandled exception and rethrow it after coroutine resumed. Q: Why SetUnhandledExceptionFilter can not catch the unhandled exception in a coroutine? ANS: SetUnhandledExceptionFilter only works with Windows Fiber, please see FEEDBACK If you has any question, please create a issue and provide the information of your environments. For example: OS: Windows 10 Pro 19041 (This can be see after running ``msinfo32``) / Manjaro(Arch) Linux Linux 5.4.39-1-MANJARO Compiler: Visual Studio 2019 C++ 16.5.5 with VS 2019 C++ v14.25 or MSVC 1925/ gcc 9.3.0 CMake Commands: 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 Compile Commands: cmake --build . -j Related Environment Variables: Please provide all the environment variables which will change the cmake toolchain, CC 、 CXX 、 AR and etc. CONSTRIBUTORS THANKS TO /secens/libcopp README BSL-1.0 使用 BSL-1.0 开源许可协议 , MIT 使用 MIT 开源许可协议 0 Stars 1 Watching 0 Forks 保存更改 取消 发行版 暂无发行版 贡献者 全部 语言 C++ 63.4% Assembly 27.9% CMake 5.9% Python 1.1% C 0.9% Other 0.8% 近期动态 不能加载更多了 编辑仓库简介 简介内容 主页 取消 保存更改 马建仓 AI 助手 尝试更多 代码解读 代码找茬 代码优化 1 https://gitee.com/secens/libcopp.git git@gitee.com:secens/libcopp.git secens libcopp libcopp master 点此查找更多帮助 搜索帮助 Git 命令在线学习 如何在 Gitee 导入 GitHub 仓库 Git 仓库基础操作 企业版和社区版功能对比 SSH 公钥设置 如何处理代码冲突 仓库体积过大,如何减小? 如何找回被删除的仓库数据 Gitee 产品配额说明 GitHub仓库快速导入Gitee及同步更新 什么是 Release(发行版) 将 PHP 项目自动发布到 packagist.org 评论 仓库举报 回到顶部 登录提示 该操作需登录 Gitee 帐号,请先登录后再操作。 立即登录 没有帐号,去注册 AltStyle によって変換されたページ (->オリジナル) / アドレス: モード: デフォルト 音声ブラウザ ルビ付き 配色反転 文字拡大 モバイル