JE::Object - JavaScript Array object class


JE documentation  | view source Contained in the JE distribution.

Index


NAME

Top

JE::Object - JavaScript Array object class

SYNOPSIS

Top

  use JE;
  use JE::Object::Array;

  $j = new JE;

  $js_array = new JE::Object::Array $j, 1, 2, 3;

  $perl_arrayref = $js_array->value; # returns [1, 2, 3]

  $js_array->[1]; # same as $js_array->value->[1]

  "$js_array"; # returns "1,2,3"

DESCRIPTION

Top

This module implements JavaScript Array objects.

The @{} (array ref) operator is overloaded and returns a tied array that you can use to modify the array object itself. The limitations and caveats mentioned in JE::Object/"USING AN OBJECT AS A HASH" apply here, too.

METHODS

Top

See JE::Types for descriptions of most of the methods. Only what is specific to JE::Object::Array is explained here.

$a = JE::Object::Array->new($global_obj, \@elements)
$a = JE::Object::Array->new($global_obj, $length)
$a = JE::Object::Array->new($global_obj, @elements)

This creates a new Array object.

If the second argument is an unblessed array ref, the elements of that array become the elements of the new array object.

If there are two arguments and the second is a JE::Number, a new array is created with that number as the length.

Otherwise, all arguments starting from the second one become elements of the new array object.

$a->value

This returns a reference to an array. This is a copy of the Array object's internal array. If you want an array through which you can modify the object, use @$a.

SEE ALSO

Top

JE

JE::Types

JE::Object


JE documentation  | view source Contained in the JE distribution.