CppSharp

Tools and libraries to glue C/C++ APIs to high-level languages

c-sharp dotnet mono bindings bridge c clang cplusplus cppsharp glue interop parser parsing pinvoke swig syntax-tree visitors xamarin xamarin-bindings

Trung Nguyen add3aba684 CSharp: More default parameter fixes (#1747 ) - Expression generation for `ConstructorReference` now also recursively calls `VisitExpression` for the argument if only one argument is detected. This allows correct overload generation for functions taking a variable as the default parameter value. - Default parameters of pointer-to-enumeration types are now correctly generated similar to primitive types.		2 years ago
.github	Update action steps to latest to fix Node.js deprecation warnings.	2 years ago
build	Workaround Directory.Build.props getting picked up when building LLVM.	2 years ago
docs	Allow passing a `-target-framework` option to `build.sh` (#1718 )	2 years ago
examples	Remove QuickJS example, we have proper tests now.	4 years ago
include	document syntax warning	4 years ago
src	CSharp: More default parameter fixes (#1747 )	2 years ago
tests	CSharp: More default parameter fixes (#1747 )	2 years ago
.gitattributes	Add .gitattributes	11 years ago
.gitignore	Attempt to resolve a GitHub CI Actions isue: CI is currently failing because restore can't find NUnit and friends. The error message and google search indicate that GitHub Actions is only looking in the "Microsoft Visual Studio Offline Packages" cache. Add a nuget.config file to in an attempt to tell GitHub Actions to query nuget.org in addition to the offline cache.	4 years ago
.gitmodules	Code cleanups and improvements (#1713 )	2 years ago
CHANGELOG.md	Document release 1.0.1	3 years ago
CONTRIBUTING.md	Fixed a typing and a grammatical error in the guide to contributing.	8 years ago
CppSharp.code-workspace	Add CppSharp VS Code workspace.	4 years ago
Directory.Build.props	Code cleanups and improvements (#1713 )	2 years ago
Directory.Packages.props	Update NuGet dependencies	4 years ago
LICENSE	Clarified that the license of CppSharp is MIT.	9 years ago
README.md	Update README.md	2 years ago
nuget.config	Attempt to resolve a GitHub CI Actions isue: CI is currently failing because restore can't find NUnit and friends. The error message and google search indicate that GitHub Actions is only looking in the "Microsoft Visual Studio Offline Packages" cache. Add a nuget.config file to in an attempt to tell GitHub Actions to query nuget.org in addition to the offline cache.	4 years ago
version.json	Use Nerdbank.GitVersioning	3 years ago

README.md

CppSharp is a tool and set of libraries which facilitates the usage of native C/C++ code with the .NET ecosystem.

It consumes C/C++ header and library files and generates the necessary glue code to surface the native API as a managed API. Such an API can be used to consume an existing native library in your managed code or add managed scripting support to a native codebase.

The supported target languages at present are C# and C++/CLI.

It can also be used as a library to parse native code into a syntax tree with a rich declaration and type information model.

Releases/Build Status

NuGet Packages	Continuous Integration

Libraries
Documentation
Community
Support
Users

Libraries

AST

Mirrors the Clang's C/C++ AST and type system classes in C# APIs.

Check out Clang's AST introduction docs for more details about its architecture.

C++ declarations
C++ statements / expressions
C++ types
Class object layout
Declaration visitors
Type visitors

Parser

Provides APIs for parsing of C/C++ source code into a syntax tree.

Parsing of C/C++ source code
Parsing of libraries archives symbols
Parsing of shared libraries symbols
Based on the very accurate Clang C++ parser.

Generator

Generates the glue binding code from a syntax tree of the native code.

Multiple backends: C++/CLI and C# (P/Invoke)
Multiple ABIs: Itanium, MS, ARM, iOS
Multiple platforms: Windows, OS X and Linux
Multiple runtimes: .NET and Mono
C++ virtual methods overriding from managed code
C++ multiple inheritance by translating to C# interfaces
C++ std::string
C++ default parameter values
C/C++ semantic comments (Doxygen) to C# comments
Extensible bindings semantics via user passes and type mapping

Documentation

Please see the following resources for more information:

Getting Started

User's Manual

Developer's Manual

Community

Feel free to open up issues on Github for any problems you find.

Support

For building wrappers and priority support please write to cppsharp@protonmail.com. Alternatively, you may post bounties at https://www.bountysource.com/.

Users

CppSharp is used by the following projects:

Please feel free to send us a pull request adding your own projects to the list above.