NAME
    Sub::Lvalue - use lvalue subroutines with ease

VERSION
    Version 0.01

SYNOPSIS
    Simply put get and set blocks at the end of your lvalue sub. Please
    note, no comma or semicolon between statements are allowed (in case of
    semicolon only last statement will be take an action)

        use Sub::Lvalue;

        sub mysub : lvalue {
            get {
                return 'result for get';
            }
            set {
                my $set_value = shift;
                # ...
            }
        }

        mysub() = 'test'; # will invoke set block with argument 'test';
        print mysub(); # will invoke get block without arguments. result will be returned to print;

        sub readonly : lvalue {
            get {
                return 'readonly value';
            }
        }

        print readonly();  # ok
        readonly = 'test'; # fails

        sub writeonly : lvalue {
            set {
                my $set_value = shift;
                # ...
            }
        }

        writeonly = 'test'; # ok
        print writeonly();  # fails

EXPORT
    There are 2 export functions: "set" and "get". If you don't want to use
    export, you may use full names

        sub mysub : lvalue {
            Sub::Lvalue::get {
                return 'something';
            }
            Sub::Lvalue::set {
                my $set_value = shift;
            }
        }

FUNCTIONS
  set
    invoked with argument from right side

  get
    invoked without arguments. the returned value passed out

RENAMING
    From it's creation in 2009 till 2016 this module has name lvalue. In
    2010 there were appeared module Lvalue.

    During years, there were semantic conflict between Lvalue and lvalue.
    But this days PAUSE threats CPAN module names case insensitive that
    leads us to name conflict.

    After all, there is another great module LV. As stated by its author,
    some part of it was inspired by "lvalue".

    I decided to eliminame original name lvalue and to keep original source
    code if someone needs it under the name Sub::Lvalue

AUTHOR
    Mons Anderson, <mons@cpan.org>

BUGS
    None known

COPYRIGHT & LICENSE
    Copyright 2009 Mons Anderson.

    This program is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.