Provide a safer URLLoader ReadResponseBody API

ppapi/api/ppb_url_loader.idl

 /* Copyright (c) 2012 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.
  */
 
 /**
  * This file defines the <strong>PPB_URLLoader</strong> interface for loading
  * URLs.
  */
 
 label Chrome {
-  M14 = 1.0
+  M14 = 1.0,
+  M26 = 1.1
 };
 
 /**
  * The <strong>PPB_URLLoader</strong> interface contains pointers to functions
  * for loading URLs. The typical steps for loading a URL are:
  *
  * -# Call Create() to create a URLLoader object.
  * -# Create a <code>URLRequestInfo</code> object and set properties on it.
  * Refer to <code>PPB_URLRequestInfo</code> for further information.
  * -# Call Open() with the <code>URLRequestInfo</code> as an argument.
@@ skipping 133 matching lines @@
    * resource or if Open() has not been called.
    */
   PP_Resource GetResponseInfo(
       [in] PP_Resource loader);
 
   /**
    * ReadResponseBody() is used to read the response body. 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.
    *
+   * ReadResponseBodyToArray() is preferred to ReadResponseBody() when doing
+   * asynchronous operations.
+   *
    * @param[in] loader A <code>PP_Resource</code> corresponding to a
    * <code>URLLoader</code>.
    * @param[in,out] buffer A pointer to the buffer for the response body.
    * @param[in] bytes_to_read The number of bytes to read.
    * @param[in] callback A <code>PP_CompletionCallback</code> to run on
    * asynchronous completion. The callback will run if the bytes (full or
    * partial) are read or an error occurs asynchronously. This callback will
    * run only if this function returns <code>PP_OK_COMPLETIONPENDING</code>.
    *
    * @return An int32_t containing the number of bytes read or an error code
@@ skipping 34 matching lines @@
    *
    * <strong>Note:</strong> If the <code>URLLoader</code> object is destroyed
    * while it is still open, then it will be implicitly closed so you are not
    * required to call Close().
    *
    * @param[in] loader A <code>PP_Resource</code> corresponding to a
    * <code>URLLoader</code>.
    */
   void Close(
       [in] PP_Resource loader);
+
+  /**
+   * ReadResponseBody() is used to read the response body. 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.
+   *
+   * @param[in] loader A <code>PP_Resource</code> corresponding to a
+   * <code>URLLoader</code>.
+   * @param[in,out] output A <code>PP_ArrayOutput</code> to hold the output.
+   * @param[in] max_read_length The number of bytes to read.
+   * @param[in] callback A <code>PP_CompletionCallback</code> to run on
+   * asynchronous completion. The callback will run if the bytes (full or
+   * partial) are read or an error occurs asynchronously. This callback will
+   * run only if this function returns <code>PP_OK_COMPLETIONPENDING</code>.
+   *
+   * @return An int32_t containing the number of bytes read or an error code
+   * from <code>pp_errors.h</code>.
+   */
+  [version = 1.1]
+  int32_t ReadResponseBodyToArray(
+      [in] PP_Resource loader,
+      [in] int32_t max_read_length,
+      [inout] PP_ArrayOutput output,
+      [in] PP_CompletionCallback callback);
 };