File: Class.pm

package info (click to toggle)
librose-object-perl 0.858-1
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 292 kB
  • ctags: 84
  • sloc: perl: 3,111; makefile: 2
file content (65 lines) | stat: -rwxr-xr-x 1,354 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
package Rose::Class;

use strict;

our $VERSION = '0.81';

use Rose::Class::MakeMethods::Generic
(
  scalar => 'error',
);

1;

__END__

=head1 NAME

Rose::Class - A very simple class base class.

=head1 SYNOPSIS

    package MyClass;

    use Rose::Class;
    our @ISA = qw(Rose::Class);

    sub foo { ... }
    ...

    MyClass->foo(...) or die MyClass->error;
    ...

=head1 DESCRIPTION

L<Rose::Class> is a generic base class for classes.  It provides a
single class method (C<error>), but may be expanded further in the
future.

A class that inherits from L<Rose::Class> is not expected to allow
objects of that class to be instantiated, since the namespace for class
and object methods is shared.  For example, it is common for
L<Rose::Object>-derived classes to have C<error> methods, but this would
conflict with the L<Rose::Class> method of the same name.

=head1 CLASS METHODS

=over 4

=item B<error [ERROR]>

Get or set the class-wide error.  By convention, this should be a scalar
that stringifies to an error message.  A simple scalar containing a
string is the most commonly used value.

=back

=head1 AUTHOR

John C. Siracusa (siracusa@gmail.com)

=head1 LICENSE

Copyright (c) 2006 by John C. Siracusa.  All rights reserved.  This program is
free software; you can redistribute it and/or modify it under the same terms
as Perl itself.