ObjFW
OFStdIOStream.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2008-2025 Jonathan Schleifer <js@nil.im>
3  *
4  * All rights reserved.
5  *
6  * This program is free software: you can redistribute it and/or modify it
7  * under the terms of the GNU Lesser General Public License version 3.0 only,
8  * as published by the Free Software Foundation.
9  *
10  * This program is distributed in the hope that it will be useful, but WITHOUT
11  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12  * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
13  * version 3.0 for more details.
14  *
15  * You should have received a copy of the GNU Lesser General Public License
16  * version 3.0 along with this program. If not, see
17  * <https://www.gnu.org/licenses/>.
18  */
19 
20 #import "OFStream.h"
21 #import "OFKernelEventObserver.h"
22 
23 #ifdef OF_AMIGAOS
24 # include <dos/dos.h>
25 #endif
26 
27 OF_ASSUME_NONNULL_BEGIN
28 
31 @class OFColor;
32 
42 #if !defined(OF_WINDOWS) && !defined(OF_AMIGAOS) && !defined(OF_WII_U)
44 #endif
45 {
46 #if defined(OF_AMIGAOS)
47  BPTR _handle;
48  bool _closable;
49 #elif !defined(OF_WII_U)
50  int _fd;
51 #endif
52  bool _atEndOfStream;
53  OF_RESERVE_IVARS(OFStdIOStream, 4)
54 }
55 
59 @property (readonly, nonatomic) bool hasTerminal;
60 
65 @property (readonly, nonatomic) int columns;
66 
71 @property (readonly, nonatomic) int rows;
72 
73 #if defined(OF_WII) || defined(OF_NINTENDO_DS) || defined(OF_NINTENDO_3DS) || \
74  defined(DOXYGEN)
75 
81 + (void)setUpConsole;
82 #endif
83 
84 - (instancetype)init OF_UNAVAILABLE;
85 
92 - (void)setForegroundColor: (OFColor *)color;
93 
100 - (void)setBackgroundColor: (OFColor *)color;
101 
106 - (void)reset;
107 
112 - (void)clear;
113 
118 - (void)eraseLine;
119 
126 - (void)setCursorColumn: (unsigned int)column;
127 
134 - (void)setCursorPosition: (OFPoint)position;
135 
142 - (void)setRelativeCursorPosition: (OFPoint)position;
143 @end
144 
145 #ifdef __cplusplus
146 extern "C" {
147 #endif
148 
153 extern OFStdIOStream *_Nullable OFStdIn;
154 
158 extern OFStdIOStream *_Nullable OFStdOut;
159 
163 extern OFStdIOStream *_Nullable OFStdErr;
164 
172 extern void OFLog(OFConstantString *format, ...);
173 
182 extern void OFLogV(OFConstantString *format, va_list arguments);
183 #ifdef __cplusplus
184 }
185 #endif
186 
187 OF_ASSUME_NONNULL_END
void OFLogV(OFConstantString *format, va_list arguments)
Logs the specified printf-style format to OFStdErr.
Definition: OFStdIOStream.m:123
This protocol is implemented by classes which can be observed for readiness for reading by OFKernelEv...
A class for storing a color.
Definition: OFColor.h:29
A class for storing constant strings using the @"" literal.
Definition: OFConstantString.h:41
OFStdIOStream * OFStdIn
The standard input as an OFStream.
Definition: OFStdIOStream.m:99
OFStdIOStream * OFStdOut
The standard output as an OFStream.
Definition: OFStdIOStream.m:100
A base class for different types of streams.
Definition: OFStream.h:278
OFStdIOStream * OFStdErr
The standard error as an OFStream.
Definition: OFStdIOStream.m:101
A class for providing standard input, output and error as OFStream.
Definition: OFStdIOStream.h:41
This protocol is implemented by classes which can be observed for readiness for writing by OFKernelEv...
void OFLog(OFConstantString *format,...)
Logs the specified printf-style format to OFStdErr.
Definition: OFStdIOStream.m:113
A point in 2D space.
Definition: OFObject.h:161