V语言12配置包

不念不忘少年蓝@ 2022-10-10 12:58 111阅读 0赞

`#pkgconfig`.告诉编译器用`配置`文件来`编译/链接`模块.  
只要`#flag`中不用`反引号`及为了`安全/可移植`不产生进程,`V`用自己的`pkgconfig`库.其与标准`freedesktop`匹配.未传递标志,则自动加`--cflags和--libs`.下两行意思一样.

#pkgconfig r_core
    #pkgconfig --cflags --libs r_core

在默认的`pkg-config`路径列表中查找`.pc`文件,用户也可用`PKG_CONFIG_PATH`环境变量来加.可传递多个模块.

# 直接包含C代码 #

假设你的`V`模块中有个C目录,根目录下放个`v.mod`,内容为:

Module { 
    	name: "mymodule",
    	description: "包装C库",
    	version: "0.0.1"
    	dependencies: []
    }

模块中加上:

#flag -I @VMODROOT/c
    #flag @VMODROOT/c/implementation.o
    //查找o文件来连接,否则假定有相应c文件,再编译链接
    #include "header.h"

`@VMODROOT`替换为`最近父目录`.`@VMODROOT`目录也预先加至`查找模块路径`.在`@VMODROOT`目录下,其他模块,也直接用名字导入即可.可见`示例`.

# C类型 #

普通C串转为V串:`unsafe { &char(cstring).vstring() }`,知道长度:`unsafe { &char(cstring).vstring_with_len(len) }`.  
注意:`.vstring()和.vstring_with_len()`并不复制`c串`,不要`释放`它.用`cstring_to_vstring(cstring)`来复制`c串`.  
`窗口`中,`c串用宽串`:`string_from_wide(&u16(cwidestring))`.

<table> 
 <thead> 
  <tr> 
   <th align="left"><code>V类型</code></th> 
   <th align="left">等价C类型</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left"><code>voidptr</code></td> 
   <td align="left"><code>void*</code>,</td> 
  </tr> 
  <tr> 
   <td align="left"><code>&amp;byte</code></td> 
   <td align="left"><code>byte*</code></td> 
  </tr> 
  <tr> 
   <td align="left"><code>&amp;char</code></td> 
   <td align="left"><code>char*</code></td> 
  </tr> 
  <tr> 
   <td align="left"><code>&amp;&amp;char</code></td> 
   <td align="left"><code>char**</code></td> 
  </tr> 
 </tbody> 
</table>

转换`空针`至`V引用`:`user := &User(user_void_ptr)`.  
解引用:`voidptr`,用`user := User(user_void_ptr)`.  
`C标识符`通过`C前缀`来访问,在`V`中必须先声明才能使用.`C类型`必须在`C前缀`后用.重声明是为了`访问类型成员`.像这样重声明类型:

struct SomeCStruct { //C构
    	uint8_t implTraits;
    	uint16_t memPoolData;
    	union { 
    		struct { 
    			void* data;
    			size_t size;
    		};
    
    		DataView view;
    	};
    };

子数据结构成员,必须直接声明:

struct C.SomeCStruct { //声明为这样
    	implTraits  byte
    	memPoolData u16
    	//目前不能直接用V表示
    	data voidptr
    	size size_t//为了效率,直接声明.
    	view C.DataView
    }

`V知道存在数据成员`,这样不必再重建.你可嵌入`子结构`来维护并行代码结构.

# 调试 #

用`-b c`.你传递标志.

<table> 
 <thead> 
  <tr> 
   <th align="left"><code>标志</code></th> 
   <th align="left">意思</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left"><code>-g</code></td> 
   <td align="left">较低优化,更多调试信息,一般用<code>-g</code>,低级代码用<code>-cg</code></td> 
  </tr> 
  <tr> 
   <td align="left"><code>-cg</code></td> 
   <td align="left">同上,经常同<code>-keepc</code>一起用.这样,<code>(gdb,lldb)</code>等可显示<code>生成的C源码</code></td> 
  </tr> 
  <tr> 
   <td align="left"><code>-showcc</code></td> 
   <td align="left">打印用C的构建命令</td> 
  </tr> 
  <tr> 
   <td align="left"><code>-show-c-output</code></td> 
   <td align="left">打印编译时输出</td> 
  </tr> 
  <tr> 
   <td align="left"><code>-keepc</code></td> 
   <td align="left">不删生成的<code>C源码</code>.</td> 
  </tr> 
 </tbody> 
</table>

为了最佳的调试你写的`C`包装器,你可以`v -keepc -cg -showcc yourprogram.v`,然后运行调试器.  
用`-o`来生成`C`源码.只看生成的源码中的一个函数:`-printfn main -o file.c`.  
用`V`调试:`./v -g -o v cmd/v.`.调试测试:`v -g -keepc prog_test.v`.  
`v help`列出`v`的所有支持命令.如`v help build/v help build-c`  
命令行调试:`v -g 你好.v`,再用`lldb 你好`.

# 条件编译 #

`$`为编译时操作前缀.如`$如`条件,类似`C++的如 常式/D的静如`了:

