Emit编译指示

emit 编译指示可用于直接影响编译器代码生成器的输出。 因此，它使您的代码无法移植到其他代码生成器/后端。 它的使用非常不鼓励的！但是，它对于与 C++ 或 Objective C 代码非常有用。

示例：

  1. {.emit: """
  2. static int cvariable = 420;
  3. """.}
  4.  
  5. {.push stackTrace:off.}
  6. proc embedsC() =
  7.   var nimVar = 89
  8.   # 访问字符串文字之外的发送部分中的Nim符号：
  9.   {.emit: ["""fprintf(stdout, "%d\n", cvariable + (int)""", nimVar, ");"].}
  10. {.pop.}
  11.  
  12. embedsC()

nimbase.h 定义了 NIM_EXTERNC C宏，它可以用于 extern "C"代码，用于nim c 和 nim cpp ，例如：

  1. proc foobar() {.importc:"$1".}
  2. {.emit: """
  3. #include <stdio.h>
  4. NIM_EXTERNC
  5. void fun(){}
  6. """.}

为了向后兼容，如果emit语句的参数是单个字符串文字，则可以通过反引号引用Nim符号。 但是不推荐使用此用法。

对于顶级emit语句， 生成的C/C++文件中应该发出代码的部分可以通过前缀 /TYPESECTION/ 或 /VARSECTION/ 或 /INCLUDESECTION/ 来影响:

  1. {.emit: """/*TYPESECTION*/
  2. struct Vector3 {
  3. public:
  4.   Vector3(): x(5) {}
  5.   Vector3(float x_): x(x_) {}
  6.   float x;
  7. };
  8. """.}
  9.  
  10. type Vector3 {.importcpp: "Vector3", nodecl} = object
  11.   x: cfloat
  12.  
  13. proc constructVector3(a: cfloat): Vector3 {.importcpp: "Vector3(@)", nodecl}