Qore Programming Language  0.8.7
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
QoreFile.h
1 /* -*- mode: c++; indent-tabs-mode: nil -*- */
2 /*
3  QoreFile.h
4 
5  thread-safe File object
6 
7  Qore Programming Language
8 
9  Copyright 2003 - 2013 David Nichols
10 
11  This library is free software; you can redistribute it and/or
12  modify it under the terms of the GNU Lesser General Public
13  License as published by the Free Software Foundation; either
14  version 2.1 of the License, or (at your option) any later version.
15 
16  This library is distributed in the hope that it will be useful,
17  but WITHOUT ANY WARRANTY; without even the implied warranty of
18  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19  Lesser General Public License for more details.
20 
21  You should have received a copy of the GNU Lesser General Public
22  License along with this library; if not, write to the Free Software
23  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
24 */
25 
26 #ifndef _QORE_QOREFILE_H
27 
28 #define _QORE_QOREFILE_H
29 
30 #include <fcntl.h>
31 
32 #include <sys/file.h>
33 #include <unistd.h>
34 
35 #include <string>
36 
37 class QoreTermIOS;
38 class Queue;
39 
41 
46 class QoreFile {
47 private:
49  struct qore_qf_private *priv;
50 
51 protected:
53  DLLLOCAL QoreFile(const QoreFile&);
54 
56  DLLLOCAL QoreFile& operator=(const QoreFile&);
57 
58 public:
60  DLLEXPORT QoreFile(const QoreEncoding *cs = QCS_DEFAULT);
61 
63  DLLEXPORT ~QoreFile();
64 
66 
75  DLLEXPORT int open(const char *fn, int flags = O_RDONLY, int mode = 0777, const QoreEncoding *cs = QCS_DEFAULT);
76 
78 
88  DLLEXPORT int open2(ExceptionSink *xsink, const char *fn, int flags = O_RDONLY, int mode = 0777, const QoreEncoding *cs = QCS_DEFAULT);
89 
91 
94  DLLEXPORT int close();
95 
97  DLLEXPORT void setEncoding(const QoreEncoding *cs);
98 
100  DLLEXPORT const QoreEncoding *getEncoding() const;
101 
103  DLLEXPORT int sync();
104 
106 
113  DLLEXPORT QoreStringNode* readLine(ExceptionSink* xsink);
114 
116 
125  DLLEXPORT QoreStringNode* readLine(bool incl_eol, ExceptionSink* xsink);
126 
128 
136  DLLEXPORT int readLine(QoreString &str);
137 
139 
148  DLLEXPORT int readLine(QoreString &str, bool incl_eol);
149 
151 
161  DLLEXPORT QoreStringNode* readUntil(const char* bytes, bool incl_bytes, ExceptionSink* xsink);
162 
164 
174  DLLEXPORT int readUntil(char byte, QoreString& str, bool incl_bytes = true);
175 
177 
186  DLLEXPORT int readUntil(const char* bytes, QoreString& str, bool incl_bytes = true);
187 
189 
194  DLLEXPORT int write(const QoreString *str, ExceptionSink *xsink);
195 
197 
202  DLLEXPORT int write(const BinaryNode *b, ExceptionSink *xsink);
203 
205 
211  DLLEXPORT int write(const void *data, qore_size_t len, ExceptionSink *xsink);
212 
214 
219  DLLEXPORT int writei1(char i, ExceptionSink *xsink);
220 
222 
228  DLLEXPORT int writei2(short i, ExceptionSink *xsink);
229 
231 
237  DLLEXPORT int writei4(int i, ExceptionSink *xsink);
238 
240 
246  DLLEXPORT int writei8(int64 i, ExceptionSink *xsink);
247 
249 
255  DLLEXPORT int writei2LSB(short i, ExceptionSink *xsink);
256 
258 
264  DLLEXPORT int writei4LSB(int i, ExceptionSink *xsink);
265 
267 
273  DLLEXPORT int writei8LSB(int64 i, ExceptionSink *xsink);
274 
276 
282  DLLEXPORT int readu1(unsigned char *val, ExceptionSink *xsink);
283 
285 
293  DLLEXPORT int readu2(unsigned short *val, ExceptionSink *xsink);
294 
296 
304  DLLEXPORT int readu4(unsigned int *val, ExceptionSink *xsink);
305 
307 
315  DLLEXPORT int readu2LSB(unsigned short *val, ExceptionSink *xsink);
316 
318 
326  DLLEXPORT int readu4LSB(unsigned int *val, ExceptionSink *xsink);
327 
329 
335  DLLEXPORT int readi1(char *val, ExceptionSink *xsink);
336 
338 
346  DLLEXPORT int readi2(short *val, ExceptionSink *xsink);
347 
349 
357  DLLEXPORT int readi4(int *val, ExceptionSink *xsink);
358 
360 
366  DLLEXPORT int readi8(int64 *val, ExceptionSink *xsink);
367 
369 
377  DLLEXPORT int readi2LSB(short *val, ExceptionSink *xsink);
378 
380 
388  DLLEXPORT int readi4LSB(int *val, ExceptionSink *xsink);
389 
391 
397  DLLEXPORT int readi8LSB(int64 *val, ExceptionSink *xsink);
398 
400 
406  DLLEXPORT QoreStringNode *read(qore_offset_t size, ExceptionSink *xsink);
407 
409 
416  DLLEXPORT int read(QoreString &str, qore_offset_t size, ExceptionSink *xsink);
417 
419 
424  DLLEXPORT BinaryNode *readBinary(qore_offset_t size, ExceptionSink *xsink);
425 
427 
433  DLLEXPORT int readBinary(BinaryNode &b, qore_offset_t size, ExceptionSink *xsink);
434 
436 
443  DLLEXPORT QoreStringNode *read(qore_offset_t size, int timeout_ms, ExceptionSink *xsink);
444 
446 
452  DLLEXPORT BinaryNode *readBinary(qore_offset_t size, int timeout_ms, ExceptionSink *xsink);
453 
455 
457  DLLEXPORT qore_size_t setPos(qore_size_t pos);
458 
460 
463  DLLEXPORT qore_size_t getPos();
464 
466 
468  DLLEXPORT qore_size_t getPos() const;
469 
471 
474  DLLEXPORT QoreStringNode *getchar();
475 
477 
482  DLLEXPORT QoreStringNode *getchar(ExceptionSink *xsink);
483 
485  DLLEXPORT std::string getFileNameStr() const;
486 
488  DLLEXPORT QoreStringNode* getFileName() const;
489 
490 #if (!defined _WIN32 && !defined __WIN32__) || defined __CYGWIN__
491 
492  DLLEXPORT int chown(uid_t owner, gid_t group, ExceptionSink *xsink);
493 
495  DLLEXPORT int lockBlocking(struct flock &fl, ExceptionSink *xsink);
496 
498  DLLEXPORT int lock(const struct flock &fl, ExceptionSink *xsink);
499 
501  DLLEXPORT int getLockInfo(struct flock &fl, ExceptionSink *xsink);
502 #endif
503 
505 
509  DLLEXPORT bool isDataAvailable(int timeout_ms, ExceptionSink *xsink) const;
510 
512 
515  DLLEXPORT QoreListNode *stat(ExceptionSink *xsink) const;
516 
518 
521  DLLEXPORT QoreHashNode *hstat(ExceptionSink *xsink) const;
522 
524 
527  DLLEXPORT QoreHashNode *statvfs(ExceptionSink *xsink) const;
528 
529 #if 0
530 
531  DLLEXPORT int preallocate(fstore_t &fs, ExceptionSink *xsink);
532 #endif
533 
535  DLLEXPORT int getFD() const;
536 
538  DLLEXPORT bool isOpen() const;
539 
541  DLLEXPORT bool isTty() const;
542 
544  DLLLOCAL int setTerminalAttributes(int action, QoreTermIOS *ios, ExceptionSink *xsink) const;
545 
547  DLLLOCAL int getTerminalAttributes(QoreTermIOS *ios, ExceptionSink *xsink) const;
548 
549  // NOTE: QoreFile::makeSpecial() can only be called right after the constructor (private API)
550  DLLLOCAL void makeSpecial(int sfd);
551 
553  DLLLOCAL void setEventQueue(Queue *cbq, ExceptionSink *xsink);
554 
556  DLLLOCAL void cleanup(ExceptionSink *xsink);
557 };
558 
559 class QoreFileHelper : QorePrivateObjectAccessHelper {
560 public:
561  DLLEXPORT QoreFileHelper(QoreObject* obj, ExceptionSink* xsink);
562  DLLEXPORT ~QoreFileHelper();
563  DLLEXPORT QoreFile* operator*() const;
564  DLLEXPORT QoreFile* operator->() const;
565 };
566 
567 #endif // _QORE_QOREFILE_H