Changeset 105760 in vbox

Timestamp:

Aug 21, 2024 12:15:14 PM (3 months ago)

Author:

vboxsync

Message:

Runtime/script: Add a simple lexer API to turn a stream of characters into tokens for a defined configuration, bugref:10394 [scm]

Location:

trunk

Files:

• include/iprt/script.h (modified) (1 diff)
• src/VBox/Runtime/common/script/scriptlex.cpp (modified) (5 diffs)

trunk/include/iprt/script.h

@@ -368 +368 @@
  * @param   pCfg                   The lexer config to use for identifying the different tokens.
  */
-RTDECL(int) RTScriptLexCreateFromReader(PRTSCRIPTLEX phScriptLex, PFNRTSCRIPTLEXRDR pfnReader, 
+RTDECL(int) RTScriptLexCreateFromReader(PRTSCRIPTLEX phScriptLex, PFNRTSCRIPTLEXRDR pfnReader,
                                         PFNRTSCRIPTLEXDTOR pfnDtor, void *pvUser,
                                         size_t cchBuf, PRTSTRCACHE phStrCacheId, PRTSTRCACHE phStrCacheStringLit,

trunk/src/VBox/Runtime/common/script/scriptlex.cpp

@@ -5 +5 @@
 
 /*
- * Copyright (C) 2017 Oracle Corporation
- *
- * This file is part of VirtualBox Open Source Edition (OSE), as
- * available from http://www.virtualbox.org. This file is free software;
- * you can redistribute it and/or modify it under the terms of the GNU
- * General Public License (GPL) as published by the Free Software
- * Foundation, in version 2 as it comes in the "COPYING" file of the
- * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
- * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ * Copyright (C) 2022-2023 Oracle and/or its affiliates.
+ *
+ * This file is part of VirtualBox base platform packages, as
+ * available from https://www.virtualbox.org.
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation, in version 3 of the
+ * License.
+ *
+ * This program is distributed in the hope that it will be useful, but
+ * WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, see <https://www.gnu.org/licenses>.
  *
  * The contents of this file may alternatively be used under the terms
  * of the Common Development and Distribution License Version 1.0
- * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
- * VirtualBox OSE distribution, in which case the provisions of the
+ * (CDDL), a copy of it is provided in the "COPYING.CDDL" file included
+ * in the VirtualBox distribution, in which case the provisions of the
  * CDDL are applicable instead of those of the GPL.
  *
  * You may elect to license modified versions of this file under the
  * terms and conditions of either the GPL or the CDDL or both.
+ *
+ * SPDX-License-Identifier: GPL-3.0-only OR CDDL-1.0
  */
 
@@ -29 +39 @@
 *   Header Files                                                                                                                 *
 *********************************************************************************************************************************/
-#define LOG_GROUP RTLOGGROUP_DEFAULT // @todo
+#define LOG_GROUP RTLOGGROUP_DEFAULT /// @todo
 #include <iprt/script.h>
 
@@ -155 +165 @@
  * @param   psz                    The string to match against.
  * @param   pszExclude             When the string matched but the input continues
- *                                 with one of the characters in this string the
- *                                 match will not 
+ *                                 with one of the characters in this string there will
+ *                                 be no match.
  */
 DECLINLINE(bool) rtScriptLexMatchStrConsume(PRTSCRIPTLEXINT pThis, char ch, const char *psz,
@@ -300 +310 @@
                 continue;
 
-            /** @todo: Not quite correct when there is an end of stream before the closing lexeme.
+            /** @todo Not quite correct when there is an end of stream before the closing lexeme.
              * But doesn't hurt at the moment. */
             if (   chTmp == '\0'
@@ -576 +586 @@
     if (RT_LIKELY(pThis))
     {
-        pThis->u32Magic     = 0xfefecafe; /**@todo */
+        pThis->u32Magic     = 0xfefecafe; /** @todo */
         pThis->Pos.iLine    = 1;
         pThis->Pos.iCh      = 1;