Index: ppapi/shared_impl/var_value_conversions.h |
diff --git a/ppapi/shared_impl/var_value_conversions.h b/ppapi/shared_impl/var_value_conversions.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..09145ce06e20100759028671bbab4928859d7a90 |
--- /dev/null |
+++ b/ppapi/shared_impl/var_value_conversions.h |
@@ -0,0 +1,41 @@ |
+// 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 "ppapi/c/pp_var.h" |
+#include "ppapi/shared_impl/ppapi_shared_export.h" |
+ |
+namespace base { |
+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. |
+// |
+// 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. |
+// Returns an undefined var if the conversion fails. |
+PPAPI_SHARED_EXPORT PP_Var CreateVarFromValue(const base::Value& value); |
+ |
+} // namespace ppapi |
+ |
+#endif // PPAPI_SHARED_IMPL_VAR_VALUE_CONVERSIONS_H_ |