//单分支支持多条件
    $if ios || android { 
    	println("移动设备!")
    }
    $if linux && x64 { 
    	println("64位林操.")
    }
    //作为表达式用.
    os := $if windows {  "Windows" } $else {  "UNIX" }
    println("用$os")
    // $异-$如分支
    $if tinyc { 
    	println("tinyc")
    } $else $if clang { 
    	println("clang")
    } $else $if gcc { 
    	println("gcc")
    } $else { 
    	println("不同编译器")
    }
    $if test { 
    	println("测试")
    }
    // v -cg ...
    $if debug { 
    	println("调试")
    }
    // v -prod ...
    $if prod { 
    	println("生产环境")
    }
    // v -d option ...
    $if option ? { 
    	println("自定义选项")
    }

如果想编译时执行,前面要加`$`,目前支持检查`操系/编译器/平台/编译选项`.  
`$if debug`是类似`$if windows/$if x32`的特殊选项.自定义,需要`$if option ? {}`,然后命令行中`v -d option`.目前支持:

<table> 
 <thead> 
  <tr> 
   <th align="left"><code>操系</code></th> 
   <th align="left">编译器</th> 
   <th align="left">平台</th> 
   <th align="left">其他</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left"><code>windows,linux,macos</code></td> 
   <td align="left">gcc,tinyc</td> 
   <td align="left">amd64,arm64</td> 
   <td align="left">调试,生产,测试</td> 
  </tr> 
  <tr> 
   <td align="left"><code>mac,darwin,ios,</code></td> 
   <td align="left">clang,mingw</td> 
   <td align="left">x64,x32</td> 
   <td align="left">js,glibc,预分配</td> 
  </tr> 
  <tr> 
   <td align="left"><code>android,mach,dragonfly</code></td> 
   <td align="left">msvc</td> 
   <td align="left">小头</td> 
   <td align="left">无检查边界,独立</td> 
  </tr> 
  <tr> 
   <td align="left"><code>gnu,hpux,haiku,qnx</code></td> 
   <td align="left">c++</td> 
   <td align="left">大头</td> 
   <td align="left">-</td> 
  </tr> 
 </tbody> 
</table>

`$embed_file`

import os
    fn main() { 
    	embedded_file := $embed_file("v.png")
    	os.write_file("exported.png", embedded_file.to_string()) ?
    }

可用`$embed_file`来嵌入任意文件至`exe`,`相对/绝对`路径均可.不用`-prod`时,不嵌入文件.  
而在运行时调用`f.data()`.使你外部修改程序,而不必重新编译.  
用`-prod`时,嵌入程序,虽然增大了,但自包含,更易分发,`f.data()`不产生`io`,但返回相同数据.  
`$tmpl`嵌入和解析`模板`数据.  
`V`支持`(超)文本模板`,可`$tmpl("path/to/template.txt")`这样嵌入.

fn build() string { 
    	name := "张三"
    	age := 25
    	numbers := [1, 2, 3]
    	return $tmpl("1.txt")
    }
    
    fn main() { 
    	println(build())
    }
    //1.txt如下
    name: @name
    age: @age
    numbers: @numbers
    @for number in numbers
      @number
    @end

`$env`.环境变量:

module main
    
    fn main() { 
    	compile_time_env := $env("ENV_VAR")
    	println(compile_time_env)
    }//编译时从环境变量中取值.

`$env("ENV_VAR")`可用在顶级`#flag和#include`语句中.如`#flag linux -I $env("JAVA_HOME")/include`.

# 环境相关文件 #

<table> 
 <thead> 
  <tr> 
   <th align="left"><code>后缀</code></th> 
   <th align="left">意思</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left"><code>.js.v</code></td> 
   <td align="left">只编译成js</td> 
  </tr> 
  <tr> 
   <td align="left"><code>.c.v</code></td> 
   <td align="left">编译为c</td> 
  </tr> 
  <tr> 
   <td align="left"><code>.native.v</code></td> 
   <td align="left">本地</td> 
  </tr> 
  <tr> 
   <td align="left"><code>_nix.c.v</code></td> 
   <td align="left">联操系统</td> 
  </tr> 
  <tr> 
   <td align="left"><code>_${os}.c.v</code></td> 
   <td align="left">指定操系</td> 
  </tr> 
  <tr> 
   <td align="left"><code>_windows.c.v</code></td> 
   <td align="left">窗口</td> 
  </tr> 
  <tr> 
   <td align="left"><code>_default.c.v</code></td> 
   <td align="left">默认</td> 
  </tr> 
 </tbody> 
</table>

//主.v
    module main
    fn main() {  println(message) }
    //main_default.c.v:
    module main
    const ( message = "你好 world" )
    //main_linux.c.v:
    module main
    const ( message = "你好 linux" )
    //main_windows.c.v:
    
    module main
    const ( message = "你好 windows" )

# 关键字 #

`as asm assert atomic break const continue defer else embed enum false fn for go goto if import in interface is lock match module mut none or pub return rlock select shared sizeof static struct true type typeof union unsafe __offsetof`

# 操作符 #

赋值操作符  
`+=,-=,*=,/=,%=,&=,|=,^=,>>=,<<=`