godotengine/godot-docs
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs.git synced 2026-01-07 02:12:07 +03:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #6167 from Calinou/update-common-engine-methods

Browse Source 
Update `print_line()` and add `print_rich()` in Common engine methods and macros
This commit is contained in:
Max Hilbrunner
2022-09-12 20:03:50 +02:00
committed by GitHub
parent 59636f74f6 28cfb8a22f
commit 16e513ed62
1 changed files with 17 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
development/cpp/common_engine_methods_and_macros.rst
View File

@@ -15,10 +15,21 @@ Print text
// Prints a message to standard output.
print_line("Message");
// Non-String arguments are automatically converted to String for printing.
// If passing several arguments, they will be concatenated together with a
// space between each argument.
print_line("There are", 123, "nodes");
// Prints a message to standard output, but only when the engine
// is started with the `--verbose` command line argument.
print_verbose("Message");
// Prints a rich-formatted message using BBCode to standard output.
// This supports a subset of BBCode tags supported by RichTextLabel
// and will also appear formatted in the editor Output panel.
// On Windows, this requires Windows 10 or later to work in the terminal.
print_line_rich("[b]Bold[/b], [color=red]Red text[/color]")
// Prints a formatted error or warning message with a trace.
ERR_PRINT("Message");
WARN_PRINT("Message");
@@ -54,15 +65,16 @@ makes for more readable code.
Convert an integer or float to a string
---------------------------------------
This is mainly useful when printing numbers directly.
This is not needed when printing numbers using ``print_line()``, but you may
still need to perform manual conversion for some other use cases.
.. code-block:: cpp
// Prints "42" using integer-to-string conversion.
print_line(itos(42));
// Stores the string "42" using integer-to-string conversion.
String int_to_string = itos(42);
// Prints "123.45" using real-to-string conversion.
print_line(rtos(123.45));
// Stores the string "123.45" using real-to-string conversion.
String real_to_string = rtos(123.45);
Internationalize a string
-------------------------