xtd.console - Reference Guide  0.0.1
Modern c++17 library to manage terminal on Windows, macOS and Linux.
xtd.console - Reference Guide Documentation

Features

  • Console I/O charecters and wide charercters Streams.
  • Full utf-8 support.
  • Writes the text representation of the specified list of arguments to the standard output stream using the specified format information.
  • Get or set the size of the console window.
  • Get or set the position of the console window relative to the screen buffer.
  • Get or set the size of the screen buffer.
  • Get or set the position of the cursor.
  • Get or set the size of the cursor.
  • Play the sound of a beep through the console speaker.
  • Get or set the foreground and background colors.
  • Intercept and send callback to the user when the Control modifier key (Ctrl) and either the C console key (C) or the Break key are pressed simultaneously (Ctrl+C or Ctrl+Break).
  • ...

For more information see Documentation.md file.

Examples

The following examples "Hello, world!" show how to change the color of the text in three different ways.

Using xtd::console::WriteLine

hello_world_console.cpp:

#include <console/console>
using namespace xtd;
// The main entry point for the application.
int main() {
console::write_line("Hello, World!");
console::reset_color();
}

Using xtd::console::out character ostream

hello_world_console_out.cpp:

#include <console/console>
using namespace std;
using namespace xtd;
// The main entry point for the application.
int main() {
console::out << foreground_color(console_color::blue) << "Hello, World!" << reset_color() << endl;
}

Using std::cout character ostream

hello_world_cout.cpp:

#include <console/console>
using namespace std;
using namespace xtd;
// The main entry point for the application.
int main() {
cout << foreground_color(console_color::blue) << "Hello, World!" << reset_color() << endl;
}

For more examples see Examples.

Download and install

Before running examples you must download and install xtd.console. To download and install it read Downloads.md file.