.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "JE::LValue 3pm"
.TH JE::LValue 3pm "2014-10-12" "perl v5.20.1" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
JE::LValue \- JavaScript lvalue class
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&  use JE::LValue;
\&
\&  $lv = new JE::LValue $some_obj, \*(Aqproperty_name\*(Aq;
\&
\&  $lv\->get;         # get property
\&  $lv\->set($value)  # set property
\&
\&  $lv\->some_other_method  # same as $lv\->get\->some_other_method
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This class implements JavaScript lvalues (called \*(L"Reference Types\*(R" by the
ECMAScript specification).
.SH "METHODS AND OVERLOADING"
.IX Header "METHODS AND OVERLOADING"
If a method is called that is not listed here, it will be passed to the 
property referenced by the lvalue. (See the last item in the \s-1SYNOPSIS\s0,
above.) For this reason, you should never call \f(CW\*(C`UNIVERSAL::can\*(C'\fR on a
JE::LValue, but, rather, call it as a method (\f(CW\*(C`$lv\->can(...)\*(C'\fR), unless
you really know what you are doing.
.PP
Similarly, if you try to use an overloaded operator, it will be passed on 
to
the object that the lvalue references, such that \f(CW\*(C`!$lvalue\*(C'\fR is the same
as calling \f(CW\*(C`!$lvalue\->get\*(C'\fR.
.ie n .IP "$lv = new JE::LValue $obj, $property" 4
.el .IP "\f(CW$lv\fR = new JE::LValue \f(CW$obj\fR, \f(CW$property\fR" 4
.IX Item "$lv = new JE::LValue $obj, $property"
Creates an lvalue/reference with \f(CW$obj\fR as the base object and \f(CW$property\fR
as the property name. If \f(CW$obj\fR is undefined or null, a TypeError is thrown.
To create a lvalue that has no base object, and which will throw a
ReferenceError when 
\&\f(CW\*(C`\->get\*(C'\fR is
called and create a global property upon invocation of \f(CW\*(C`\->set\*(C'\fR, pass
an unblessed reference to a global object as the first argument. (This is
used by bare identifiers in \s-1JS\s0 expressions.)
.ie n .IP "$lv\->get" 4
.el .IP "\f(CW$lv\fR\->get" 4
.IX Item "$lv->get"
Gets the value of the property.
.ie n .IP "$lv\->set($value)" 4
.el .IP "\f(CW$lv\fR\->set($value)" 4
.IX Item "$lv->set($value)"
Sets the property to \f(CW$value\fR and returns \f(CW$value\fR. If the lvalue has no base
object, the global object will become its base object automatically. 
<Note:> Whether the lvalue object itself is modified in the latter case is
not set in stone yet. (Currently it is modified, but that may change.)
.ie n .IP "$lv\->call(@args)" 4
.el .IP "\f(CW$lv\fR\->call(@args)" 4
.IX Item "$lv->call(@args)"
If the property is a function, this calls the function with the
base object as the 'this' value.
.ie n .IP "$lv\->base" 4
.el .IP "\f(CW$lv\fR\->base" 4
.IX Item "$lv->base"
Returns the base object. If there isn't any, it returns undef or an empty
list, depending on context.
.ie n .IP "$lv\->property" 4
.el .IP "\f(CW$lv\fR\->property" 4
.IX Item "$lv->property"
Returns the property name.