llvm-d 3.0.0
D bindings for LLVM
To use this package, run the following command in your project's root directory:
Manual usage
Put the following dependency into your project's dependences section:
llvm-d
<a href="https://code.dlang.org/packages/llvm-d" title="Go to llvm-d"><img src="https://img.shields.io/dub/v/llvm-d.svg" alt="Dub version"></a><a href="https://code.dlang.org/packages/llvm-d" title="Go to llvm-d"> <img src="https://img.shields.io/dub/dt/llvm-d.svg" alt="Dub downloads"></a>
llvm-d provides bindings to LLVM's C API for the D programming language. It is designed to be linked dynamically against LLVM.
Usage
import llvm;
all of LLVM's C API's functions should be available- Link against either the correct library (LLVM built as singleton), or the correct libraries (LLVM built as several libraries) Note: That includes ensuring your linker can find them
For example:
import std.stdio;
import llvm;
void main(string[] args)
{
static if((asVersion(3, 3, 0) <= LLVM_Version) && (LLVM_Version < asVersion(3, 5, 0)))
{
writefln("LLVM multithreading on? %s", cast(bool) LLVMIsMultithreaded());
writefln("Turning it on"); LLVMStartMultithreaded();
writefln("LLVM multithreading on? %s", cast(bool) LLVMIsMultithreaded());
writefln("Turning it off"); LLVMStopMultithreaded();
writefln("LLVM multithreading on? %s", cast(bool) LLVMIsMultithreaded());
}
}
Note that a static if
is used to ensure the function calls are only compiled
in if llvm-d is set to compile for a viable LLVM version
(the multithreaded functions where added to LLVM's C API in the 3.3 development
cycle and removed in the 3.5 development cycle; thus they are only available in versions 3.3 and 3.4).
A more complex example showing how to create a jitted function calculating
the fibonacci series can be seen at examples/fibonacci/fibonacci.d
.
LLVM versions
The LLVM version to be used is selected by setting a conditional compilation version identifier.
For DMD, this is the -version
argument; for dub, the versions
field.
The identifier to set the LLVM version is defined as
LLVM_{MAJOR_VERSION}_{MINOR_VERSION}_{PATCH_VERSION}
, so to get LLVM version 3.1.0 use LLVM_3_1_0
.
Current supported versions are 3.1.0 - 7.0.0 and if no version is given at compile time, 7.0.0 will be assumed.
LLVM targets
As with the LLVM version, LLVM targets are also selected by setting an appropriate conditional compilation version identifier.
The identifier to enable an LLVM target XyZ is defined as
LLVM_Target_XyZ
, which will instruct llvm-d to assume any C API functions for those targets will be linked in, so to enable the X86 LLVM target, use LLVM_Target_X86
.
Note: The target name is case sensitive.
Note: Multiple targets can be enabled in this manner.
llvm-d supports all targets for the supported LLVM versions and if no target is given at compile time, none will be assumed to be available. The dub package's default configuration sets the appropriate identifier to enable the native target for some common platforms.
Dynamic loading
By default, llvm-d requires you to link against the LLVM library (or libraries in case of a split build).
If you instead wish to load from shared libraries at runtime, set the D version LLVM_Load
. You can then use LLVM.load
and LLVM.unload
for dynamic loading.
If you additionally set the D version LLVM_Autoload
, llvm-d will attempt to load default libraries at program startup.
Note: Enabling dynamic loading will likely result in noticeable compile time increase, as it uses compile time reflection.
Documentation
llvm-d exposes C linkage functions, constants, and types with the same names as LLVM's C API. See the LLVM Doxygen pages for a reference.
License
llvm-d is released under the MIT license, see LICENSE.txt.
llvm-d uses source code from LLVM that has been ported to D for accessing LLVM's C API. The above paragraph does not apply to that source code - it is a redistribution of LLVM source code.
LLVM is Copyright (c) 2003-2018 University of Illinois at Urbana-Champaign. All rights reserved.
LLVM is distributed under the University of Illinois Open Source License. See http://opensource.org/licenses/UoI-NCSA.php for details.
- Registered by Moritz Maxeiner
- 3.0.0 released 5 years ago
- MoritzMaxeiner/llvm-d
- github.com/MoritzMaxeiner/llvm-d
- MIT
- Copyright © 2013-2018 Moritz Maxeiner, Copyright © 2016-2017 Alex Parrill
- Authors:
- Dependencies:
- none
- Versions:
-
3.0.0 2019-Apr-27 2.4.1 2018-Oct-29 2.4.0 2018-Oct-27 2.3.0 2018-Mar-02 2.2.0 2017-May-12 - Download Stats:
-
-
0 downloads today
-
0 downloads this week
-
1 downloads this month
-
898 downloads total
-
- Score:
- 2.3
- Short URL:
- llvm-d.dub.pm