CodePorting.Translator.Cs2Cpp.Control 24.1.0

Description

CodePorting.Translator 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 translator (unmanaged) C++ environment.

CodePorting.Translator.Cs2Cpp.Control 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.Translator.Cs2Cpp.Control package are recognized by the code 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 translated 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.Translator.Cs2Cpp.Control package that may be used in the original C# code. When this code gets translated to C++, the translator 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 Translator 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.Translator.Cs2Cpp.Control:

<PackageReference Include="CodePorting.Translator.Cs2Cpp.Control" Version="*" />

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

using System;
using CodePorting.Translator.Cs2Cpp;

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

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

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

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

Resources

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