/usr/include/GNUstep/NGStreams/NGStream.h is in libsope-dev 2.2.17-1build2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 | /*
Copyright (C) 2000-2005 SKYRIX Software AG
This file is part of SOPE.
SOPE is free software; you can redistribute it and/or modify it under
the terms of the GNU Lesser General Public License as published by the
Free Software Foundation; either version 2, or (at your option) any
later version.
SOPE is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
License for more details.
You should have received a copy of the GNU Lesser General Public
License along with SOPE; see the file COPYING. If not, write to the
Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA
02111-1307, USA.
*/
#ifndef __NGStreams_NGStream_H__
#define __NGStreams_NGStream_H__
#import <Foundation/NSObject.h>
#include <NGStreams/NGStreamsDecls.h>
#include <NGStreams/NGStreamProtocols.h>
@class NSData, NSException;
static inline BOOL NGCanReadInStreamMode(NGStreamMode _mode) {
return ((_mode == NGStreamMode_readOnly) ||
(_mode == NGStreamMode_readWrite));
}
static inline BOOL NGCanWriteInStreamMode(NGStreamMode _mode) {
return ((_mode == NGStreamMode_writeOnly) ||
(_mode == NGStreamMode_readWrite));
}
@interface NGStream : NSObject < NGStream, NGByteSequenceStream >
// ******************** primitives ********************
// Never returns 0. If an EOF like condition occures, NGEndOfStreamException
// is thrown.
- (unsigned)readBytes:(void *)_buf count:(unsigned)_len; // abstract
- (unsigned)writeBytes:(const void *)_buf count:(unsigned)_len; // abstract
- (void)setLastException:(NSException *)_exception;
- (BOOL)flush; // empty
- (BOOL)close; // empty
- (NGStreamMode)mode; // abstract
- (BOOL)isRootStream; // abstract
/* methods which read/write exactly _len bytes */
// TODO: should return exception? (would change the API significantly)
- (BOOL)safeReadBytes:(void *)_buf count:(unsigned)_len;
- (BOOL)safeWriteBytes:(const void *)_buf count:(unsigned)_len;
/* marking */
- (BOOL)mark; // does nothing
- (BOOL)rewind; // does nothing
- (BOOL)markSupported; // returns NO
/* convenience methods */
- (int)readByte; // java semantics (-1 returned on EOF)
// description
- (NSString *)modeDescription;
@end
@interface NGStream(DataMethods)
- (NSData *)readDataOfLength:(unsigned int)_length;
- (NSData *)safeReadDataOfLength:(unsigned int)_length;
- (unsigned int)writeData:(NSData *)_data;
- (BOOL)safeWriteData:(NSData *)_data;
@end
// concrete implementations as functions (to be used in non-subclasses)
NGStreams_EXPORT int NGReadByteFromStream(id<NGInputStream> _stream);
NGStreams_EXPORT BOOL
NGSafeReadBytesFromStream(id<NGInputStream> _in, void *_buf, unsigned _len);
NGStreams_EXPORT BOOL
NGSafeWriteBytesToStream(id<NGOutputStream> _out,const void *_buf,unsigned _len);
#endif /* __NGStreams_NGStream_H__ */
|