Add beast_basics module

modules/beast_basics/diagnostic/beast_Debug.cpp

@@ -0,0 +1,268 @@
+/*============================================================================*/
+/*
+  VFLib: https://github.com/vinniefalco/VFLib
+
+  Copyright (C) 2008 by Vinnie Falco <vinnie.falco@gmail.com>
+
+  This library contains portions of other open source products covered by
+  separate licenses. Please see the corresponding source files for specific
+  terms.
+
+  VFLib is provided under the terms of The MIT License (MIT):
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in
+  all copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+  FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+  IN THE SOFTWARE.
+*/
+/*============================================================================*/
+
+namespace Debug
+{
+
+//------------------------------------------------------------------------------
+
+bool isDebuggerAttached ()
+{
+    return beast_isRunningUnderDebugger ();
+}
+
+//------------------------------------------------------------------------------
+
+#if BEAST_DEBUG && defined (beast_breakDebugger)
+void breakPoint ()
+{
+    if (isDebuggerAttached ())
+        beast_breakDebugger;
+}
+
+#else
+void breakPoint ()
+{
+    bassertfalse
+}
+
+#endif
+
+//----------------------------------------------------------------------------
+
+#if BEAST_MSVC && defined (_DEBUG)
+
+void setHeapAlwaysCheck (bool bAlwaysCheck)
+{
+    int flags = _CrtSetDbgFlag (_CRTDBG_REPORT_FLAG);
+
+    if (bAlwaysCheck) flags |= _CRTDBG_CHECK_ALWAYS_DF; // on
+    else flags &= ~_CRTDBG_CHECK_ALWAYS_DF; // off
+
+    _CrtSetDbgFlag (flags);
+}
+
+void setHeapDelayedFree (bool bDelayedFree)
+{
+    int flags = _CrtSetDbgFlag (_CRTDBG_REPORT_FLAG);
+
+    if (bDelayedFree) flags |= _CRTDBG_DELAY_FREE_MEM_DF; // on
+    else flags &= ~_CRTDBG_DELAY_FREE_MEM_DF; // off
+
+    _CrtSetDbgFlag (flags);
+}
+
+void setHeapReportLeaks (bool bReportLeaks)
+{
+    int flags = _CrtSetDbgFlag (_CRTDBG_REPORT_FLAG);
+
+    if (bReportLeaks) flags |= _CRTDBG_LEAK_CHECK_DF; // on
+    else flags &= ~_CRTDBG_LEAK_CHECK_DF; // off
+
+    _CrtSetDbgFlag (flags);
+}
+
+void checkHeap ()
+{
+    _CrtCheckMemory ();
+}
+
+#else
+
+void setHeapAlwaysCheck (bool)
+{
+}
+
+void setHeapDelayedFree (bool)
+{
+}
+
+void setHeapReportLeaks (bool)
+{
+}
+
+void checkHeap ()
+{
+}
+
+#endif
+
+//------------------------------------------------------------------------------
+
+const String getFileNameFromPath (const char* sourceFileName)
+{
+    return File::createFileWithoutCheckingPath (sourceFileName).getFileName ();
+}
+
+// Returns a String with double quotes escaped
+static const String withEscapedQuotes (String const& string)
+{
+    String escaped;
+
+    int i0 = 0;
+    int i;
+
+    do
+    {
+        i = string.indexOfChar (i0, '"');
+
+        if (i == -1)
+        {
+            escaped << string.substring (i0, string.length ());
+        }
+        else
+        {
+            escaped << string.substring (i0, i) << "\\\"";
+            i0 = i + 1;
+        }
+    }
+    while (i != -1);
+
+    return escaped;
+}
+
+// Converts escaped quotes back into regular quotes
+static const String withUnescapedQuotes (String const& string)
+{
+    String unescaped;
+
+    int i0 = 0;
+    int i;
+
+    do
+    {
+        i = string.indexOfChar (i0, '\\');
+
+        if (i == -1)
+        {
+            unescaped << string.substring (i0, string.length ());
+        }
+        else
+        {
+            // peek
+            if (string.length () > i && string[i + 1] == '\"')
+            {
+                unescaped << string.substring (i0, i) << '"';
+                i0 = i + 2;
+            }
+            else
+            {
+                unescaped << string.substring (i0, i + 1);
+                i0 = i + 1;
+            }
+        }
+    }
+    while (i != -1);
+
+    return unescaped;
+}
+
+// Converts a String that may contain newlines, into a
+// command line where each line is delimited with quotes.
+// Any quotes in the actual string will be escaped via \".
+String stringToCommandLine (String const& string)
+{
+    String commandLine;
+
+    int i0 = 0;
+    int i;
+
+    for (i = 0; i < string.length (); i++)
+    {
+        beast_wchar c = string[i];
+
+        if (c == '\n')
+        {
+            if (i0 != 0)
+                commandLine << ' ';
+
+            commandLine << '"' << withEscapedQuotes (string.substring (i0, i)) << '"';
+            i0 = i + 1;
+        }
+    }
+
+    if (i0 < i)
+    {
+        if (i0 != 0)
+            commandLine << ' ';
+
+        commandLine << '"' << withEscapedQuotes (string.substring (i0, i)) << '"';
+    }
+
+    return commandLine;
+}
+
+// Converts a command line consisting of multiple quoted strings
+// back into a single string with newlines delimiting each quoted
+// string. Escaped quotes \" are turned into real quotes.
+String commandLineToString (const String& commandLine)
+{
+    String string;
+
+    bool quoting = false;
+    int i0 = 0;
+    int i;
+
+    for (i = 0; i < commandLine.length (); i++)
+    {
+        beast_wchar c = commandLine[i];
+
+        if (c == '\\')
+        {
+            // peek
+            if (commandLine.length () > i && commandLine[i + 1] == '\"')
+            {
+                i++;
+            }
+        }
+        else if (c == '"')
+        {
+            if (!quoting)
+            {
+                i0 = i + 1;
+                quoting = true;
+            }
+            else
+            {
+                if (!string.isEmpty ())
+                    string << '\n';
+
+                string << withUnescapedQuotes (commandLine.substring (i0, i));
+                quoting = false;
+            }
+        }
+    }
+
+    return string;
+}
+
+}