Mapping Primitive Data Types from C
|Last Updated||23 July 2018|
In this tutorial, we learn what C data types are visible in Kotlin/Native and vice versa. You will:
- See what Data Types are in C Language
- Create a tiny C Library that uses those types in exports
- Inspect Generated Kotlin APIs from a C library
- Find how Primitive Types in Kotlin are mapped to C
Types in C Language
What types do we have in the C language? Let's first list all of them. I have used the C data types article from Wikipedia as a basis. There are following types in the C programming language:
- basic types
char, int, float, doublewith modifiers
signed, unsigned, short, long
- structures, unions, arrays
- function pointers
There are also more specific types:
- boolean type (from C99)
- fixed width integer types, e.g.,
There are also the following type qualifiers in the C language:
The best way to see what C data types are visible in Kotlin is to try it
An Example C Library
We create a
lib.h file to see how C functions are mapped into Kotlin:
#ifndef LIB2_H_INCLUDED #define LIB2_H_INCLUDED void ints(char c, short d, int e, long f); void uints(unsigned char c, unsigned short d, unsigned int e, unsigned long f); void doubles(float a, double b); #endif
The file is missing the
extern "C" block, which is not needed for our example, but may be
necessary if you use C++ and overloaded functions. For more details on this, you may want to check out the
It is only necessary to have a
.h file to run the
cinterop tool. And we do not need to create a
lib.c file, unless we want to compile and run the example.
We still need to create a
.def file to the
cinterop. For more details on this,
you may want to check out Interop with C Libraries. It is enough for
the tutorial to create the
lib.def file with the following content:
headers = lib.h
We could have avoided creating the
.h file and placed declarations
directly to the
.def file. This is what we do in the next tutorial.
Inspecting Generated Kotlin APIs for a C library
We need to have a Kotlin compiler on our machines.
You may want to have a look at the
A Basic Kotlin Application
tutorial for more information on performing this step.
Let's assume we have a console, where the
klib commands are available.
Now we are ready to compile the library and to import it into Kotlin. Let's call the following commands:
cinterop -def lib.def -compilerOpts "-I." -o lib.klib klib contents lib.klib
cinterop command generates the
lib.klib, the Kotlin library, which is the bridge to call C code. The
command prints the API of the library to the console.
Primitive Types in Kotlin
klib calls we see the following API:
fun doubles(a: Float, b: Double) fun uints(c: UByte, d: UShort, e: UInt, f: ULong) fun ints(c: Byte, d: Short, e: Int, f: Long)
C types are mapped in the way you would expect, note that
char type is mapped to
as it is usually an 8-bit unsigned value.
|unsigned long long||kotlin.ULong|
We will continue to explore more complicated C language types and their representation in Kotlin/Native in the next tutorials:
You may also like to take a look at the C Interop documentation for more advanced scenarios.