From ea8063fa8ee79678226becafe568468aa6597b43 Mon Sep 17 00:00:00 2001 From: "jond@google.com" Date: Tue, 9 Aug 2011 22:17:31 +0000 Subject: C++ File IO documentation. Review URL: http://codereview.chromium.org/7307037 git-svn-id: svn://svn.chromium.org/chrome/trunk/src@96083 0039d316-1c4b-4281-b951-d872f2087c98 --- ppapi/cpp/file_io.h | 38 ++++++++++++++++++++++---------------- 1 file changed, 22 insertions(+), 16 deletions(-) (limited to 'ppapi/cpp/file_io.h') diff --git a/ppapi/cpp/file_io.h b/ppapi/cpp/file_io.h index 290c7d6..d850627 100644 --- a/ppapi/cpp/file_io.h +++ b/ppapi/cpp/file_io.h @@ -46,10 +46,11 @@ class FileIO : public Resource { /// reference. /// @param[in] open_flags A bit-mask of the PP_FileOpenFlags /// values. - /// @param[in] callback A CompletionCallback to be called upon + /// @param[in] cc A CompletionCallback to be called upon /// completion of Open(). /// - /// @return An int32_t containing an error code from pp_errors.h. + /// @return An int32_t containing an error code from + /// pp_errors.h. int32_t Open(const FileRef& file_ref, int32_t open_flags, const CompletionCallback& cc); @@ -57,12 +58,13 @@ class FileIO : public Resource { /// Query() queries info about the file opened by this FileIO object. This /// function will fail if the FileIO object has not been opened. /// - /// @param[in] info The PP_FileInfo structure representing all - /// information about the file. - /// @param[in] callback A CompletionCallback to be called upon + /// @param[in] result_buf The PP_FileInfo structure representing + /// all information about the file. + /// @param[in] cc A CompletionCallback to be called upon /// completion of Query(). /// - /// @return An int32_t containing an error code from pp_errors.h. + /// @return An int32_t containing an error code from + /// pp_errors.h. int32_t Query(PP_FileInfo* result_buf, const CompletionCallback& cc); @@ -71,23 +73,24 @@ class FileIO : public Resource { /// /// @param[in] last_access_time The last time the FileIO was accessed. /// @param[in] last_modified_time The last time the FileIO was modified. - /// @param[in] callback A CompletionCallback to be called upon + /// @param[in] cc A CompletionCallback to be called upon /// completion of Touch(). /// - /// @return An int32_t containing an error code from pp_errors.h. + /// @return An int32_t containing an error code from + /// pp_errors.h. int32_t Touch(PP_Time last_access_time, PP_Time last_modified_time, const CompletionCallback& cc); /// Read() reads from an offset in the file. The size of the buffer must be - /// large enough to hold the specified number of bytes to read. This function - /// might perform a partial read. + /// large enough to hold the specified number of bytes to read. This + /// function might perform a partial read. /// /// @param[in] offset The offset into the file. /// @param[in] buffer The buffer to hold the specified number of bytes read. /// @param[in] bytes_to_read The number of bytes to read from /// offset. - /// @param[in] callback A CompletionCallback to be called upon + /// @param[in] cc A CompletionCallback to be called upon /// completion of Read(). /// /// @return An The number of bytes read an error code from @@ -106,7 +109,7 @@ class FileIO : public Resource { /// @param[in] buffer The buffer to hold the specified number of bytes read. /// @param[in] bytes_to_write The number of bytes to write to /// offset. - /// @param[in] callback A CompletionCallback to be called upon + /// @param[in] cc A CompletionCallback to be called upon /// completion of Write(). /// /// @return An The number of bytes written or an error code from @@ -123,25 +126,28 @@ class FileIO : public Resource { /// have been opened with write access. /// /// @param[in] length The length of the file to be set. - /// @param[in] callback A CompletionCallback to be called upon + /// @param[in] cc A CompletionCallback to be called upon /// completion of SetLength(). /// - /// @return An int32_t containing an error code from pp_errors.h. + /// @return An int32_t containing an error code from + /// pp_errors.h. int32_t SetLength(int64_t length, const CompletionCallback& cc); /// Flush() flushes changes to disk. This call can be very expensive! /// - /// @param[in] callback A CompletionCallback to be called upon + /// @param[in] cc A CompletionCallback to be called upon /// completion of Flush(). /// - /// @return An int32_t containing an error code from pp_errors.h. + /// @return An int32_t containing an error code from + /// pp_errors.h. int32_t Flush(const CompletionCallback& cc); /// Close() cancels any IO that may be pending, and closes the FileIO object. /// Any pending callbacks will still run, reporting /// PP_Error_Aborted if pending IO was interrupted. It is not /// valid to call Open() again after a call to this method. + /// /// Note: If the FileIO object is destroyed, and it is still /// open, then it will be implicitly closed, so you are not required to call /// Close(). -- cgit v1.1