Changeset 108014 in vbox for trunk/include/iprt/script.h

Timestamp:

Feb 1, 2025 7:20:09 PM (3 weeks ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

167286

Message:

Runtime/common/script/scriptlex.cpp: Fix C string literal scanning and add some helper APIs to create tokens for errors and identifiers, bugref:10733

File:

• trunk/include/iprt/script.h (modified) (1 diff)

trunk/include/iprt/script.h

@@ -602 +602 @@
 RTDECL(int) RTScriptLexScanStringLiteralPascal(RTSCRIPTLEX hScriptLex, char ch, PRTSCRIPTLEXTOKEN pTok, void *pvUser);
 
+
+/**
+ * Produces an error token with the given message, used for custom lexer rule implementations.
+ *
+ * @returns IPRT status code.
+ * @param   hScriptLex             The lexer handle.
+ * @param   pTok                   The token to fill.
+ * @param   rc                     The status code to use in the message.
+ * @param   pszMsg                 The format string for the error message.
+ * @param   ...                    Arguments to the format string.
+ */
+RTDECL(int) RTScriptLexProduceTokError(RTSCRIPTLEX hScriptLex, PRTSCRIPTLEXTOKEN pTok, int rc, const char *pszMsg, ...);
+
+
+/**
+ * Produces an identifier token with the given identifier, used for custom lexer rule implementations.
+ *
+ * @returns IPRT status code.
+ * @param   hScriptLex             The lexer handle.
+ * @param   pTok                   The token to fill.
+ * @param   pszIde                 The identifier to add.
+ * @param   cchIde                 Number of characters in the identifier.
+ */
+RTDECL(int) RTScriptLexProduceTokIde(RTSCRIPTLEX hScriptLex, PRTSCRIPTLEXTOKEN pTok, const char *pszIde, size_t cchIde);
 /** @} */