Create a VarPrivate interface to contain the scripting helper functions of Var.

ppapi/c/pp_var.h

 /* Copyright (c) 2010 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_C_PP_VAR_H_
 #define PPAPI_C_PP_VAR_H_
 
 #include "ppapi/c/pp_bool.h"
 #include "ppapi/c/pp_macros.h"
 #include "ppapi/c/pp_stdint.h"
 
 /**
  * @file
  * This file defines the API for handling the passing of data types between
  * your module and the page.
  */
 
 /**
  *
  * @addtogroup Enums
  * @{
  */
 
 /**
  * PP_VarType is an enumeration of the different types that can be contained
  * within a PP_VAR structure.
  */
 typedef enum {
+  /**
+   * An undefined value.
+   */
   PP_VARTYPE_UNDEFINED,
+
+  /**
+   * A NULL value. This is similar to undefined, but JavaScript differentiates
+   * the two so we expose it here as well.
+   */
   PP_VARTYPE_NULL,
+
+  /**
+   * A boolean value, use the as_bool member of the var.
+   */
   PP_VARTYPE_BOOL,
+
+  /**
+   * A 32-bit integer value. Use the as_int member of the var.
+   */
   PP_VARTYPE_INT32,
+
+  /**
+   * A double-precision floating point value. Use the as_double member of the
+   * var.
+   */
   PP_VARTYPE_DOUBLE,
+
+  /**
+   * The Var represents a string. The as_id field is used to identify the
+   * string, which may be created and retrieved from the PPB_Var interface.
+   */
   PP_VARTYPE_STRING,
-  PP_VARTYPE_OBJECT
+
+  /**
+   * Represents a JavaScript object. This vartype is not currently usable
+   * from plugins, although it is used internally for some tasks.
+   */
+  PP_VARTYPE_OBJECT,
+
+  /**
+   * Arrays and dictionaries are not currently supported but will be added
+   * in future revisions. These objects are reference counted so be sure
+   * to properly AddRef/Release them as you would with strings to ensure your
+   * plugin will continue to work with future versions of the API.
+   */
+  PP_VARTYPE_ARRAY,
+  PP_VARTYPE_DICTIONARY
 } PP_VarType;
 PP_COMPILE_ASSERT_SIZE_IN_BYTES(PP_VarType, 4);
 /**
  * @}
  */
 
 /**
  * @addtogroup Structs
  * @{
  */
@@ skipping 20 matching lines @@
    *  for 32-bit x86, and some align on 4-byte boundaries.
    */
   int32_t padding;
 
   union {
     PP_Bool as_bool;
     int32_t as_int;
     double as_double;
 
     /**
-     * Internal ID for strings and objects. The identifier is an opaque handle
-     * assigned by the browser to the plugin. It is guaranteed never to be 0,
-     * so a plugin can initialize this ID to 0 to indicate a "NULL handle."
+     * Internal ID for strings objects, arrays, and dictionaries. The
+     * identifier is an opaque handle assigned by the browser to the plugin. It
+     * is guaranteed never to be 0, so a plugin can initialize this ID to 0 to
+     * indicate a "NULL handle."
      */
     int64_t as_id;
   } value;
 };
 PP_COMPILE_ASSERT_STRUCT_SIZE_IN_BYTES(PP_Var, 16);
 /**
  * @}
  */
 
 /**
@@ skipping 55 matching lines @@
   struct PP_Var result = { PP_VARTYPE_DOUBLE, 0, {PP_FALSE} };
   result.value.as_double = value;
   return result;
 }
 /**
  * @}
  */
 
 #endif  /* PPAPI_C_PP_VAR_H_ */