Stream.h

00001 /* mbed Microcontroller Library
00002  * Copyright (c) 2006-2013 ARM Limited
00003  *
00004  * Licensed under the Apache License, Version 2.0 (the "License");
00005  * you may not use this file except in compliance with the License.
00006  * You may obtain a copy of the License at
00007  *
00008  *     http://www.apache.org/licenses/LICENSE-2.0
00009  *
00010  * Unless required by applicable law or agreed to in writing, software
00011  * distributed under the License is distributed on an "AS IS" BASIS,
00012  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
00013  * See the License for the specific language governing permissions and
00014  * limitations under the License.
00015  */
00016 #ifndef MBED_STREAM_H
00017 #define MBED_STREAM_H
00018 
00019 #include "platform/platform.h"
00020 #include "platform/FileLike.h"
00021 #include "platform/FileHandle.h"
00022 #include "platform/NonCopyable.h"
00023 #include <cstdio>
00024 #include <cstdarg>
00025 
00026 namespace mbed {
00027 /** \addtogroup platform */
00028 /** @{*/
00029 /**
00030  * \defgroup platform_Stream Stream class
00031  * @{
00032  */
00033 
00034 extern void mbed_set_unbuffered_stream(std::FILE *_file);
00035 extern int mbed_getc(std::FILE *_file);
00036 extern char* mbed_gets(char *s, int size, std::FILE *_file);
00037 
00038 /** File stream
00039  *
00040  * @note Synchronization level: Set by subclass
00041  */
00042 class Stream : public FileLike, private NonCopyable<Stream> {
00043 
00044 public:
00045     Stream(const char *name=NULL);
00046     virtual ~Stream();
00047 
00048     int putc(int c);
00049     int puts(const char *s);
00050     int getc();
00051     char *gets(char *s, int size);
00052     int printf(const char* format, ...);
00053     int scanf(const char* format, ...);
00054     int vprintf(const char* format, std::va_list args);
00055     int vscanf(const char* format, std::va_list args);
00056 
00057     operator std::FILE*() {return _file;}
00058 
00059 protected:
00060     virtual int close();
00061     virtual ssize_t write(const void* buffer, size_t length);
00062     virtual ssize_t read(void* buffer, size_t length);
00063     virtual off_t seek(off_t offset, int whence);
00064     virtual off_t tell();
00065     virtual void rewind();
00066     virtual int isatty();
00067     virtual int sync();
00068     virtual off_t size();
00069 
00070     virtual int _putc(int c) = 0;
00071     virtual int _getc() = 0;
00072 
00073     std::FILE *_file;
00074 
00075     /** Acquire exclusive access to this object.
00076      */
00077     virtual void lock() {
00078         // Stub
00079     }
00080 
00081     /** Release exclusive access to this object.
00082      */
00083     virtual void unlock() {
00084         // Stub
00085     }
00086 };
00087 /**@}*/
00088 
00089 /**@}*/
00090 } // namespace mbed
00091 
00092 #endif
00093