[PPAPI] Moving pp::VarResource_Dev API into pp::Var (now stable).

ppapi/cpp/var.h

 // 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.
 
 #ifndef PPAPI_CPP_VAR_H_
 #define PPAPI_CPP_VAR_H_
 
 #include <string>
 #include <vector>
 
 #include "ppapi/c/pp_var.h"
 #include "ppapi/cpp/pass_ref.h"
+#include "ppapi/cpp/resource.h"
 
 /// @file
 /// This file defines the API for handling the passing of data types between
 /// your module and the page.
 namespace pp {
 
 /// A generic type used for passing data types between the module and the page.
 class Var {
  public:
   /// Special value passed to constructor to make <code>NULL</code>.
@@ skipping 20 matching lines @@
   ///
   /// @param[in] d A double value.
   Var(double d);
 
   /// A constructor used to create a UTF-8 character <code>Var</code>.
   Var(const char* utf8_str);  // Must be encoded in UTF-8.
 
   /// A constructor used to create a UTF-8 character <code>Var</code>.
   Var(const std::string& utf8_str);  // Must be encoded in UTF-8.
 
+  /// A constructor used to create a resource <code>Var</code>.
+  explicit Var(const pp::Resource& resource);
+
   /// A constructor used when you have received a <code>Var</code> as a return
   /// value that has had its reference count incremented for you.
   ///
   /// You will not normally need to use this constructor because
   /// the reference count will not normally be incremented for you.
   Var(PassRef, const PP_Var& var) {
     var_ = var;
     is_managed_ = true;
   }
 
@@ skipping 139 matching lines @@
   ///
   /// @return An double version of this <code>Var</code>.
   double AsDouble() const;
 
   /// AsString() converts this <code>Var</code> to a string. If this object is
   /// not a string, it will assert in debug mode, and return an empty string.
   ///
   /// @return A string version of this <code>Var</code>.
   std::string AsString() const;
 
+  /// Gets the resource contained in the var. If this object is not a resource,
+  /// it will assert in debug mode, and return a null resource.
+  ///
+  /// @return The <code>pp::Resource</code> that is contained in the var.
+  pp::Resource AsResource() const;
+
   /// This function returns the internal <code>PP_Var</code>
   /// managed by this <code>Var</code> object.
   ///
   /// @return A const reference to a <code>PP_Var</code>.
   const PP_Var& pp_var() const {
     return var_;
   }
 
   /// Detach() detaches from the internal <code>PP_Var</code> of this
   /// object, keeping the reference count the same. This is used when returning
@@ skipping 82 matching lines @@
  private:
   // Prevent an arbitrary pointer argument from being implicitly converted to
   // a bool at Var construction. If somebody makes such a mistake, (s)he will
   // get a compilation error.
   Var(void* non_scriptable_object_pointer);
 };
 
 }  // namespace pp
 
 #endif  // PPAPI_CPP_VAR_H_