======combine======

<box>
Combine an [[PTPScript:Types:Array|Array]] of item keys with an [[PTPScript:Types:Array|Array]] of item values.

\\
**Syntax**
  * ''[[PTPScript:Types:Array|Array]] combine( [[PTPScript:Types:Array|Array]] keys, [[PTPScript:Types:Array|Array]] values )''

\\
**Parameters**
  * [[PTPScript:Types:Array|Array]] ''keys'' - The Array containing the item values to use as item keys.
  * [[PTPScript:Types:Array|Array]] ''values'' - The Array containing the item values to use as item values.

\\
**Result**
  * [[PTPScript:Types:Array|Array]] - An Array containing all of the item values of ''keys'' as item keys and all of the values of ''values'' as item values.
</box>

Returns an Array created by combining ''keys'' and ''values''.

<note warning>
Boolean **''false''** will be returned if the number of items in ''keys'' is not equal to the number of items in ''values'', or if either ''keys'' or ''values'' is empty.
</note>