注解
最后更新于
这有帮助吗?
V语言可以对模块,枚举,结构体,结构体字段,函数/方法,变量增加注解。
注解的格式统一是:@[注解名] 或 [注解名:注解扩展内容]。
@[deprecated]
参考:
@[deprecated_after]
参考:
@[flag]注解
参考:
结构体注解统一放在结构体定义前。
@[typedef]
参考:
@[heap]
参考:
@[noinit]
参考:
@[params]
参考:
@[table]
参考:
@[packed]
参考:
@[autostr: allowrecurse]
参考:
结构体字段注解统一放在字段定义后。
@[required]
@[deprecated]
@[json]
@[toml]
@[skip]
@[row]
函数注解统一放在函数定义之前。
@[deprecated]
@[inline]
@[live]
@[unsafe]
@[trusted]
@[export]
@[weak]
@[if xxx平台]
@[if debug]
这个注解表示该函数只有在编译时加上了-d 调试模式的时候,才会被编译生成,并且可以调用。加上@[if debug]注解后函数不可以有返回值。
@[windows_stdcall]
这个注解只能用于Win32 API,如果需要传递回调函数的时候使用。
@[console]
这个注解只能用在main函数前,导入了图形库模块(比如gg,ui)后,命令行窗口就不再显示了,查看不到命令行输出,加上这个注解,命令行窗口就会出现。
@[noinline]
@[direct_array_access]
加了这个注解的函数,在生成C代码时会直接使用C语言中的数组操作,省略边界检查,这样在遍历数组元素时速度会提高不少,代价是不会进行边界检查,函数是不安全的,边界检查由用户代码自己判断。
生成的C代码:
@[manualfree]
@[noreturn]
表示这个函数不会有返回值给函数的调用方,一般来说是函数内有存在exit,panic,无限循环for {},或调用了另一个没有返回值的函数。标记了noreturn的函数,调用方就不会等待该函数返回。
@[keep_args_alive]
函数加上这个注解后,函数的指针参数在函数返回之前不会被GC释放。
@[c_extern]
使用@ [c_extern]注解,在生成的C代码中,给全局变量增加extern关键字。
实际上除了编译器内置的注解外,结构体,结构体字段,函数,枚举,联合类型的定义,都可以增加各种自定义注解,然后自己解析,自己使用。
参考:
参考:
参考:
参考:
参考:
参考:
参考:
参考:
参考:
参考:
参考:
参考:
参考:
参考:
参考。
具体内容可以参考:
注解的扩展性还是比较灵活的,目前结构体注解和结构体字段注解,已经可以通过$for编译时反射来获取所有的注解内容,具体内容可以参考:。