PPAPI: Move PPB_DirectoryReader_Dev to stable (won't commit)

ppapi/cpp/directory_entry.h

+// Copyright (c) 2011 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+#ifndef PPAPI_CPP_DIRECTORY_ENTRY_H_
+#define PPAPI_CPP_DIRECTORY_ENTRY_H_
+
+#include "ppapi/c/ppb_directory_reader.h"
+#include "ppapi/cpp/file_ref.h"
+
+/// @file
+/// This file defines the API used to handle a directory entry.
+
+namespace pp {
+
+/// The <code>DirectoryEntry</code> class represents information about a
+/// directory entry.
+class DirectoryEntry {
+ public:
+  /// Default constructor for creating an is_null() <code>DirectoryEntry</code>
+  /// object.
+  DirectoryEntry();
+
+  /// A constructor used when you have a <code>PP_DirectoryEntry</code> which
+  /// contains a <code>FileRef</code> that has already been reference counted
+  /// as a return value.
+  ///
+  /// @param[in] data A <code>PP_DirectoryEntry</code> to be copied.
+  DirectoryEntry(PassRef, const PP_DirectoryEntry& data);
+
+  /// A copy constructor for <code>DirectoryEntry</code>. This constructor
+  /// increments a reference count of the <code>FileRef</code> held by this
+  /// DirectoryEntry.
+  ///
+  /// @param[in] other A pointer to a <code>DirectoryEntry</code>.
+  DirectoryEntry(const DirectoryEntry& other);
+
+  /// A destructor that decrements a reference count of the <code>FileRef</code>
+  /// held by this <code>DirectoryEntry</code>.
+  ~DirectoryEntry();
+
+  /// This function assigns one <code>DirectoryEntry</code> object to this
+  /// <code>DirectoryEntry</code> object. This function increases the reference
+  /// count of the <code>FileRef</code> of the other DirectoryEntry while
+  /// decrementing the reference count of the FileRef of this DirectoryEntry.
+  ///
+  /// @param[in] other A pointer to a <code>DirectoryEntry</code>.
+  ///
+  /// @return A new <code>DirectoryEntry</code> object.
+  DirectoryEntry& operator=(const DirectoryEntry& other);
+
+  /// This function determines if this <code>DirectoryEntry</code> is a null
+  /// value.
+  ///
+  /// @return true if this <code>DirectoryEntry</code> is null, otherwise false.
+  bool is_null() const { return !data_.file_ref; }
+
+  /// This function returns the <code>FileRef</code> held by this
+  /// <code>DirectoryEntry</code>.
+  ///
+  /// @return A <code>FileRef</code> of the file.
+  FileRef file_ref() const { return FileRef(data_.file_ref); }
+
+  /// This function returns the <code>PP_FileType</code> of the file referenced
+  /// by this <code>DirectoryEntry</code>.
+  ///
+  /// @return A <code>PP_FileType</code> of the file.
+  PP_FileType file_type() const { return data_.file_type; }
+
+ private:
+  PP_DirectoryEntry data_;
+};
+
+}  // namespace pp
+
+#endif  // PPAPI_CPP_DIRECTORY_ENTRY_H_