Introduce css.reflection.Dump singleton

...and revert e1c6f36d8bcc0799281e3a7e244175f682d97cb2 "Add a to_string()
function to the code generated for UNO IDL constant groups".  (But keep the
constants groups the latter had added to cppu/qa/cppumaker/types.idl, and use
them in the newly added CppunitTest_stoc_dump, for better or worse.)

Change-Id: I56e9eaeb1e45b83a72a25eceef13e719dc6f3a1e
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/149281
Reviewed-by: Tor Lillqvist <tml@collabora.com>
Tested-by: Jenkins

3 files changed, 82 insertions, 0 deletions

diff --git a/udkapi/UnoApi_udkapi.mk b/udkapi/UnoApi_udkapi.mk
index 03a3accd2c6c..f18b9f758ddc 100644
--- a/udkapi/UnoApi_udkapi.mk
+++ b/udkapi/UnoApi_udkapi.mk
@@ -104,6 +104,7 @@ $(eval $(call gb_UnoApi_add_idlfiles_nohdl,udkapi,com/sun/star/java,\
 ))
 $(eval $(call gb_UnoApi_add_idlfiles_nohdl,udkapi,com/sun/star/reflection,\
 	theCoreReflection \
+	Dump \
 	ProxyFactory \
 ))
 $(eval $(call gb_UnoApi_add_idlfiles_nohdl,udkapi,com/sun/star/registry,\
@@ -378,6 +379,7 @@ $(eval $(call gb_UnoApi_add_idlfiles,udkapi,com/sun/star/reflection,\
 	XCompoundTypeDescription \
 	XConstantTypeDescription \
 	XConstantsTypeDescription \
+	XDump \
 	XEnumTypeDescription \
 	XIdlArray \
 	XIdlClass \
diff --git a/udkapi/com/sun/star/reflection/Dump.idl b/udkapi/com/sun/star/reflection/Dump.idl
new file mode 100644
index 000000000000..849a788a773e
--- /dev/null
+++ b/udkapi/com/sun/star/reflection/Dump.idl
@@ -0,0 +1,22 @@
+/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4; fill-column: 100 -*- */
+/*
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ */
+
+module com {  module sun {  module star {  module reflection {
+
+/** Dump any UNOIDL value as a string.
+
+    Mainly useful for logging and debugging purposes.
+
+    @since LibreOffice 7.6
+*/
+singleton Dump: XDump;
+
+}; }; }; };
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab cinoptions=b1,g0,N-s cinkeys+=0=break: */
diff --git a/udkapi/com/sun/star/reflection/XDump.idl b/udkapi/com/sun/star/reflection/XDump.idl
new file mode 100644
index 000000000000..fac2a48eafc5
--- /dev/null
+++ b/udkapi/com/sun/star/reflection/XDump.idl
@@ -0,0 +1,58 @@
+/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4; fill-column: 100 -*- */
+/*
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ */
+
+module com {  module sun {  module star {  module reflection {
+
+/** Dump any UNOIDL value as a string.
+
+    Mainly useful for logging and debugging purposes.
+
+    @since LibreOffice 7.6
+*/
+interface XDump {
+    /** Dump a UNOIDL value as a string.
+
+        This just dumps the value itself, without any further decoration.
+
+        @param value  any UNOIDL value
+
+        @returns a string representation of the given value
+     */
+    string dumpValue([in] any value);
+
+    /** Dump the value of a UNOIDL ANY as a string.
+
+        This dumps the type and value of the given ANY.
+
+        @param value  any UNOIDL ANY
+
+        @returns a string representation of the given ANY
+     */
+    string dumpAny([in] any value);
+
+    /** Dump a numeric UNOIDL value, interpreted relative to a UNOIDL constants group, as a string.
+
+        @param constantsGroup  the name (in dotted notation, as supported by
+        /singletons/theTypeDescriptionManager) of a UNOIDL constants group
+
+        @param value  a UNOIDL value of type BOOLEAN, BYTE, SHORT, UNSIGNED SHORT, LONG, UNSIGNED
+        LONG, HYPER, UNSIGNED HYPER, FLOAT, or DOUBLE
+
+        @returns a string representation of the given numeric value
+
+        @throws com::sun::star::lang::IllegalArgumentException  if the constantsGroup argument does
+        not represent a UNOIDL constants group or the value argument is of wrong type
+     */
+    string dumpConstant([in] string constantsGroup, [in] any value)
+        raises (com::sun::star::lang::IllegalArgumentException);
+};
+
+}; }; }; };
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab cinoptions=b1,g0,N-s cinkeys+=0=break: */