update: first mapping tutorial revamp #4708

danil-pavlov · 2025-02-17T18:04:17Z

No description provided.

daniCsorbaJB

Great addition - I left a couple of comments, please let me know what you think

daniCsorbaJB · 2025-02-18T09:20:39Z

docs/topics/native/mapping-primitive-data-types-from-c.md


-Create a `lib.h` file to see how C functions are mapped into Kotlin:
+There are the following [data types in the C programming language](https://en.wikipedia.org/wiki/C_data_types):


Suggested change

There are the following [data types in the C programming language](https://en.wikipedia.org/wiki/C_data_types):

The C programming language has the following [data types](https://en.wikipedia.org/wiki/C_data_types):

Might not be the best because of the link anchor with this suggestion, but "There are the following data types" feels a bit awkward to me 🤔

daniCsorbaJB · 2025-02-18T09:21:45Z

docs/topics/native/mapping-primitive-data-types-from-c.md

-#define LIB2_H_INCLUDED
+* Basic types: `char, int, float, double` with modifiers `signed, unsigned, short, long`
+* Structures, unions, arrays
+* Structures, unions, arrays


duplicate list element?

daniCsorbaJB · 2025-02-24T09:20:26Z

docs/topics/native/mapping-primitive-data-types-from-c.md


-The best way to see what C data types are visible in Kotlin is to try it.
+You can use the command line to generate a Kotlin library, either directly or with a script file (such as `.sh` or `.bat` file).
+However, this approach doesn't scale well for big projects that have hundreds of files and libraries.


Suggested change

However, this approach doesn't scale well for big projects that have hundreds of files and libraries.

However, this approach doesn't scale well for large projects that have hundreds of files and dependencies.

it might be incorrect to say dependencies instead of libraries but if it's correct I feel like it could be more encompassing than saying libraries here (or perhaps we could say library dependencies?).

with big vs large projects - tbh both works I think large might be a bit more formal but that's it.

daniCsorbaJB · 2025-02-24T09:22:50Z

docs/topics/native/mapping-primitive-data-types-from-c.md

+You can use the command line to generate a Kotlin library, either directly or with a script file (such as `.sh` or `.bat` file).
+However, this approach doesn't scale well for big projects that have hundreds of files and libraries.
+Using a build system simplifies the process by downloading and caching the Kotlin/Native
+compiler binaries and libraries with transitive dependencies, and by running the compiler and tests.


Suggested change

compiler binaries and libraries with transitive dependencies, and by running the compiler and tests.

compiler binaries and libraries with transitive dependencies, as well as running the compiler and tests.

might be a bit more of a smooth transition but the original is also fine I think

daniCsorbaJB · 2025-02-24T09:23:46Z

docs/topics/native/mapping-primitive-data-types-from-c.md

-#define LIB2_H_INCLUDED
+* Basic types: `char, int, float, double` with modifiers `signed, unsigned, short, long`
+* Structures, unions, arrays
+* Structures, unions, arrays


Suggested change

* Structures, unions, arrays

daniCsorbaJB · 2025-02-24T11:17:06Z

docs/topics/native/mapping-primitive-data-types-from-c.md

-}
-```
+    The project file configures the C interop as an additional build step.
+    Check out the [Multiplatform Gradle DSL reference](multiplatform-dsl-reference.md) to learn about all the different


Suggested change

Check out the [Multiplatform Gradle DSL reference](multiplatform-dsl-reference.md) to learn about all the different

Check out the [Multiplatform Gradle DSL reference](multiplatform-dsl-reference.md) to learn about the different

(suggestion)
it feels good to me even without it and a bit more concise

daniCsorbaJB · 2025-02-24T11:19:40Z

docs/topics/native/mapping-primitive-data-types-from-c.md


-## Primitive types in kotlin
+Let's see how C primitive types are mapped into Kotlin/Native and fix the example project. 


Suggested change

Let's see how C primitive types are mapped into Kotlin/Native and fix the example project.

Let's see how C primitive types are mapped into Kotlin/Native and update the example project accordingly.

daniCsorbaJB · 2025-02-24T11:24:57Z

docs/topics/native/mapping-primitive-data-types-from-c.md

-With the help of IntelliJ IDEA's __Go to | Declaration__ or
-compiler errors, you see the following generated API for the C functions:
+With the help of IntelliJ IDEA's [Go to declaration](https://www.jetbrains.com/help/rider/Navigation_and_Search__Go_to_Declaration.html)
+command (<shortcut>Cmd + B</shortcut>/<shortcut>Ctrl + B</shortcut>), you can see the following generated API for C functions:


Suggested change

command (<shortcut>Cmd + B</shortcut>/<shortcut>Ctrl + B</shortcut>), you can see the following generated API for C functions:

command (<shortcut>Cmd + B</shortcut>/<shortcut>Ctrl + B</shortcut>), you can view the following generated API for C functions:

daniCsorbaJB · 2025-02-24T11:27:43Z

docs/topics/native/mapping-primitive-data-types-from-c.md

+
+## Update Kotlin code
+
+Now that you've seen C definitions, you can update Kotlin code. The final code in the `hello.kt` file may look like this:


Suggested change

Now that you've seen C definitions, you can update Kotlin code. The final code in the `hello.kt` file may look like this:

Now that you've seen the C definitions, you can update the Kotlin code. The final code in the `hello.kt` file may look like this:

daniCsorbaJB · 2025-02-24T11:28:08Z

docs/topics/native/mapping-primitive-data-types-from-c.md

 }
 ```

-## Next steps
+To check that everything works as expected, run the `linkDebugSharedNative` Gradle task [in IDE](native-get-started.md#build-and-run-the-application)


Suggested change

To check that everything works as expected, run the `linkDebugSharedNative` Gradle task [in IDE](native-get-started.md#build-and-run-the-application)

To verify that everything works as expected, run the `linkDebugSharedNative` Gradle task [in IDE](native-get-started.md#build-and-run-the-application)

update: first mapping tutorial revamp

9348447

danil-pavlov requested a review from a team as a code owner February 17, 2025 18:04

danil-pavlov assigned daniCsorbaJB Feb 19, 2025

daniCsorbaJB self-requested a review February 20, 2025 09:01

daniCsorbaJB reviewed Feb 24, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

update: first mapping tutorial revamp #4708

update: first mapping tutorial revamp #4708

danil-pavlov commented Feb 17, 2025

daniCsorbaJB left a comment

daniCsorbaJB Feb 18, 2025

daniCsorbaJB Feb 18, 2025

daniCsorbaJB Feb 18, 2025

daniCsorbaJB Feb 24, 2025

daniCsorbaJB Feb 24, 2025

daniCsorbaJB Feb 24, 2025

daniCsorbaJB Feb 24, 2025

daniCsorbaJB Feb 24, 2025

daniCsorbaJB Feb 24, 2025

daniCsorbaJB Feb 24, 2025

daniCsorbaJB Feb 24, 2025

daniCsorbaJB Feb 24, 2025

daniCsorbaJB Feb 24, 2025

daniCsorbaJB Feb 24, 2025


		Create a `lib.h` file to see how C functions are mapped into Kotlin:
		There are the following [data types in the C programming language](https://en.wikipedia.org/wiki/C_data_types):

	There are the following [data types in the C programming language](https://en.wikipedia.org/wiki/C_data_types):
	The C programming language has the following [data types](https://en.wikipedia.org/wiki/C_data_types):

	However, this approach doesn't scale well for big projects that have hundreds of files and libraries.
	However, this approach doesn't scale well for large projects that have hundreds of files and dependencies.

	compiler binaries and libraries with transitive dependencies, and by running the compiler and tests.
	compiler binaries and libraries with transitive dependencies, as well as running the compiler and tests.

	Check out the [Multiplatform Gradle DSL reference](multiplatform-dsl-reference.md) to learn about all the different
	Check out the [Multiplatform Gradle DSL reference](multiplatform-dsl-reference.md) to learn about the different


		## Primitive types in kotlin
		Let's see how C primitive types are mapped into Kotlin/Native and fix the example project.

	command (<shortcut>Cmd + B</shortcut>/<shortcut>Ctrl + B</shortcut>), you can see the following generated API for C functions:
	command (<shortcut>Cmd + B</shortcut>/<shortcut>Ctrl + B</shortcut>), you can view the following generated API for C functions:


		## Update Kotlin code

		Now that you've seen C definitions, you can update Kotlin code. The final code in the `hello.kt` file may look like this:

	Now that you've seen C definitions, you can update Kotlin code. The final code in the `hello.kt` file may look like this:
	Now that you've seen the C definitions, you can update the Kotlin code. The final code in the `hello.kt` file may look like this:

	To check that everything works as expected, run the `linkDebugSharedNative` Gradle task [in IDE](native-get-started.md#build-and-run-the-application)
	To verify that everything works as expected, run the `linkDebugSharedNative` Gradle task [in IDE](native-get-started.md#build-and-run-the-application)

update: first mapping tutorial revamp #4708

Are you sure you want to change the base?

update: first mapping tutorial revamp #4708

Conversation

danil-pavlov commented Feb 17, 2025

daniCsorbaJB left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment