教程 - 映射 C 语言的基本数据类型

C 语言中的数据类型

C 程序语言中有以下 数据类型:

• 基本类型: char, int, float, double, 以及修饰符 signed, unsigned, short, long

• 结构(Structure), 联合(Union), 数组(Array)

• 指针(Pointer)

• 函数指针(Function Pointer)

还有更加具体的类型:

• Boolean 类型 (由 C99 定义)

• size_t 和 ptrdiff_t (以及 ssize_t)

• 定宽整数类型, 比如 int32_t 或 uint64_t (由 C99 定义)

C 语言中还有以下类型修饰符: const, volatile, restrict, atomic.

我们来看看在 Kotlin 中可以使用哪些 C 数据类型.

创建一个 C 库

在这个教程中, 你不会创建 lib.c 源代码文件, 只有在你想要编译和运行你的 C 库时才需要创建这个文件. 对于我们的教程, 你只需要 .h 头文件, 运行 cinterop 工具 会需要它.

cinterop 工具为每组 .h 文件生成一个 Kotlin/Native 库 (一个 .klib 文件). 生成的库会帮助将 Kotlin/Native 中的调用桥接到 C. 它包含与 .h 文件中的定义对应的 Kotlin 声明.

要创建一个 C 库, 请执行以下步骤:

1. 为你未来的项目创建一个空文件夹.

2. 在文件夹中, 创建一个 lib.h 文件, 内容如下, 看看 C 函数如何映射到 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

   这个文件没有 extern "C" 代码段, 这个示例不需要这部分, 但如果你使用 C++ 和重载(overloaded)函数, 那么可能会需要. 更多详情请参见这个 Stackoverflow 讨论.

3. 创建 lib.def 定义文件, 内容如下:

   headers = lib.h

4. 如果在 cinterop 工具生成的代码中包含宏或其他 C 定义, 这样可以很有用. 通过这种方式, 方法体也会被编译并完全包含在二进制文件中. 使用这个功能, 你可以创建一个可运行的示例, 而不需要使用 C 编译器.

   要实现这一点, 请为来自 lib.h 文件的 C 函数添加实现, 并将这些函数放在一个新的 interop.def 文件的 --- 分隔符之后:

   --- 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) { }

这个 interop.def 文件提供了所有需要的内容, 可以用来编译, 运行, 或在 IDE 中打开应用程序.

创建 Kotlin/Native 项目

要创建项目文件, 请执行以下步骤:

1. 在你的项目文件夹中, 创建一个 build.gradle(.kts) Gradle 构建文件, 内容如下:

   plugins { kotlin("multiplatform") version "2.2.0" } repositories { mavenCentral() } kotlin { macosArm64("native") { // 用于 Apple Silicon 的 macOS 环境 // macosX64("native") { // 用于 x86_64 平台的 macOS 环境 // linuxArm64("native") { // 用于 ARM64 平台的 Linux 环境 // linuxX64("native") { // 用于 x86_64 平台的 Linux 环境 // mingwX64("native") { // 用于 Windows 环境 val main by compilations.getting val interop by main.cinterops.creating binaries { executable() } } } tasks.wrapper { gradleVersion = "8.14" distributionType = Wrapper.DistributionType.BIN }

   plugins { id 'org.jetbrains.kotlin.multiplatform' version '2.2.0' } repositories { mavenCentral() } kotlin { macosArm64("native") { // 用于 Apple Silicon 的 macOS 环境 // macosX64("native") { // 用于 x86_64 平台的 macOS 环境 // linuxArm64("native") { // 用于 ARM64 平台的 Linux 环境 // linuxX64("native") { // 用于 x86_64 平台的 Linux 环境 // mingwX64("native") { // 用于 Windows 环境 compilations.main.cinterops { interop } binaries { executable() } } } wrapper { gradleVersion = '8.14' distributionType = 'BIN' }

   项目文件将 C interop 配置为一个额外的构建步骤. 请查看 Multiplatform Gradle DSL 参考文档, 学习它的各种配置方法.

2. 将你的 interop.def, lib.h, 和 lib.def 文件移动到 src/nativeInterop/cinterop 目录.

3. 创建一个 src/nativeMain/kotlin 目录. 所有的源代码文件应该放在这里, 遵循 Gradle 的建议, 使用默认约定而不是明确配置.

   默认情况下, 来自 C 的所有符号将被导入到 interop 包中.

4. 在 src/nativeMain/kotlin 目录中, 创建一个 hello.kt 桩(stub)文件, 内容如下:

   import interop.* import kotlinx.cinterop.ExperimentalForeignApi @OptIn(ExperimentalForeignApi::class) fun main() { println("Hello Kotlin/Native!") ints(/* fix me*/) uints(/* fix me*/) doubles(/* fix me*/) }

在你了解 C 的基本类型声明在 Kotlin 中会变成什么样之后, 再来完成这些代码.

查看为 C 库生成的 Kotlin API

我们来看看 C 的基本类型如何映射到 Kotlin/Native 中, 并相应的更新示例项目.

通过 IntelliJ IDEA 的 Go to declaration 命令 (Cmd + B/Ctrl + B), 可以跳转到为 C 函数生成的 API:

C 类型直接映射为 Kotlin 类型, char 类型例外, 它映射为 kotlin.Byte, 因为它通常是 8 bit 有符号值:

更新 Kotlin 代码

现在你已经看到了 C 定义, 你可以更新你的 Kotlin 代码. hello.kt 文件中的最终代码大致如下:

为了验证是否一切正确, 请 在你的 IDE 中 运行 runDebugExecutableNative Gradle task, 或使用以下命令, 运行代码:

下一步

在这个教程系列的下一部分, 你将学习在 Kotlin 和 C 之间如何映射结构(Struct)和联合(Union)类型:

继续下一部分