KIMOTO / SPVM-0.989062 / lib / SPVM / Document / NativeAPI / Compiler.pm 

            

              
—
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157

              
=head1 Name
SPVM::Document::NativeAPI::Compiler - Compiler Native APIs
=head1 Usage
  void* compiler = env->api->compiler->new_instance();
   
  env->api->compiler->add_include_dir(compiler, "lib");
   
  env->api->compiler->set_start_file(compiler, __FILE__);
  env->api->compiler->get_start_line(compiler, __LINE__ + 1);
  int32_t status = env->api->compiler->compile(compiler, "MyClass");
   
  env->api->compiler->free_instance(compiler);
=head1 Description
The compiler native APIs of L<SPVM> are the APIs to compile SPVM modules.
=head1 Compiler Native APIs
=head2 new_instance
   
  void* (*new_instance)(void);
Creates a compiler object.
=head2 free_instance
   
  void (*free_instance)(void* compiler);
Frees a compiler.
=head2 get_start_line
   
  int32_t (*get_start_line)(void* compiler);
Gets the start line.
=head2 set_start_line
   
  void (*set_start_line)(void* compiler, int32_t start_line);
Sets a start line.
=head2 get_start_file
   
  const char* (*get_start_file)(void* compiler);
Gets the start file.
=head2 set_start_file
   
  void (*set_start_file)(void* compiler, const char* start_file);
Set a start file.
=head2 get_include_dirs_length
   
  int32_t (*get_include_dirs_length)(void* compiler);
Gets the length of the directories for searching modules.
=head2 get_include_dir
  const char* (*get_include_dir)(void* compiler, int32_t index);
Gets a directory for searching modules by an index.
=head2 add_include_dir
   
  void (*add_include_dir)(void* compiler, const char* include_dir);
Adds a directory for searching modules.
=head2 prepend_include_dir
   
  void (*prepend_include_dir)(void* compiler, const char* include_dir);
Prepends a directory for searching modules.
=head2 clear_include_dirs
   
  void (*clear_include_dirs)(SPVM_COMPILER* compiler);
Clears the directories for searching modules.
=head2 add_class_file
  void (*add_class_file)(void* compiler, const char* class_name);
Adds a L<class file|SPVM::Document::NativeAPI::ClassFile> object for a module.
If the class file already exists, nothing is performed.
=head2 delete_class_file
  void (*delete_class_file)(void* compiler, const char* class_name);
   
Deletes a L<class file|SPVM::Document::NativeAPI::ClassFile> object for a module.
=head2 get_class_file
  void* (*get_class_file)(void* compiler, const char* class_name);
Gets the L<class file|SPVM::Document::NativeAPI::ClassFile> object for a module.
=head2 compile
   
  int32_t (*compile)(void* compiler, const char* class_name);
Compiles SPVM modules.
=head2 get_error_messages_length
   
  int32_t (*get_error_messages_length)(void* compiler);
Gets the length of the compilation error messages.
=head2 get_error_message
   
  const char* (*get_error_message)(void* compiler, int32_t index);
Gets a compiler error message by an index.
=head2 get_runtime
  void* (*get_runtime)(void* compiler);
Gets the runtime.
=head1 Native API IDs
  0 new_instance
  1 free_instance
  2 get_start_line
  3 set_start_line
  4 get_start_file
  5 set_start_file
  6 get_include_dirs_length
  7 get_include_dir
  8 add_include_dir
  9 clear_include_dirs
  10 add_class_file
  11 delete_class_file
  12 get_class_file
  13 compile
  14 get_error_message
  15 get_error_messages_length
  16 get_runtime
=head1 Copyright & License
Copyright (c) 2023 Yuki Kimoto
MIT License