Binder of Unmanaged code for .NET
The Conari represents a flexible platform to work with unmanaged code, other native and binary data. The lightweight and powerful binding from any exported functions of libraries (a library or executable module), and more...
Did you know: The LunaRoad project works via Conari engine.
Easy to start:
using(IConari c = new ConariL("Library.dll")) {
// ...
}Conari is ready for any exported functions immediately via:
Dynamic features / DLR:
var ptr = d.test<IntPtr>(); // eqv: l.bind<Func<IntPtr>>("test")();
var codec = d.avcodec_find_encoder<IntPtr>(AV_CODEC_ID_MP2); // eqv: l.bind<Func<ulong, IntPtr>>("avcodec_find_encoder")(AV_CODEC_ID_MP2);
d.push(); // eqv: l.bind<Action>("push")();It does not require the any configuration from you, we will do it automatically. Easy and works well.
Lambda expressions:
using(var c = new ConariL("Library.dll"))
{
c.bind<Action<int, int>>("call")(2, 1);
double num = c.bind<Func<IntPtr, int, double>>("tonumber")(L, 4);
}This also does not require the creation of any additional delegate. The Conari will do it automatically instead of you.
Just use bind<> methods and have fun !
c.bind<...>("function")// you already may invoke it immediately as above:
c.bind<Action<int, string>>("set")(-1, "Hello from Conari !");
// or later:
var set = c.bind<Action<int, string>>("set");
...
set(-1, "Hello from Conari !");Lazy loading:
using(var l = new ConariL(
new Config("Library.dll") {
LazyLoading = true
}))
{
...
}Native C/C++ structures without declaration [?]:
// IMAGE_FILE_HEADER: https://msdn.microsoft.com/en-us/library/windows/desktop/ms680313.aspx
dynamic ifh = NativeData
._(data)
.t<WORD, WORD>(null, "NumberOfSections")
.align<DWORD>(3)
.t<WORD, WORD>("SizeOfOptionalHeader")
.Raw.Type;
if(ifh.SizeOfOptionalHeader == 0xE0) { // IMAGE_OPTIONAL_HEADER32
...
}
// IMAGE_DATA_DIRECTORY: https://msdn.microsoft.com/en-us/library/windows/desktop/ms680305.aspx
dynamic idd = (new NativeData(data))
.t<DWORD>("VirtualAddress") // idd.VirtualAddress
.t<DWORD>("Size") // idd.Size
.Raw.Type;Raw mt = NativeData
._(ptr)
.align<int>(2, "a", "b")
.t<IntPtr>("name")
.Raw;
- {byte[0x0000000c]} byte[]
[0] 0x05 byte --
[1] 0x00 byte |
[2] 0x00 byte |
[3] 0x00 byte --^ a = 5
[4] 0x07 byte --
[5] 0x00 byte |
[6] 0x00 byte |
[7] 0x00 byte --^ b = 7
[8] 0x20 byte --
[9] 0x78 byte |_ pointer to allocated string: (CharPtr)name
[10] 0xf0 byte |
[11] 0x56 byte --
...Calling Convention & Name-Decoration [?]:
using(var l = new ConariL("Library.dll", CallingConvention.StdCall))
{
//...
l.Mangling = true; // _get_SevenStdCall@0 <-> get_SevenStdCall
l.Convention = CallingConvention.Cdecl;
}Additional types:
- BSTR, CharPtr, float_t, int_t, ptrdiff_t, size_t, uint_t, WCharPtr
- UnmanagedString - to allocation of new unmanaged strings for your unmanaged code.
- ...
size_t len;
CharPtr name = c.bind<FuncOut3<int, size_t, IntPtr>>("to")(1, out len);
...
string myName += name; // (IntPtr)name; .Raw; .Ansi; .Utf8; ...
...
uint_t v = dll.getU(2);Events:
l.ConventionChanged += (object sender, DataArgs<CallingConvention> e) =>
{
DLR = newDLR(e.Data);
LSender.Send(sender, $"DLR has been updated with new CallingConvention: {e.Data}", Message.Level.Info);
};
l.BeforeUnload += (object sender, DataArgs<Link> e) =>
{
// Do not forget to do something before unloading a library
};
...and more !
How about to use regXwild (Fast and powerful wildcards on C++) in your C# code ? It easy:
using(var l = new ConariL("regXwild.dll")) {
...
if(l.DLR.searchEssC<bool>((WCharPtr)data, (WCharPtr)filter, false)) {
// ...
}
}yes, you don't need to do anything else ! The Conari will prepare all required operations and binding with native method instead of you:
REGXWILD_API bool searchEssC(const TCHAR* data, const TCHAR* filter, bool ignoreCase);have fun !
Copyright (c) 2016 Denis Kuzmin <entry.reg@gmail.com>
Available variants:
- NuGet PM:
Install-Package Conari - GetNuTool:
msbuild gnt.core /p:ngpackages="Conari"or gnt /p:ngpackages="Conari" - NuGet Commandline:
nuget install Conari - /releases ( latest )
- Nightly builds (
/artifactspage). But remember: It can be unstable or not work at all. Use this for tests of latest changes.
