Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(104)

Side by Side Diff: util/file/file_reader.h

Issue 913223008: Add FileReaderInterface::ReadExactly() and FileSeekerInterface::SeekSet() (Closed) Base URL: https://chromium.googlesource.com/crashpad/crashpad@master
Patch Set: Created 5 years, 10 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
« no previous file with comments | « no previous file | util/file/file_reader.cc » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 // Copyright 2015 The Crashpad Authors. All rights reserved. 1 // Copyright 2015 The Crashpad Authors. All rights reserved.
2 // 2 //
3 // Licensed under the Apache License, Version 2.0 (the "License"); 3 // Licensed under the Apache License, Version 2.0 (the "License");
4 // you may not use this file except in compliance with the License. 4 // you may not use this file except in compliance with the License.
5 // You may obtain a copy of the License at 5 // You may obtain a copy of the License at
6 // 6 //
7 // http://www.apache.org/licenses/LICENSE-2.0 7 // http://www.apache.org/licenses/LICENSE-2.0
8 // 8 //
9 // Unless required by applicable law or agreed to in writing, software 9 // Unless required by applicable law or agreed to in writing, software
10 // distributed under the License is distributed on an "AS IS" BASIS, 10 // distributed under the License is distributed on an "AS IS" BASIS,
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 // See the License for the specific language governing permissions and 12 // See the License for the specific language governing permissions and
13 // limitations under the License. 13 // limitations under the License.
14 14
15 #ifndef CRASHPAD_UTIL_FILE_FILE_READER_H_ 15 #ifndef CRASHPAD_UTIL_FILE_FILE_READER_H_
16 #define CRASHPAD_UTIL_FILE_FILE_READER_H_ 16 #define CRASHPAD_UTIL_FILE_FILE_READER_H_
17 17
18 #include <sys/types.h> 18 #include <sys/types.h>
19 19
20 #include "base/basictypes.h" 20 #include "base/basictypes.h"
21 #include "base/files/file_path.h" 21 #include "base/files/file_path.h"
22 #include "util/file/file_io.h" 22 #include "util/file/file_io.h"
23 #include "util/file/file_seeker.h" 23 #include "util/file/file_seeker.h"
24 24
25 namespace crashpad { 25 namespace crashpad {
26 26
27 //! \brief An interface to read to files and other file-like objects with 27 //! \brief An interface to read to files and other file-like objects with
28 //! semantics matching the underlying platform (POSIX or Windows). 28 //! semantics matching the underlying platform (POSIX or Windows).
29 class FileReaderInterface : public FileSeekerInterface { 29 class FileReaderInterface : public virtual FileSeekerInterface {
30 public: 30 public:
31 //! \brief Wraps ReadFile(), or provides an implementation with identical 31 //! \brief Wraps ReadFile(), or provides an implementation with identical
32 //! semantics. 32 //! semantics.
33 //! 33 //!
34 //! \return The number of bytes actually read if the operation succeeded, 34 //! \return The number of bytes actually read if the operation succeeded,
35 //! which may be `0` or any positive value less than or equal to \a size. 35 //! which may be `0` or any positive value less than or equal to \a size.
36 //! `-1` if the operation failed, with an error message logged. 36 //! `-1` if the operation failed, with an error message logged.
37 virtual ssize_t Read(void* data, size_t size) = 0; 37 virtual ssize_t Read(void* data, size_t size) = 0;
38 38
39 //! \brief Wraps Read(), ensuring that the read succeeded and exactly \a size
40 //! bytes were read.
41 //!
42 //! Semantically, this behaves as LoggingReadFile().
43 //!
44 //! \return `true` if the operation succeeded, `false` if it failed, with an
45 //! error message logged. Short reads are treated as failures.
46 bool ReadExactly(void* data, size_t size);
47
39 protected: 48 protected:
40 ~FileReaderInterface() {} 49 ~FileReaderInterface() {}
41 }; 50 };
42 51
43 //! \brief A file reader backed by a FileHandle. 52 //! \brief A file reader backed by a FileHandle.
44 //! 53 //!
45 //! FileReader requires users to provide a FilePath to open, but this class 54 //! FileReader requires users to provide a FilePath to open, but this class
46 //! accepts an already-open FileHandle instead. Like FileReader, this class may 55 //! accepts an already-open FileHandle instead. Like FileReader, this class may
47 //! read from a filesystem-based file, but unlike FileReader, this class is not 56 //! read from a filesystem-based file, but unlike FileReader, this class is not
48 //! responsible for opening or closing the file. Users of this class must ensure 57 //! responsible for opening or closing the file. Users of this class must ensure
(...skipping 82 matching lines...) Expand 10 before | Expand all | Expand 10 after
131 private: 140 private:
132 ScopedFileHandle file_; 141 ScopedFileHandle file_;
133 WeakFileHandleFileReader weak_file_handle_file_reader_; 142 WeakFileHandleFileReader weak_file_handle_file_reader_;
134 143
135 DISALLOW_COPY_AND_ASSIGN(FileReader); 144 DISALLOW_COPY_AND_ASSIGN(FileReader);
136 }; 145 };
137 146
138 } // namespace crashpad 147 } // namespace crashpad
139 148
140 #endif // CRASHPAD_UTIL_FILE_FILE_READER_H_ 149 #endif // CRASHPAD_UTIL_FILE_FILE_READER_H_
OLDNEW
« no previous file with comments | « no previous file | util/file/file_reader.cc » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698