From bf874cff90b78078470b35a4e9b23c45735dbe4b Mon Sep 17 00:00:00 2001 From: Yuriy Glukhov Date: Wed, 9 Dec 2015 22:32:58 +0200 Subject: Added a few notes regarding JavaScript --- doc/tut2.txt | 14 ++++++++++++++ 1 file changed, 14 insertions(+) (limited to 'doc/tut2.txt') diff --git a/doc/tut2.txt b/doc/tut2.txt index db9e4cd58..7479d8479 100644 --- a/doc/tut2.txt +++ b/doc/tut2.txt @@ -990,3 +990,17 @@ generated by `treeRepr `_. If at the end of the this example you add ``echo treeRepr(result)`` you should get the same output as using the ``dumpTree`` macro, but of course you can call that at any point of the macro where you might be having troubles. + + +Compilation to JavaScript +========================= + +Nim code can be compiled to JavaScript. However in order to write +JavaScript-compatible code you should remember the following: +- ``addr`` and ``ptr`` have slightly different semantic meaning in JavaScript. + It is recommended to avoid those if you're not sure how they are translated + to JavaScript. +- ``cast[T](x)`` in JavaScript is translated to ``(x)``. +- ``cstring`` in JavaScript means JavaScript string. It is a good practice to + use ``cstring`` only when it is semantically appropriate. E.g. don't use + ``cstring`` as a binary data buffer. -- cgit 1.4.1-2-gfad0