Data::CTable::Listing - CTable holding file and directory listings


        ## Call from a shell script:
        use      Data::CTable::Listing;
        exit    !Data::CTable::Listing->script();

This is an OO implementation of the guts of the "tls" perl script that comes with the Data::CTable distribution.

Please see for the full usage() message, or run the tls perl script with the --help option.


See the Data::CTable home page:


Chris Thorman <>

Copyright (c) 1995-2002 Chris Thorman. All rights reserved.

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



Main entry point for the "tls" or "" script included with the Data::CTable distribution.


Instantiates a table object, gets and inserts file listing and other fields, processes user's arguments, and generates output.


Generates the file listing by interpreting the file-related command-line options.


Parses and processes the sorting, fieldlist, and output options, then calls the appropriate output method. Returns the scalar buffer reference returned by that method, if any; otherwise a ref to an empty buffer.

        ## Class-level utility method
        $Class->list_dir($Path, $Sep, $Cur, $Recurse, $NoTop, $NoChildren)

Platform-neutral recursive directory lister routine.

Caller must supply $Sep (platform's separator character) and $Cur (platform's string meaning "current directory").

If $Dir is empty/undef, then $Cur will be used as the starting point.

$Recurse means recurse to list subdirectories.

$NoTop means don't include $Dir itself in the listing.

$NoChildren means don't include children of $Dir. This option is ignored if $Recurse is true.