CGI::Listman::line - the internal representation of a database row
use CGI::Listman::line;
A CGI::Listman::line represents a row of database stored in a way that permits CGI::Listman and the developer to easily manage some aspects of it. For example, it also contains data on when the row was created, if it was exported through a CGI::Listman::exporter, if it was listed or displayed in some way within a web interface.
The order in which the fields are specified or used should be the same throughout the use of the same instance of CGI::Listman.
This method is to instantiate a CGI::Listman::line. It optionnally takes an array ref as argument which will be the database row this instance will represent in the framework of CGI::Listman.
The parameter "data" is optional with this method.
A reference to an ARRAY representing a database record. This parameter is optional.
This method returns a blessed reference to a CGI::Listman::line.
This method should be called whenever the line is considered as being displayed on a user interface.
This method takes no parameter.
This method returns nothing.
This method is called internally by CGI::Listman whenever the line is added to an instance of CGI::Listman::exporter. It should not otherwise be used directly by the developer, except when using its own implementation of an exporter, but please choose to extend the CGI::Listman::exporter API instead.
This method takes no parameter.
This method returns nothing.
This method returns the integer representing its position in the database table. This number will be assigned only if the instance get added to a CGI::Listman, otherwise it will stay at 0.
This method takes no parameter.
An integer representing the position of this line.
This will set the actual data row of this instance if not previously set by new or this method.
A reference to an ARRAY representing a database record.
This method returns nothing.
Since set_fields can only be called once and updating a row requires some internal handling, you need to use this method whenever you update a line's data.
A reference to an ARRAY representing a database record.
This method returns nothing.
Use this method whenever you want to access the data encapsulated within this object. Be careful to not modify the resulting fields unless you want to do so since it returns the actual data and not a copy.
This method takes no parameter.
A reference to an ARRAY representing the instance of CGI::Listman::line.
Wolfgang Sourdeau, <Wolfgang@Contre.COM>
Copyright (C) 2002 iScream multimédia <info@iScream.ca>
This package is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
