mirror of
https://github.com/Kitware/CMake.git
synced 2025-10-14 02:08:27 +08:00
fb3e7825f3
The Windows documentation [1] states:
> command-line applications should capture the initial console
> mode at startup and attempt to restore it when exiting
We set `ENABLE_VIRTUAL_TERMINAL_{INPUT,PROCESSING}` modes since
commit d6a1ff59f1 (StdIo: Provide metadata about stdin, stdout,
stderr streams, 2025-05-06). Avoid leaking them.
[1] https://learn.microsoft.com/en-us/windows/console/console-modes
Issue: #26924
106 lines
2.0 KiB
C++
106 lines
2.0 KiB
C++
/* Distributed under the OSI-approved BSD 3-Clause License. See accompanying
|
|
file LICENSE.rst or https://cmake.org/licensing for details. */
|
|
#pragma once
|
|
|
|
#include "cmConfigure.h" // IWYU pragma: keep
|
|
|
|
#include <cstdio>
|
|
#include <iosfwd>
|
|
|
|
namespace cm {
|
|
namespace StdIo {
|
|
|
|
/**
|
|
* Identify the kind of terminal to which a stream is attached, if any.
|
|
*/
|
|
enum class TermKind
|
|
{
|
|
/** Not an interactive terminal. */
|
|
None,
|
|
/** A VT100 terminal. */
|
|
VT100,
|
|
#ifdef _WIN32
|
|
/** A Windows Console that does not support VT100 sequences. */
|
|
Console,
|
|
#endif
|
|
};
|
|
|
|
/**
|
|
* Represent stdin, stdout, or stderr stream metadata.
|
|
*/
|
|
class Stream
|
|
{
|
|
public:
|
|
/** The kind of terminal to which the stream is attached, if any. */
|
|
TermKind Kind() const { return this->Kind_; }
|
|
|
|
/** The underlying C++ stream. */
|
|
std::ios& IOS() const { return this->IOS_; }
|
|
|
|
/** The underlying file descriptor. */
|
|
int FD() const { return this->FD_; }
|
|
|
|
#ifdef _WIN32
|
|
/** The underlying HANDLE of an attached Windows Console, if any. */
|
|
void* Console() const { return this->Console_; }
|
|
#endif
|
|
|
|
protected:
|
|
enum class Direction
|
|
{
|
|
In,
|
|
Out,
|
|
};
|
|
|
|
Stream(std::ios& s, FILE* file, Direction direction);
|
|
~Stream(); // NOLINT(performance-trivially-destructible)
|
|
|
|
private:
|
|
std::ios& IOS_;
|
|
int FD_ = -1;
|
|
TermKind Kind_ = TermKind::None;
|
|
|
|
#ifdef _WIN32
|
|
void* Console_ = nullptr;
|
|
unsigned long ConsoleOrigMode_ = 0;
|
|
#endif
|
|
};
|
|
|
|
/**
|
|
* Represent stdin metadata.
|
|
*/
|
|
class IStream : public Stream
|
|
{
|
|
friend class Globals;
|
|
IStream(std::istream& is, FILE* file);
|
|
|
|
public:
|
|
/** The underlying C++ stream. */
|
|
std::istream& IOS() const;
|
|
};
|
|
|
|
/**
|
|
* Represent stdout or stderr metadata.
|
|
*/
|
|
class OStream : public Stream
|
|
{
|
|
friend class Globals;
|
|
OStream(std::ostream& os, FILE* file);
|
|
|
|
public:
|
|
/** The underlying C++ stream. */
|
|
std::ostream& IOS() const;
|
|
};
|
|
|
|
/** Metadata for stdin. */
|
|
IStream& In();
|
|
|
|
/** Metadata for stdout. */
|
|
OStream& Out();
|
|
|
|
/** Metadata for stderr. */
|
|
OStream& Err();
|
|
|
|
}
|
|
}
|