注解(attribute)

V语言可以针对结构体,结构体字段,函数/方法进行注解

注解的格式统一是:[注解名] 或 [注解名:注解扩展内容]

编译器内置注解

结构体注解

结构体注解统一放在结构体定义前

结构体字段注解

结构体字段注解统一放在字段定义后

函数注解

函数注解统一放在函数定义之前

  • [deprecated]

    参考:函数章节

  • [inline]

    参考:函数章节

  • [live]

    参考:函数章节

  • [unsafe]

    参考:unsafe章节

  • [trusted]

    参考:unsafe章节

  • [if debug]

    这个注解表示该函数只有在编译时加上了-d 调试模式的时候,才会被编译生成,并且可以调用

    1. [if debug]
    2. fn foo() {
    3. }

  • [windows_stdcall]

    这个注解只能用于Win32 API,如果需要传递回调函数的时候使用

    1. [windows_stdcall]
    2. fn C.DefWindowProc(hwnd int, msg int, lparam int, wparam int)

  • [console]

    这个注解只能用在main函数前,导入了图形库模块(比如gg,ui)后,命令行窗口就不再显示了,查看不到命令行输出,加上这个注解,命令行窗口就会出现

    1. [console]
    2. fn main() {}

自定义注解

实际上除了编译器内置的注解外,结构体,函数,枚举的定义者可以增加各种自定义注解,然后自己解析,自己使用

注解的扩展性还是比较灵活的

目前结构体注解和结构体字段注解,已经可以通过$for编译时反射来获取所有的注解内容,具体内容可以参考:编译时反射章节

  1. [testing]
  2. struct StructAttrTest {
  3.     foo string [attr1;required] //结构体字段自定义注解
  4.     bar int [attr1; attr2; required]
  5. }
  7. [testing]
  8. struct PubStructAttrTest {
  9.     foo string
  10.     bar int
  11. }
  13. [testing]
  14. enum EnumAttrTest {
  15.     one
  16.     two
  17. }
  19. [testing]
  20. enum PubEnumAttrTest {
  21.     one
  22.     two
  23. }
  25. [attrone] 
  26. [attrtwo] //可以同时有多个注解
  27. enum EnumMultiAttrTest {
  28.     one
  29.     two
  30. }
  32. [attr1;attr2] //在同一个注解中括号内,注解用分号来区隔
  33. fn fn_attribute() {
  34. }
  36. [testing]
  37. fn pub_fn_attribute() {
  38. }
  40. [attrone]
  41. [attrtwo]
  42. fn fn_multi_attribute() {
  43. }
  45. [attrone]
  46. [attrtwo]
  47. fn fn_multi_attribute_single() {
  48. }