mirrors/reactos
0
0
Fork 0
mirror of https://github.com/reactos/reactos.git synced 2024-11-27 13:33:32 +08:00
Code Issues Packages Projects Releases Wiki Activity
hbelusca/gui_setup
reactos/sdk/lib/conutils/conutils.h

45 lines
1.3 KiB
C
Raw Permalink Normal View History

[CONUTILS]: Create a C library for console output/input functions, last-error messages display, etc. to be used for all of our internal command-line utilities. Useless user32.dll dependencies are removed thanks to this lib. Currently only output functions are supported. CORE-10504 [EVENTCREATE]: Adapt EventCreate to use ConUtils library, as an example of how to use this library. svn path=/trunk/; revision=72913
2016-10-06 01:40:22 +08:00
/*
[CONUTILS] Split stream.c into input and output stream modules. As code grows, this will allow for better maintenance of the console stream code. In particular the input stream module will contain special code for handling TTYs, and this is something not all console programs will need. Having this code in a separate module will allow for the linker to possibly remove this code when it is unused.
2017-10-17 05:58:23 +08:00
* PROJECT: ReactOS Console Utilities Library
* LICENSE: GPL-2.0+ (https://spdx.org/licenses/GPL-2.0+)
* PURPOSE: Provides simple abstraction wrappers around CRT streams or
* Win32 console API I/O functions, to deal with i18n + Unicode
* related problems.
* COPYRIGHT: Copyright 2017-2018 ReactOS Team
* Copyright 2017-2018 Hermes Belusca-Maito
[CONUTILS]: Create a C library for console output/input functions, last-error messages display, etc. to be used for all of our internal command-line utilities. Useless user32.dll dependencies are removed thanks to this lib. Currently only output functions are supported. CORE-10504 [EVENTCREATE]: Adapt EventCreate to use ConUtils library, as an example of how to use this library. svn path=/trunk/; revision=72913
2016-10-06 01:40:22 +08:00
*/
[CONUTILS] Diverse improvements: start doxygenating and add some resource messsage helper functions. - Start to doxygenate the library, focusing in great details on the functions of the "outstream" module. - Add a K32LoadStringEx function that expands (K32)LoadString by allowing a LanguageId parameter to be able to load strings from other languages than the current one. - Add "ConResMsg*" helper functions to be able to (format and) print message strings with inserts that come *NOT* from a message table (as usual) *BUT* from resource string tables. Will be helpful for CORE-14265 in particular. [CMD] Fix the call to ConMsgPrintfV().
2018-02-02 07:35:08 +08:00
/**
* @file conutils.h
* @ingroup ConUtils
*
* @defgroup ConUtils ReactOS Console Utilities Library
*
* @brief This library contains common functions used in many places inside
* the ReactOS console utilities and the ReactOS Command-Line Interpreter.
* Most of these functions are related with internationalisation and
* the problem of correctly displaying Unicode text on the console.
* Besides those, helpful functions for retrieving strings and messages
* from application resources are provided, together with printf-like
* functionality.
**/
[CONUTILS]: Create a C library for console output/input functions, last-error messages display, etc. to be used for all of our internal command-line utilities. Useless user32.dll dependencies are removed thanks to this lib. Currently only output functions are supported. CORE-10504 [EVENTCREATE]: Adapt EventCreate to use ConUtils library, as an example of how to use this library. svn path=/trunk/; revision=72913
2016-10-06 01:40:22 +08:00
#ifndef __CONUTILS_H__
#define __CONUTILS_H__
[CONUTILS] Split stream.c into input and output stream modules. As code grows, this will allow for better maintenance of the console stream code. In particular the input stream module will contain special code for handling TTYs, and this is something not all console programs will need. Having this code in a separate module will allow for the linker to possibly remove this code when it is unused.
2017-10-17 05:58:23 +08:00
#pragma once
[CONUTILS]: Create a C library for console output/input functions, last-error messages display, etc. to be used for all of our internal command-line utilities. Useless user32.dll dependencies are removed thanks to this lib. Currently only output functions are supported. CORE-10504 [EVENTCREATE]: Adapt EventCreate to use ConUtils library, as an example of how to use this library. svn path=/trunk/; revision=72913
2016-10-06 01:40:22 +08:00
#ifndef _UNICODE
#error The ConUtils library only supports compilation with _UNICODE defined, at the moment!
#endif
[CONUTILS] - Introduce new functionalities related to console streams, a console screen management api (almost stubbed), a console pager api (adapted from code from CMD). This new functionality will be used in the future. See CORE-10504 for more details. - As this library is therefore growing up, split it in small parts (sublibraries) that can be used, with the following dependency scheme: base utils (standalone); streams depending on base; screen depending on streams; pager depending on screen. [APPS]: As a result, modify the CMakeLists of the different apps that use conutils to make them depend on the correct sublibrary. svn path=/trunk/; revision=73024
2016-10-23 05:54:29 +08:00
#include "utils.h"
#include "stream.h"
[CONUTILS] Split stream.c into input and output stream modules. As code grows, this will allow for better maintenance of the console stream code. In particular the input stream module will contain special code for handling TTYs, and this is something not all console programs will need. Having this code in a separate module will allow for the linker to possibly remove this code when it is unused.
2017-10-17 05:58:23 +08:00
// #include "instream.h"
#include "outstream.h"
[CONUTILS] - Introduce new functionalities related to console streams, a console screen management api (almost stubbed), a console pager api (adapted from code from CMD). This new functionality will be used in the future. See CORE-10504 for more details. - As this library is therefore growing up, split it in small parts (sublibraries) that can be used, with the following dependency scheme: base utils (standalone); streams depending on base; screen depending on streams; pager depending on screen. [APPS]: As a result, modify the CMakeLists of the different apps that use conutils to make them depend on the correct sublibrary. svn path=/trunk/; revision=73024
2016-10-23 05:54:29 +08:00
#include "screen.h"
#include "pager.h"
[CONUTILS]: Create a C library for console output/input functions, last-error messages display, etc. to be used for all of our internal command-line utilities. Useless user32.dll dependencies are removed thanks to this lib. Currently only output functions are supported. CORE-10504 [EVENTCREATE]: Adapt EventCreate to use ConUtils library, as an example of how to use this library. svn path=/trunk/; revision=72913
2016-10-06 01:40:22 +08:00
#endif /* __CONUTILS_H__ */
[CONUTILS] Split stream.c into input and output stream modules. As code grows, this will allow for better maintenance of the console stream code. In particular the input stream module will contain special code for handling TTYs, and this is something not all console programs will need. Having this code in a separate module will allow for the linker to possibly remove this code when it is unused.
2017-10-17 05:58:23 +08:00
/* EOF */
Reference in New Issue Copy Permalink