CodePorting.Native.Cs2Cpp.PortingControl

Description

CodePorting.Native Cs2Cpp is a framework capable of translating C# code to C++. The resulting code provides the same API original .Net code had and can run in the native (unmanaged) C++ environment.

CodePorting.Native.Cs2Cpp.PortingControl package makes it possible to fine-tune the translated code. There are two ways to do so: attributes and service classes.

Attributes

The attributes defined in the CodePorting.Native.Cs2Cpp.PortingControl package are recognized by the code porter (translator) and affect how the output code looks. It is possible to remove, stub or rename members, use weak pointers instead of shared pointers, move arrays from heap to stack, alter inheritance scheme, change includes list, add C++-specific declarations (such as friend class, constexpr field or const method) and so on. To use these attributes, add reference to this package into the project being ported and use the attributes in the code. See the Attributes guide for more details.

Service classes

There are several service classes provided in the CodePorting.Native.Cs2Cpp.PortingControl package that may be used in the original C# code. When this code gets translated to C++, the porter replaces calls into these classes with calls into C++-specific versions of them, thus providing the means of inserting the C++-specific operations into the C# code. For example, the MemoryManagement class provides the ways to control the lifetime of objects in C++ (this should only be used occasionally, where the default translation doesn't work well) without doing any changes to C# code behavior. The Porter class provides the means to check if the code is being executed in C# or C++. Based on the result, one can choose an appropriate logic at runtime. See The Memory management model for more details.

Usage

Make your project depend on CodePorting.Native.Cs2Cpp.PortingControl:

<PackageReference Include="CodePorting.Native.Cs2Cpp.PortingControl" Version="*" />

Now you can use the attributes and service classes from your code:

using System;
using CsToCppPorter;
using CodePorting.Native.Cs2Cpp;

namespace PortedProject
{
    public abstract class MyClass
    {
        [CppWeakPtr, CppMutable]
        private MyClass Parent;

        [CppConstMethod]
        public void DoSomething()
        {
            Parent = this;
            if (Porter.IsPorted)
                PerformCppSpecificOperations();
            else
                PerformCsSpecificOperations();
        }

        protected abstract void PerformCppSpecificOperations();
        protected abstract void PerformCsSpecificOperations();
    }
}

Now, when you use the CodePorting.Native Cs2Cpp to translate your project to C++, the porter will recognize the attributes or service classes and generate the code accordingly.

Resources

• Website: www.codeporting.com
• Product Home: CodePorting.Native Cs2Cpp
• Download: Install CodePorting.Native Cs2Cpp
• Documentation: CodePorting.Native Cs2Cpp Documentation
• Free Support Forum: CodePorting.Native Cs2Cpp Free Support Forum
• Blog: CodePorting.Native Cs2Cpp Blog