Add wxDir::Close().

This is trivial to have and can sometimes be useful and also is symmetric to
Open().

Closes #14493.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@72204 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

docs/changes.txt

@@ -527,6 +527,10 @@ Major new features in this release
 2.9.5: (released ????-??-??)
 ----------------------------
 
+All:
+
+- Add wxDir::Close() method (Silverstorm82).
+
 All (GUI):
 
 - Add possibility to hide and show again wxRibbonBar pages (wxBen).

include/wx/dir.h

@@ -94,12 +94,15 @@ public:
     // opens the directory for enumeration, use IsOpened() to test success
     wxDir(const wxString& dir);
 
-    // dtor cleans up the associated resources
+    // dtor calls Close() automatically
-    ~wxDir();
+    ~wxDir() { Close(); }
 
     // open the directory for enumerating
     bool Open(const wxString& dir);
 
+    // close the directory, Open() can be called again later
+    void Close();
+
     // returns true if the directory was successfully opened
     bool IsOpened() const;
 

interface/wx/dir.h

@@ -160,11 +160,23 @@ public:
     wxDir(const wxString& dir);
 
     /**
-        Destructor cleans up the associated resources. It is not virtual and so
+        Destructor cleans up the associated resources by calling Close().
-        this class is not meant to be used polymorphically.
+
+        It is not virtual and so this class is not meant to be used
+        polymorphically.
     */
     ~wxDir();
 
+    /**
+        Close the directory.
+
+        The object can't be used after closing it, but Open() may be called
+        again to reopen it later.
+
+        @since 2.9.5
+    */
+    void Close();
+
     /**
         Test for existence of a directory with the given name.
     */

src/msw/dir.cpp

@@ -343,9 +343,13 @@ wxString wxDir::GetName() const
     return name;
 }
 
-wxDir::~wxDir()
+void wxDir::Close()
 {
-    delete M_DIR;
+    if ( m_data )
+    {
+        delete m_data;
+        m_data = NULL;
+    }
 }
 
 // ----------------------------------------------------------------------------

src/unix/dir.cpp

@@ -248,9 +248,13 @@ wxString wxDir::GetName() const
     return name;
 }
 
-wxDir::~wxDir()
+void wxDir::Close()
 {
-    delete M_DIR;
+    if ( m_data )
+    {
+        delete m_data;
+        m_data = NULL;
+    }
 }
 
 // ----------------------------------------------------------------------------