blob: e2ccc3cfa04bc27179ad0755063335254e7ba316 [file] [log] [blame]
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +01001// Copyright (c) 2015 The Khronos Group Inc.
2//
3// Permission is hereby granted, free of charge, to any person obtaining a
4// copy of this software and/or associated documentation files (the
5// "Materials"), to deal in the Materials without restriction, including
6// without limitation the rights to use, copy, modify, merge, publish,
7// distribute, sublicense, and/or sell copies of the Materials, and to
8// permit persons to whom the Materials are furnished to do so, subject to
9// the following conditions:
10//
11// The above copyright notice and this permission notice shall be included
12// in all copies or substantial portions of the Materials.
13//
14// MODIFICATIONS TO THIS FILE MAY MEAN IT NO LONGER ACCURATELY REFLECTS
15// KHRONOS STANDARDS. THE UNMODIFIED, NORMATIVE VERSIONS OF KHRONOS
16// SPECIFICATIONS AND HEADER INFORMATION ARE LOCATED AT
17// https://www.khronos.org/registry/
18//
19// THE MATERIALS ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
20// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
21// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
22// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
23// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
24// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
25// MATERIALS OR THE USE OR OTHER DEALINGS IN THE MATERIALS.
26
David Neto36b0c0f2015-09-16 18:32:54 -040027#include "text.h"
28
Dejan Mircevskiba569fb2015-09-11 16:34:49 -040029#include <algorithm>
30#include <cassert>
Andrew Woloszyn13804e52015-09-22 15:50:33 -040031#include <cctype>
Dejan Mircevskiba569fb2015-09-11 16:34:49 -040032#include <cstdio>
33#include <cstdlib>
David Neto36b0c0f2015-09-16 18:32:54 -040034#include <cstring>
Andrew Woloszyn71fc0552015-09-24 10:26:51 -040035#include <memory>
Dejan Mircevskiba569fb2015-09-11 16:34:49 -040036#include <string>
Andrew Woloszyn71fc0552015-09-24 10:26:51 -040037#include <sstream>
David Neto36b0c0f2015-09-16 18:32:54 -040038#include <unordered_map>
39#include <vector>
Dejan Mircevskiba569fb2015-09-11 16:34:49 -040040
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +010041#include "binary.h"
David Neto36b0c0f2015-09-16 18:32:54 -040042#include "bitwisecast.h"
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +010043#include "diagnostic.h"
44#include "ext_inst.h"
David Netob5dc8fc2015-10-06 16:22:00 -040045#include "instruction.h"
David Neto36b0c0f2015-09-16 18:32:54 -040046#include <libspirv/libspirv.h>
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +010047#include "opcode.h"
48#include "operand.h"
Andrew Woloszyn71fc0552015-09-24 10:26:51 -040049#include "text_handler.h"
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +010050
Andrew Woloszyn13804e52015-09-22 15:50:33 -040051bool spvIsValidIDCharacter(const char value) {
52 return value == '_' || 0 != ::isalnum(value);
53}
54
55// Returns true if the given string represents a valid ID name.
Dejan Mircevski14c4b102015-09-29 17:07:21 -040056bool spvIsValidID(const char* textValue) {
57 const char* c = textValue;
Andrew Woloszyn13804e52015-09-22 15:50:33 -040058 for (; *c != '\0'; ++c) {
59 if (!spvIsValidIDCharacter(*c)) {
60 return false;
61 }
62 }
63 // If the string was empty, then the ID also is not valid.
64 return c != textValue;
65}
66
Andrew Woloszyn71fc0552015-09-24 10:26:51 -040067// Text API
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +010068
Dejan Mircevski903f9d62015-09-28 17:04:39 -040069spv_result_t spvTextToLiteral(const char* textValue, spv_literal_t* pLiteral) {
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +010070 bool isSigned = false;
David Netoaffa6962015-08-24 15:33:14 -040071 int numPeriods = 0;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +010072 bool isString = false;
73
David Netoaffa6962015-08-24 15:33:14 -040074 const size_t len = strlen(textValue);
David Neto98290a22015-08-24 16:27:02 -040075 if (len == 0) return SPV_FAILED_MATCH;
76
David Netoaffa6962015-08-24 15:33:14 -040077 for (uint64_t index = 0; index < len; ++index) {
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +010078 switch (textValue[index]) {
79 case '0':
80 case '1':
81 case '2':
82 case '3':
83 case '4':
84 case '5':
85 case '6':
86 case '7':
87 case '8':
88 case '9':
89 break;
90 case '.':
David Netoaffa6962015-08-24 15:33:14 -040091 numPeriods++;
92 break;
93 case '-':
94 if (index == 0) {
95 isSigned = true;
96 } else {
97 isString = true;
98 }
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +010099 break;
100 default:
101 isString = true;
Lei Zhange78a7c12015-09-10 17:07:21 -0400102 index = len; // break out of the loop too.
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100103 break;
104 }
105 }
106
David Netoaffa6962015-08-24 15:33:14 -0400107 pLiteral->type = spv_literal_type_t(99);
108
Lei Zhange78a7c12015-09-10 17:07:21 -0400109 if (isString || numPeriods > 1 || (isSigned && len == 1)) {
David Neto98290a22015-08-24 16:27:02 -0400110 if (len < 2 || textValue[0] != '"' || textValue[len - 1] != '"')
111 return SPV_FAILED_MATCH;
Andrew Woloszyn3e69cd12015-10-14 12:44:19 -0400112 bool escaping = false;
113 size_t write_index = 0;
114 for(const char* val = textValue + 1; val != textValue + len - 1; ++val) {
115 if ((*val == '\\') && (!escaping)) {
116 escaping = true;
117 } else {
118 // Have to save space for the null-terminator
119 if (write_index >= sizeof(pLiteral->value.str) - 1)
120 return SPV_ERROR_OUT_OF_MEMORY;
121 pLiteral->value.str[write_index] = *val;
122 escaping = false;
123 ++write_index;
124 }
125 }
126
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100127 pLiteral->type = SPV_LITERAL_TYPE_STRING;
Andrew Woloszyn3e69cd12015-10-14 12:44:19 -0400128 pLiteral->value.str[write_index] = '\0';
David Netoaffa6962015-08-24 15:33:14 -0400129 } else if (numPeriods == 1) {
130 double d = std::strtod(textValue, nullptr);
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100131 float f = (float)d;
132 if (d == (double)f) {
133 pLiteral->type = SPV_LITERAL_TYPE_FLOAT_32;
134 pLiteral->value.f = f;
135 } else {
136 pLiteral->type = SPV_LITERAL_TYPE_FLOAT_64;
137 pLiteral->value.d = d;
138 }
139 } else if (isSigned) {
140 int64_t i64 = strtoll(textValue, nullptr, 10);
141 int32_t i32 = (int32_t)i64;
142 if (i64 == (int64_t)i32) {
143 pLiteral->type = SPV_LITERAL_TYPE_INT_32;
144 pLiteral->value.i32 = i32;
145 } else {
146 pLiteral->type = SPV_LITERAL_TYPE_INT_64;
147 pLiteral->value.i64 = i64;
148 }
149 } else {
150 uint64_t u64 = strtoull(textValue, nullptr, 10);
151 uint32_t u32 = (uint32_t)u64;
152 if (u64 == (uint64_t)u32) {
153 pLiteral->type = SPV_LITERAL_TYPE_UINT_32;
154 pLiteral->value.u32 = u32;
155 } else {
156 pLiteral->type = SPV_LITERAL_TYPE_UINT_64;
157 pLiteral->value.u64 = u64;
158 }
159 }
160
161 return SPV_SUCCESS;
162}
163
Dejan Mircevski14c4b102015-09-29 17:07:21 -0400164namespace {
165
166/// Parses an immediate integer from text, guarding against overflow. If
167/// successful, adds the parsed value to pInst, advances the context past it,
168/// and returns SPV_SUCCESS. Otherwise, leaves pInst alone, emits diagnostics,
169/// and returns SPV_ERROR_INVALID_TEXT.
170spv_result_t encodeImmediate(libspirv::AssemblyContext* context,
171 const char* text, spv_instruction_t* pInst) {
172 assert(*text == '!');
David Neto78e677b2015-10-05 13:28:46 -0400173 uint32_t parse_result;
174 if (auto error =
175 context->parseNumber(text + 1, false, &parse_result,
176 "Invalid immediate integer: !"))
177 return error;
178 context->binaryEncodeU32(parse_result, pInst);
Dejan Mircevski14c4b102015-09-29 17:07:21 -0400179 context->seekForward(strlen(text));
180 return SPV_SUCCESS;
181}
182
183} // anonymous namespace
184
Andrew Woloszyn13804e52015-09-22 15:50:33 -0400185/// @brief Translate an Opcode operand to binary form
186///
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400187/// @param[in] grammar the grammar to use for compilation
188/// @param[in, out] context the dynamic compilation info
Andrew Woloszyn13804e52015-09-22 15:50:33 -0400189/// @param[in] type of the operand
190/// @param[in] textValue word of text to be parsed
Andrew Woloszyn13804e52015-09-22 15:50:33 -0400191/// @param[out] pInst return binary Opcode
192/// @param[in,out] pExpectedOperands the operand types expected
Andrew Woloszyn13804e52015-09-22 15:50:33 -0400193///
194/// @return result code
Dejan Mircevski14c4b102015-09-29 17:07:21 -0400195spv_result_t spvTextEncodeOperand(const libspirv::AssemblyGrammar& grammar,
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400196 libspirv::AssemblyContext* context,
197 const spv_operand_type_t type,
198 const char* textValue,
199 spv_instruction_t* pInst,
200 spv_operand_pattern_t* pExpectedOperands) {
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100201 // NOTE: Handle immediate int in the stream
202 if ('!' == textValue[0]) {
Dejan Mircevski14c4b102015-09-29 17:07:21 -0400203 if (auto error = encodeImmediate(context, textValue, pInst)) {
204 return error;
Lei Zhang40056702015-09-11 14:31:27 -0400205 }
Dejan Mircevski897bff92015-09-29 10:38:18 -0400206 *pExpectedOperands =
207 spvAlternatePatternFollowingImmediate(*pExpectedOperands);
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100208 return SPV_SUCCESS;
209 }
210
211 switch (type) {
David Netob14a7272015-09-25 13:56:09 -0400212 case SPV_OPERAND_TYPE_EXECUTION_SCOPE:
David Netoe3f70b92015-08-27 13:50:05 -0400213 case SPV_OPERAND_TYPE_ID:
Andrew Woloszyn537e7762015-09-29 11:28:34 -0400214 case SPV_OPERAND_TYPE_TYPE_ID:
David Neto78c3b432015-08-27 13:03:52 -0400215 case SPV_OPERAND_TYPE_ID_IN_OPTIONAL_TUPLE:
216 case SPV_OPERAND_TYPE_OPTIONAL_ID:
David Netob14a7272015-09-25 13:56:09 -0400217 case SPV_OPERAND_TYPE_MEMORY_SEMANTICS:
218 case SPV_OPERAND_TYPE_RESULT_ID: {
Lei Zhangabafd5e2015-08-21 11:52:29 -0400219 if ('%' == textValue[0]) {
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100220 textValue++;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100221 } else {
David Netoac508b02015-10-09 15:48:09 -0400222 return context->diagnostic() << "Expected id to start with %.";
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100223 }
Andrew Woloszyn13804e52015-09-22 15:50:33 -0400224 if (!spvIsValidID(textValue)) {
David Netoac508b02015-10-09 15:48:09 -0400225 return context->diagnostic() << "Invalid ID " << textValue;
Andrew Woloszyn13804e52015-09-22 15:50:33 -0400226 }
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400227 const uint32_t id = context->spvNamedIdAssignOrGet(textValue);
Andrew Woloszyn537e7762015-09-29 11:28:34 -0400228 if (type == SPV_OPERAND_TYPE_TYPE_ID) pInst->resultTypeId = id;
David Netob5dc8fc2015-10-06 16:22:00 -0400229 spvInstructionAddWord(pInst, id);
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100230 } break;
231 case SPV_OPERAND_TYPE_LITERAL_NUMBER: {
232 // NOTE: Special case for extension instruction lookup
233 if (OpExtInst == pInst->opcode) {
234 spv_ext_inst_desc extInst;
Dejan Mircevski14c4b102015-09-29 17:07:21 -0400235 if (grammar.lookupExtInst(pInst->extInstType, textValue, &extInst)) {
David Netoac508b02015-10-09 15:48:09 -0400236 return context->diagnostic() << "Invalid extended instruction name '"
237 << textValue << "'.";
Lei Zhang40056702015-09-11 14:31:27 -0400238 }
David Netob5dc8fc2015-10-06 16:22:00 -0400239 spvInstructionAddWord(pInst, extInst->ext_inst);
David Neto78c3b432015-08-27 13:03:52 -0400240
241 // Prepare to parse the operands for the extended instructions.
242 spvPrependOperandTypes(extInst->operandTypes, pExpectedOperands);
243
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100244 return SPV_SUCCESS;
245 }
Lei Zhang6d415812015-09-15 13:36:21 -0400246 } // Fall through for the general case.
Lei Zhangb41d1502015-09-14 15:22:23 -0400247 case SPV_OPERAND_TYPE_MULTIWORD_LITERAL_NUMBER:
David Neto561dc4e2015-09-25 14:23:29 -0400248 case SPV_OPERAND_TYPE_LITERAL_NUMBER_IN_OPTIONAL_TUPLE:
249 case SPV_OPERAND_TYPE_OPTIONAL_LITERAL_NUMBER: {
David Neto78e677b2015-10-05 13:28:46 -0400250 libspirv::IdType expected_type = libspirv::kUnknownType;
Andrew Woloszyn537e7762015-09-29 11:28:34 -0400251 // The encoding for OpConstant, OpSpecConstant and OpSwitch all
252 // depend on either their own result-id or the result-id of
253 // one of their parameters.
254 if (OpConstant == pInst->opcode || OpSpecConstant == pInst->opcode) {
255 // Special cases for encoding possibly non-32-bit literals here.
David Neto78e677b2015-10-05 13:28:46 -0400256 expected_type =
Andrew Woloszyn537e7762015-09-29 11:28:34 -0400257 context->getTypeOfTypeGeneratingValue(pInst->resultTypeId);
David Neto78e677b2015-10-05 13:28:46 -0400258 if (!libspirv::isScalarFloating(expected_type) &&
259 !libspirv::isScalarIntegral(expected_type)) {
Andrew Woloszyn537e7762015-09-29 11:28:34 -0400260 spv_opcode_desc d;
261 const char* opcode_name = "opcode";
262 if (SPV_SUCCESS == grammar.lookupOpcode(pInst->opcode, &d)) {
263 opcode_name = d->name;
264 }
David Netoac508b02015-10-09 15:48:09 -0400265 return context->diagnostic()
266 << "Type for " << opcode_name
267 << " must be a scalar floating point or integer type";
Andrew Woloszyn537e7762015-09-29 11:28:34 -0400268 }
269 } else if (pInst->opcode == OpSwitch) {
David Neto78e677b2015-10-05 13:28:46 -0400270 // We need to know the type of the selector.
271 expected_type = context->getTypeOfValueInstruction(pInst->words[1]);
272 if (!libspirv::isScalarIntegral(expected_type)) {
273 context->diagnostic()
274 << "The selector operand for OpSwitch must be the result"
275 " of an instruction that generates an integer scalar";
276 return SPV_ERROR_INVALID_TEXT;
Andrew Woloszyn537e7762015-09-29 11:28:34 -0400277 }
278 }
Andrew Woloszyn537e7762015-09-29 11:28:34 -0400279
David Neto78e677b2015-10-05 13:28:46 -0400280 if (auto error = context->binaryEncodeNumericLiteral(
281 textValue, spvOperandIsOptional(type), expected_type, pInst)) {
282 return error;
283 }
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100284 } break;
David Neto78c3b432015-08-27 13:03:52 -0400285 case SPV_OPERAND_TYPE_LITERAL_STRING:
286 case SPV_OPERAND_TYPE_OPTIONAL_LITERAL_STRING: {
Lei Zhang6d415812015-09-15 13:36:21 -0400287 spv_literal_t literal = {};
288 spv_result_t error = spvTextToLiteral(textValue, &literal);
289 if (error != SPV_SUCCESS) {
290 if (error == SPV_ERROR_OUT_OF_MEMORY) return error;
Lei Zhang40056702015-09-11 14:31:27 -0400291 if (spvOperandIsOptional(type)) return SPV_FAILED_MATCH;
David Netoac508b02015-10-09 15:48:09 -0400292 return context->diagnostic() << "Invalid literal string '" << textValue
293 << "'.";
Lei Zhang40056702015-09-11 14:31:27 -0400294 }
Lei Zhang6d415812015-09-15 13:36:21 -0400295 if (literal.type != SPV_LITERAL_TYPE_STRING) {
David Netoac508b02015-10-09 15:48:09 -0400296 return context->diagnostic(SPV_FAILED_MATCH)
297 << "Expected literal string, found literal number '" << textValue
298 << "'.";
Lei Zhang6d415812015-09-15 13:36:21 -0400299 }
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100300
301 // NOTE: Special case for extended instruction library import
302 if (OpExtInstImport == pInst->opcode) {
Lei Zhang6d415812015-09-15 13:36:21 -0400303 pInst->extInstType = spvExtInstImportTypeGet(literal.value.str);
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100304 }
305
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400306 if (context->binaryEncodeString(literal.value.str, pInst))
Lei Zhang40056702015-09-11 14:31:27 -0400307 return SPV_ERROR_INVALID_TEXT;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100308 } break;
David Neto36b0c0f2015-09-16 18:32:54 -0400309 case SPV_OPERAND_TYPE_FP_FAST_MATH_MODE:
310 case SPV_OPERAND_TYPE_FUNCTION_CONTROL:
311 case SPV_OPERAND_TYPE_LOOP_CONTROL:
David Netoee1b3bb2015-09-18 11:19:18 -0400312 case SPV_OPERAND_TYPE_OPTIONAL_IMAGE:
David Neto5bf88fc2015-09-17 17:06:10 -0400313 case SPV_OPERAND_TYPE_OPTIONAL_MEMORY_ACCESS:
David Neto36b0c0f2015-09-16 18:32:54 -0400314 case SPV_OPERAND_TYPE_SELECTION_CONTROL: {
315 uint32_t value;
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400316 if (grammar.parseMaskOperand(type, textValue, &value)) {
David Netoac508b02015-10-09 15:48:09 -0400317 return context->diagnostic() << "Invalid " << spvOperandTypeStr(type)
318 << " '" << textValue << "'.";
David Neto36b0c0f2015-09-16 18:32:54 -0400319 }
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400320 if (auto error = context->binaryEncodeU32(value, pInst)) return error;
David Neto5bf88fc2015-09-17 17:06:10 -0400321 // Prepare to parse the operands for this logical operand.
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400322 grammar.prependOperandTypesForMask(type, value, pExpectedOperands);
Dejan Mircevski903f9d62015-09-28 17:04:39 -0400323 } break;
324 case SPV_OPERAND_TYPE_OPTIONAL_CIV: {
325 auto error = spvTextEncodeOperand(
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400326 grammar, context, SPV_OPERAND_TYPE_OPTIONAL_LITERAL_NUMBER, textValue,
327 pInst, pExpectedOperands);
Dejan Mircevski903f9d62015-09-28 17:04:39 -0400328 if (error == SPV_FAILED_MATCH) {
329 // It's not a literal number -- is it a literal string?
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400330 error = spvTextEncodeOperand(grammar, context,
331 SPV_OPERAND_TYPE_OPTIONAL_LITERAL_STRING,
332 textValue, pInst, pExpectedOperands);
Dejan Mircevski903f9d62015-09-28 17:04:39 -0400333 }
334 if (error == SPV_FAILED_MATCH) {
335 // It's not a literal -- is it an ID?
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400336 error =
337 spvTextEncodeOperand(grammar, context, SPV_OPERAND_TYPE_OPTIONAL_ID,
338 textValue, pInst, pExpectedOperands);
Dejan Mircevski903f9d62015-09-28 17:04:39 -0400339 }
340 if (error) {
David Netoac508b02015-10-09 15:48:09 -0400341 return context->diagnostic(error)
342 << "Invalid word following !<integer>: " << textValue;
Dejan Mircevski903f9d62015-09-28 17:04:39 -0400343 }
344 if (pExpectedOperands->empty()) {
345 pExpectedOperands->push_back(SPV_OPERAND_TYPE_OPTIONAL_CIV);
346 }
David Neto36b0c0f2015-09-16 18:32:54 -0400347 } break;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100348 default: {
349 // NOTE: All non literal operands are handled here using the operand
350 // table.
351 spv_operand_desc entry;
Dejan Mircevski14c4b102015-09-29 17:07:21 -0400352 if (grammar.lookupOperand(type, textValue, strlen(textValue), &entry)) {
David Netoac508b02015-10-09 15:48:09 -0400353 return context->diagnostic() << "Invalid " << spvOperandTypeStr(type)
354 << " '" << textValue << "'.";
Lei Zhang40056702015-09-11 14:31:27 -0400355 }
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400356 if (context->binaryEncodeU32(entry->value, pInst)) {
David Netoac508b02015-10-09 15:48:09 -0400357 return context->diagnostic() << "Invalid " << spvOperandTypeStr(type)
358 << " '" << textValue << "'.";
Lei Zhang40056702015-09-11 14:31:27 -0400359 }
David Neto78c3b432015-08-27 13:03:52 -0400360
361 // Prepare to parse the operands for this logical operand.
362 spvPrependOperandTypes(entry->operandTypes, pExpectedOperands);
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100363 } break;
364 }
365 return SPV_SUCCESS;
366}
367
Dejan Mircevskif79519c2015-09-11 00:43:11 -0400368namespace {
369
370/// Encodes an instruction started by !<integer> at the given position in text.
371///
372/// Puts the encoded words into *pInst. If successful, moves position past the
373/// instruction and returns SPV_SUCCESS. Otherwise, returns an error code and
374/// leaves position pointing to the error in text.
375spv_result_t encodeInstructionStartingWithImmediate(
Dejan Mircevski14c4b102015-09-29 17:07:21 -0400376 const libspirv::AssemblyGrammar& grammar,
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400377 libspirv::AssemblyContext* context, spv_instruction_t* pInst) {
Dejan Mircevskif79519c2015-09-11 00:43:11 -0400378 std::string firstWord;
379 spv_position_t nextPosition = {};
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400380 auto error = context->getWord(firstWord, &nextPosition);
David Netoac508b02015-10-09 15:48:09 -0400381 if (error) return context->diagnostic(error) << "Internal Error";
Dejan Mircevskif79519c2015-09-11 00:43:11 -0400382
Dejan Mircevski14c4b102015-09-29 17:07:21 -0400383 if ((error = encodeImmediate(context, firstWord.c_str(), pInst))) {
384 return error;
Lei Zhang40056702015-09-11 14:31:27 -0400385 }
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400386 while (context->advance() != SPV_END_OF_STREAM) {
Dejan Mircevskif79519c2015-09-11 00:43:11 -0400387 // A beginning of a new instruction means we're done.
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400388 if (context->isStartOfNewInst()) return SPV_SUCCESS;
Dejan Mircevskif79519c2015-09-11 00:43:11 -0400389
390 // Otherwise, there must be an operand that's either a literal, an ID, or
391 // an immediate.
392 std::string operandValue;
David Netoac508b02015-10-09 15:48:09 -0400393 if ((error = context->getWord(operandValue, &nextPosition)))
394 return context->diagnostic(error) << "Internal Error";
Dejan Mircevskif79519c2015-09-11 00:43:11 -0400395
David Netoac508b02015-10-09 15:48:09 -0400396 if (operandValue == "=")
397 return context->diagnostic() << firstWord << " not allowed before =.";
Dejan Mircevskie3a19c02015-09-11 15:03:54 -0400398
Dejan Mircevskif79519c2015-09-11 00:43:11 -0400399 // Needed to pass to spvTextEncodeOpcode(), but it shouldn't ever be
400 // expanded.
401 spv_operand_pattern_t dummyExpectedOperands;
402 error = spvTextEncodeOperand(
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400403 grammar, context, SPV_OPERAND_TYPE_OPTIONAL_CIV, operandValue.c_str(),
404 pInst, &dummyExpectedOperands);
Lei Zhang40056702015-09-11 14:31:27 -0400405 if (error) return error;
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400406 context->setPosition(nextPosition);
Dejan Mircevskif79519c2015-09-11 00:43:11 -0400407 }
408 return SPV_SUCCESS;
409}
Dejan Mircevskif79519c2015-09-11 00:43:11 -0400410} // anonymous namespace
411
Andrew Woloszyn13804e52015-09-22 15:50:33 -0400412/// @brief Translate single Opcode and operands to binary form
413///
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400414/// @param[in] grammar the grammar to use for compilation
415/// @param[in, out] context the dynamic compilation info
Andrew Woloszyn13804e52015-09-22 15:50:33 -0400416/// @param[in] text stream to translate
417/// @param[in] format the assembly syntax format of text
Andrew Woloszyn13804e52015-09-22 15:50:33 -0400418/// @param[out] pInst returned binary Opcode
419/// @param[in,out] pPosition in the text stream
Andrew Woloszyn13804e52015-09-22 15:50:33 -0400420///
421/// @return result code
Dejan Mircevski14c4b102015-09-29 17:07:21 -0400422spv_result_t spvTextEncodeOpcode(const libspirv::AssemblyGrammar& grammar,
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400423 libspirv::AssemblyContext* context,
424 spv_assembly_syntax_format_t format,
425 spv_instruction_t* pInst) {
Dejan Mircevskif79519c2015-09-11 00:43:11 -0400426 // Check for !<integer> first.
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400427 if ('!' == context->peek()) {
428 return encodeInstructionStartingWithImmediate(grammar, context, pInst);
Dejan Mircevskif79519c2015-09-11 00:43:11 -0400429 }
430
Lei Zhangdfc50082015-08-21 11:50:55 -0400431 // An assembly instruction has two possible formats:
Lei Zhang06efdc52015-09-10 14:00:00 -0400432 // 1(CAF): <opcode> <operand>..., e.g., "OpTypeVoid %void".
433 // 2(AAF): <result-id> = <opcode> <operand>..., e.g., "%void = OpTypeVoid".
Lei Zhangdfc50082015-08-21 11:50:55 -0400434
Lei Zhang06efdc52015-09-10 14:00:00 -0400435 std::string firstWord;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100436 spv_position_t nextPosition = {};
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400437 spv_result_t error = context->getWord(firstWord, &nextPosition);
David Netoac508b02015-10-09 15:48:09 -0400438 if (error) return context->diagnostic() << "Internal Error";
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100439
Lei Zhang06efdc52015-09-10 14:00:00 -0400440 std::string opcodeName;
Lei Zhangdfc50082015-08-21 11:50:55 -0400441 std::string result_id;
442 spv_position_t result_id_position = {};
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400443 if (context->startsWithOp()) {
Lei Zhang06efdc52015-09-10 14:00:00 -0400444 opcodeName = firstWord;
445 } else {
446 // If the first word of this instruction is not an opcode, we must be
447 // processing AAF now.
Lei Zhang40056702015-09-11 14:31:27 -0400448 if (SPV_ASSEMBLY_SYNTAX_FORMAT_ASSIGNMENT != format) {
David Netoac508b02015-10-09 15:48:09 -0400449 return context->diagnostic()
450 << "Expected <opcode> at the beginning of an instruction, found '"
451 << firstWord << "'.";
Lei Zhang40056702015-09-11 14:31:27 -0400452 }
Lei Zhang06efdc52015-09-10 14:00:00 -0400453
454 result_id = firstWord;
Lei Zhang40056702015-09-11 14:31:27 -0400455 if ('%' != result_id.front()) {
David Netoac508b02015-10-09 15:48:09 -0400456 return context->diagnostic()
457 << "Expected <opcode> or <result-id> at the beginning "
458 "of an instruction, found '"
459 << result_id << "'.";
Lei Zhang40056702015-09-11 14:31:27 -0400460 }
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400461 result_id_position = context->position();
Lei Zhang06efdc52015-09-10 14:00:00 -0400462
463 // The '=' sign.
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400464 context->setPosition(nextPosition);
David Netoac508b02015-10-09 15:48:09 -0400465 if (context->advance())
466 return context->diagnostic() << "Expected '=', found end of stream.";
Lei Zhangdfc50082015-08-21 11:50:55 -0400467 std::string equal_sign;
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400468 error = context->getWord(equal_sign, &nextPosition);
David Netoac508b02015-10-09 15:48:09 -0400469 if ("=" != equal_sign)
470 return context->diagnostic() << "'=' expected after result id.";
Lei Zhangdfc50082015-08-21 11:50:55 -0400471
472 // The <opcode> after the '=' sign.
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400473 context->setPosition(nextPosition);
David Netoac508b02015-10-09 15:48:09 -0400474 if (context->advance())
475 return context->diagnostic() << "Expected opcode, found end of stream.";
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400476 error = context->getWord(opcodeName, &nextPosition);
David Netoac508b02015-10-09 15:48:09 -0400477 if (error)
478 return context->diagnostic(error) << "Internal Error";
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400479 if (!context->startsWithOp()) {
David Netoac508b02015-10-09 15:48:09 -0400480 return context->diagnostic() << "Invalid Opcode prefix '" << opcodeName
481 << "'.";
Lei Zhang40056702015-09-11 14:31:27 -0400482 }
Lei Zhangdfc50082015-08-21 11:50:55 -0400483 }
484
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100485 // NOTE: The table contains Opcode names without the "Op" prefix.
Dejan Mircevski903f9d62015-09-28 17:04:39 -0400486 const char* pInstName = opcodeName.data() + 2;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100487
488 spv_opcode_desc opcodeEntry;
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400489 error = grammar.lookupOpcode(pInstName, &opcodeEntry);
Lei Zhang40056702015-09-11 14:31:27 -0400490 if (error) {
David Netoac508b02015-10-09 15:48:09 -0400491 return context->diagnostic(error) << "Invalid Opcode name '"
492 << context->getWord() << "'";
Lei Zhang40056702015-09-11 14:31:27 -0400493 }
Lei Zhang06efdc52015-09-10 14:00:00 -0400494 if (SPV_ASSEMBLY_SYNTAX_FORMAT_ASSIGNMENT == format) {
495 // If this instruction has <result-id>, check it follows AAF.
Lei Zhang40056702015-09-11 14:31:27 -0400496 if (opcodeEntry->hasResult && result_id.empty()) {
David Netoac508b02015-10-09 15:48:09 -0400497 return context->diagnostic()
498 << "Expected <result-id> at the beginning of an "
499 "instruction, found '"
500 << firstWord << "'.";
Lei Zhang40056702015-09-11 14:31:27 -0400501 }
Lei Zhang06efdc52015-09-10 14:00:00 -0400502 }
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100503 pInst->opcode = opcodeEntry->opcode;
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400504 context->setPosition(nextPosition);
David Netob5dc8fc2015-10-06 16:22:00 -0400505 // Reserve the first word for the instruction.
506 spvInstructionAddWord(pInst, 0);
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100507
David Neto78c3b432015-08-27 13:03:52 -0400508 // Maintains the ordered list of expected operand types.
509 // For many instructions we only need the {numTypes, operandTypes}
510 // entries in opcodeEntry. However, sometimes we need to modify
511 // the list as we parse the operands. This occurs when an operand
512 // has its own logical operands (such as the LocalSize operand for
513 // ExecutionMode), or for extended instructions that may have their
514 // own operands depending on the selected extended instruction.
515 spv_operand_pattern_t expectedOperands(
516 opcodeEntry->operandTypes,
517 opcodeEntry->operandTypes + opcodeEntry->numTypes);
Lei Zhangdfc50082015-08-21 11:50:55 -0400518
David Neto78c3b432015-08-27 13:03:52 -0400519 while (!expectedOperands.empty()) {
520 const spv_operand_type_t type = expectedOperands.front();
521 expectedOperands.pop_front();
522
523 // Expand optional tuples lazily.
Lei Zhange78a7c12015-09-10 17:07:21 -0400524 if (spvExpandOperandSequenceOnce(type, &expectedOperands)) continue;
David Neto78c3b432015-08-27 13:03:52 -0400525
526 if (type == SPV_OPERAND_TYPE_RESULT_ID && !result_id.empty()) {
527 // Handle the <result-id> for value generating instructions.
528 // We've already consumed it from the text stream. Here
529 // we inject its words into the instruction.
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400530 spv_position_t temp_pos = context->position();
531 error = spvTextEncodeOperand(grammar, context, SPV_OPERAND_TYPE_RESULT_ID,
532 result_id.c_str(), pInst, nullptr);
533 result_id_position = context->position();
534 // Because we are injecting we have to reset the position afterwards.
535 context->setPosition(temp_pos);
Lei Zhang40056702015-09-11 14:31:27 -0400536 if (error) return error;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100537 } else {
David Neto78c3b432015-08-27 13:03:52 -0400538 // Find the next word.
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400539 error = context->advance();
David Neto78c3b432015-08-27 13:03:52 -0400540 if (error == SPV_END_OF_STREAM) {
541 if (spvOperandIsOptional(type)) {
Lei Zhange78a7c12015-09-10 17:07:21 -0400542 // This would have been the last potential operand for the
543 // instruction,
David Neto78c3b432015-08-27 13:03:52 -0400544 // and we didn't find one. We're finished parsing this instruction.
545 break;
546 } else {
David Netoac508b02015-10-09 15:48:09 -0400547 return context->diagnostic()
548 << "Expected operand, found end of stream.";
David Neto78c3b432015-08-27 13:03:52 -0400549 }
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100550 }
David Neto78c3b432015-08-27 13:03:52 -0400551 assert(error == SPV_SUCCESS && "Somebody added another way to fail");
552
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400553 if (context->isStartOfNewInst()) {
David Neto78c3b432015-08-27 13:03:52 -0400554 if (spvOperandIsOptional(type)) {
555 break;
556 } else {
David Netoac508b02015-10-09 15:48:09 -0400557 return context->diagnostic()
558 << "Expected operand, found next instruction instead.";
David Neto78c3b432015-08-27 13:03:52 -0400559 }
560 }
561
562 std::string operandValue;
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400563 error = context->getWord(operandValue, &nextPosition);
David Netoac508b02015-10-09 15:48:09 -0400564 if (error) return context->diagnostic(error) << "Internal Error";
David Neto78c3b432015-08-27 13:03:52 -0400565
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400566 error = spvTextEncodeOperand(grammar, context, type, operandValue.c_str(),
567 pInst, &expectedOperands);
David Neto78c3b432015-08-27 13:03:52 -0400568
569 if (error == SPV_FAILED_MATCH && spvOperandIsOptional(type))
570 return SPV_SUCCESS;
571
Lei Zhang40056702015-09-11 14:31:27 -0400572 if (error) return error;
David Neto78c3b432015-08-27 13:03:52 -0400573
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400574 context->setPosition(nextPosition);
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100575 }
576 }
577
Andrew Woloszyn537e7762015-09-29 11:28:34 -0400578 if (spvOpcodeGeneratesType(pInst->opcode)) {
579 if (context->recordTypeDefinition(pInst) != SPV_SUCCESS) {
580 return SPV_ERROR_INVALID_TEXT;
581 }
582 } else if (opcodeEntry->hasType) {
583 // SPIR-V dictates that if an instruction has both a return value and a
584 // type ID then the type id is first, and the return value is second.
585 assert(opcodeEntry->hasResult &&
586 "Unknown opcode: has a type but no result.");
587 context->recordTypeIdForValue(pInst->words[2], pInst->words[1]);
588 }
589
David Netob5dc8fc2015-10-06 16:22:00 -0400590 if (pInst->words.size() > SPV_LIMIT_INSTRUCTION_WORD_COUNT_MAX) {
David Netoac508b02015-10-09 15:48:09 -0400591 return context->diagnostic()
592 << "Instruction too long: " << pInst->words.size()
593 << " words, but the limit is "
594 << SPV_LIMIT_INSTRUCTION_WORD_COUNT_MAX;
David Netob5dc8fc2015-10-06 16:22:00 -0400595 }
596
597 pInst->words[0] = spvOpcodeMake(pInst->words.size(), opcodeEntry->opcode);
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100598
599 return SPV_SUCCESS;
600}
601
David Netoc9786432015-09-01 18:05:14 -0400602namespace {
603
604// Translates a given assembly language module into binary form.
605// If a diagnostic is generated, it is not yet marked as being
606// for a text-based input.
Dejan Mircevski14c4b102015-09-29 17:07:21 -0400607spv_result_t spvTextToBinaryInternal(const libspirv::AssemblyGrammar& grammar,
608 const spv_text text,
609 spv_assembly_syntax_format_t format,
610 spv_binary* pBinary,
611 spv_diagnostic* pDiagnostic) {
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400612 if (!pDiagnostic) return SPV_ERROR_INVALID_DIAGNOSTIC;
613 libspirv::AssemblyContext context(text, pDiagnostic);
David Netoac508b02015-10-09 15:48:09 -0400614 if (!text->str || !text->length)
615 return context.diagnostic() << "Text stream is empty.";
616
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400617 if (!grammar.isValid()) {
Lei Zhang40056702015-09-11 14:31:27 -0400618 return SPV_ERROR_INVALID_TABLE;
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400619 }
Lei Zhang40056702015-09-11 14:31:27 -0400620 if (!pBinary) return SPV_ERROR_INVALID_POINTER;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100621
622 // NOTE: Ensure diagnostic is zero initialised
623 *pDiagnostic = {};
624
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100625 std::vector<spv_instruction_t> instructions;
626
David Netoac508b02015-10-09 15:48:09 -0400627 if (context.advance()) return context.diagnostic() << "Text stream is empty.";
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100628
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400629 spv_ext_inst_type_t extInstType = SPV_EXT_INST_TYPE_NONE;
630 while (context.hasText()) {
David Netob5dc8fc2015-10-06 16:22:00 -0400631 instructions.push_back({});
632 spv_instruction_t& inst = instructions.back();
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400633 inst.extInstType = extInstType;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100634
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400635 if (spvTextEncodeOpcode(grammar, &context, format, &inst)) {
636 return SPV_ERROR_INVALID_TEXT;
Lei Zhang40056702015-09-11 14:31:27 -0400637 }
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400638 extInstType = inst.extInstType;
639
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400640 if (context.advance()) break;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100641 }
642
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100643 size_t totalSize = SPV_INDEX_INSTRUCTION;
Dejan Mircevski903f9d62015-09-28 17:04:39 -0400644 for (auto& inst : instructions) {
David Netob5dc8fc2015-10-06 16:22:00 -0400645 totalSize += inst.words.size();
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100646 }
647
Dejan Mircevski903f9d62015-09-28 17:04:39 -0400648 uint32_t* data = new uint32_t[totalSize];
Lei Zhang40056702015-09-11 14:31:27 -0400649 if (!data) return SPV_ERROR_OUT_OF_MEMORY;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100650 uint64_t currentIndex = SPV_INDEX_INSTRUCTION;
Dejan Mircevski903f9d62015-09-28 17:04:39 -0400651 for (auto& inst : instructions) {
David Netob5dc8fc2015-10-06 16:22:00 -0400652 memcpy(data + currentIndex, inst.words.data(), sizeof(uint32_t) * inst.words.size());
653 currentIndex += inst.words.size();
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100654 }
655
656 spv_binary binary = new spv_binary_t();
Lei Zhang40056702015-09-11 14:31:27 -0400657 if (!binary) {
658 delete[] data;
659 return SPV_ERROR_OUT_OF_MEMORY;
660 }
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100661 binary->code = data;
662 binary->wordCount = totalSize;
663
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400664 spv_result_t error = spvBinaryHeaderSet(binary, context.getBound());
Lei Zhang40056702015-09-11 14:31:27 -0400665 if (error) {
666 spvBinaryDestroy(binary);
667 return error;
668 }
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100669
670 *pBinary = binary;
671
672 return SPV_SUCCESS;
673}
674
Lei Zhange78a7c12015-09-10 17:07:21 -0400675} // anonymous namespace
David Netoc9786432015-09-01 18:05:14 -0400676
Dejan Mircevski903f9d62015-09-28 17:04:39 -0400677spv_result_t spvTextToBinary(const char* input_text,
Andrew Woloszyncfeac482015-09-09 13:04:32 -0400678 const uint64_t input_text_size,
David Netoc9786432015-09-01 18:05:14 -0400679 const spv_opcode_table opcodeTable,
680 const spv_operand_table operandTable,
681 const spv_ext_inst_table extInstTable,
Dejan Mircevski903f9d62015-09-28 17:04:39 -0400682 spv_binary* pBinary, spv_diagnostic* pDiagnostic) {
Lei Zhang06efdc52015-09-10 14:00:00 -0400683 return spvTextWithFormatToBinary(
684 input_text, input_text_size, SPV_ASSEMBLY_SYNTAX_FORMAT_DEFAULT,
685 opcodeTable, operandTable, extInstTable, pBinary, pDiagnostic);
686}
687
688spv_result_t spvTextWithFormatToBinary(
Dejan Mircevski903f9d62015-09-28 17:04:39 -0400689 const char* input_text, const uint64_t input_text_size,
Lei Zhang06efdc52015-09-10 14:00:00 -0400690 spv_assembly_syntax_format_t format, const spv_opcode_table opcodeTable,
691 const spv_operand_table operandTable, const spv_ext_inst_table extInstTable,
Dejan Mircevski903f9d62015-09-28 17:04:39 -0400692 spv_binary* pBinary, spv_diagnostic* pDiagnostic) {
Andrew Woloszyncfeac482015-09-09 13:04:32 -0400693 spv_text_t text = {input_text, input_text_size};
694
Dejan Mircevski14c4b102015-09-29 17:07:21 -0400695 libspirv::AssemblyGrammar grammar(operandTable, opcodeTable, extInstTable);
Lei Zhang06efdc52015-09-10 14:00:00 -0400696 spv_result_t result =
Andrew Woloszyn71fc0552015-09-24 10:26:51 -0400697 spvTextToBinaryInternal(grammar, &text, format, pBinary, pDiagnostic);
David Netoc9786432015-09-01 18:05:14 -0400698 if (pDiagnostic && *pDiagnostic) (*pDiagnostic)->isTextSource = true;
699
700 return result;
701}
702
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100703void spvTextDestroy(spv_text text) {
Lei Zhang40056702015-09-11 14:31:27 -0400704 if (!text) return;
Kenneth Benzie (Benie)83e5a292015-05-22 18:26:19 +0100705 if (text->str) {
706 delete[] text->str;
707 }
708 delete text;
709}