Apps V2 in Pepper: introduce singleton resource ExtensionsCommon.

ppapi/shared_impl/var_value_conversions.h

 // Copyright (c) 2013 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_SHARED_IMPL_VAR_VALUE_CONVERSIONS_H_
 #define PPAPI_SHARED_IMPL_VAR_VALUE_CONVERSIONS_H_
 
+#include <vector>
+
 #include "ppapi/c/pp_var.h"
 #include "ppapi/shared_impl/ppapi_shared_export.h"
 
 namespace base {
+class ListValue;
 class Value;
 }
 
 namespace ppapi {
 
 // Converts a PP_Var to a base::Value object. The caller takes ownership of the
 // returned object.
 //
 // Both PP_VARTYPE_UNDEFINED and PP_VARTYPE_NULL are converted to
 // base::Value::TYPE_NULL. In dictionary vars, key-value pairs whose value is
-// undefined (PP_VARTYPE_UNDEFINED) are ignored. If a node in |var| appears more
-// than once, it is duplicated in the result. For example, if |var| is an array
-// and it has two elements pointing to the same dictionary, the resulting list
-// value will have two copies of the dictionary.
+// undefined (PP_VARTYPE_UNDEFINED) or null (PP_VARTYPE_NULL) are ignored. If a
+// node in |var| appears more than once, it is duplicated in the result. For
+// example, if |var| is an array and it has two elements pointing to the same
+// dictionary, the resulting list value will have two copies of the dictionary.
 //
 // The conversion fails and returns NULL if
 // - |var| is object (PP_VARTYPE_OBJECT); or
 // - |var| is an array or dictionary, and calling CreateValueFromVar() on any of
 //   the array elements or dictionary values fails; or
 // - there exist circular references, i.e., an array or dictionary is its own
 //   ancestor/descendant.
 PPAPI_SHARED_EXPORT base::Value* CreateValueFromVar(const PP_Var& var);
 
-// The returned var has been added ref on behalf of the caller.
+// The returned var has had 1 ref added on behalf of the caller.
 // Returns an undefined var if the conversion fails.
 PPAPI_SHARED_EXPORT PP_Var CreateVarFromValue(const base::Value& value);
 
+// Calls CreateValueFromVar() on each element of |vars| and puts them in a
+// base::ListValue. The caller takes ownership of the returned object.
+//
+// The conversion fails and returns NULL if any of the calls to
+// CreateValueFromVar() fails.
+PPAPI_SHARED_EXPORT base::ListValue* CreateListValueFromVarVector(
+    const std::vector<PP_Var>& vars);
+
+// Calls CreateVarFromValue() on each element of |list_value| and puts them in
+// |vars|. The returned vars have had 1 ref added on behalf of the caller.
+//
+// The conversion fails and returns false if any of the calls to
+// CreateVarFromValue() fails. In that case, |vars| is untouched.
+PPAPI_SHARED_EXPORT bool CreateVarVectorFromListValue(
+    const base::ListValue& list_value, std::vector<PP_Var>* vars);
+
 }  // namespace ppapi
 
 #endif  // PPAPI_SHARED_IMPL_VAR_VALUE_CONVERSIONS_H_