Fixed preview navigation as per ancient bug report

[wxWidgets.git] / include / wx / txtstrm.h

diff --git a/include/wx/txtstrm.h b/include/wx/txtstrm.h
index 145257697eba1e24642a3c9b31123d27befc6d42..2e880a8ac2d60c9fb1fbcf6e0b5f2fde20c0da4f 100644 (file)
--- a/include/wx/txtstrm.h
+++ b/include/wx/txtstrm.h
@@ -20,16 +20,23 @@
 
 #if wxUSE_STREAMS
 
 
 #if wxUSE_STREAMS
 

-class WXDLLEXPORT wxTextInputStream;
-class WXDLLEXPORT wxTextOutputStream;
+class WXDLLIMPEXP_BASE wxTextInputStream;
+class WXDLLIMPEXP_BASE wxTextOutputStream;

 
 typedef wxTextInputStream& (*__wxTextInputManip)(wxTextInputStream&);
 typedef wxTextOutputStream& (*__wxTextOutputManip)(wxTextOutputStream&);
 
 
 typedef wxTextInputStream& (*__wxTextInputManip)(wxTextInputStream&);
 typedef wxTextOutputStream& (*__wxTextOutputManip)(wxTextOutputStream&);
 

-WXDLLEXPORT wxTextOutputStream &endl( wxTextOutputStream &stream );
+WXDLLIMPEXP_BASE wxTextOutputStream &endl( wxTextOutputStream &stream );

 
 
 
 

-class WXDLLEXPORT wxTextInputStream
+#define wxEOT wxT('\4') // the End-Of-Text control code (used only inside wxTextInputStream)
+
+// If you're scanning through a file using wxTextInputStream, you should check for EOF _before_
+// reading the next item (word / number), because otherwise the last item may get lost. 
+// You should however be prepared to receive an empty item (empty string / zero number) at the
+// end of file, especially on Windows systems. This is unavoidable because most (but not all) files end
+// with whitespace (i.e. usually a newline).
+class WXDLLIMPEXP_BASE wxTextInputStream

 {
 public:
 #if wxUSE_UNICODE
 {
 public:
 #if wxUSE_UNICODE


@@ -39,11 +46,14 @@ public:
 #endif
     ~wxTextInputStream();
 
 #endif
     ~wxTextInputStream();
 

-    wxUint32 Read32();
-    wxUint16 Read16();
-    wxUint8  Read8();
+    wxUint32 Read32(int base = 10); // base may be between 2 and 36, inclusive, or the special 0 (= C format)
+    wxUint16 Read16(int base = 10);
+    wxUint8  Read8(int base = 10);
+    wxInt32  Read32S(int base = 10);
+    wxInt16  Read16S(int base = 10);
+    wxInt8   Read8S(int base = 10);

     double   ReadDouble();
     double   ReadDouble();

-    wxString ReadString();  // deprecated use ReadLine or ReadWord instead
+    wxString ReadString();  // deprecated: use ReadLine or ReadWord instead

     wxString ReadLine();
     wxString ReadWord();
 
     wxString ReadLine();
     wxString ReadWord();
 


@@ -65,14 +75,19 @@ public:
 protected:
     wxInputStream &m_input;
     wxString m_separators;
 protected:
     wxInputStream &m_input;
     wxString m_separators;

+    char m_lastBytes[10]; // stores the bytes that were read for the last character

     
 #if wxUSE_UNICODE
     wxMBConv &m_conv;
 #endif
 
     bool   EatEOL(const wxChar &c);
     
 #if wxUSE_UNICODE
     wxMBConv &m_conv;
 #endif
 
     bool   EatEOL(const wxChar &c);

+    void   UngetLast(); // should be used instead of wxInputStream::Ungetch() because of Unicode issues
+    // returns EOT (\4) if there is a stream error, or end of file
+    wxChar NextChar();   // this should be used instead of GetC() because of Unicode issues

     wxChar NextNonSeparators();
     wxChar NextNonSeparators();

-    void   SkipIfEndOfLine( wxChar c );
+
+    DECLARE_NO_COPY_CLASS(wxTextInputStream)

 };
 
 typedef enum
 };
 
 typedef enum


@@ -83,7 +98,7 @@ typedef enum
   wxEOL_DOS
 } wxEOL;
 
   wxEOL_DOS
 } wxEOL;
 

-class WXDLLEXPORT wxTextOutputStream
+class WXDLLIMPEXP_BASE wxTextOutputStream

 {
 public:
 #if wxUSE_UNICODE
 {
 public:
 #if wxUSE_UNICODE


@@ -122,6 +137,7 @@ protected:
     wxMBConv &m_conv;
 #endif
 
     wxMBConv &m_conv;
 #endif
 

+    DECLARE_NO_COPY_CLASS(wxTextOutputStream)

 };
 
 #endif
 };
 
 #endif