/ 
CSS-Struct-Output-Structure-0.04
River stage two • 20 direct dependents • 33 total dependents
/ CSS::Struct::Output::Structure

NAME

CSS::Struct::Output::Structure - Structure class for 'CSS::Struct' output.

SYNOPSIS

use CSS::Struct::Output::Structure;

my $css = CSS::Struct::Output::Structure->new(%parameters);
my $ret_or_undef = $css->flush($reset_flag);
$css->put(@data);
$css->reset;

METHODS

new

my $css = CSS::Struct::Output::Structure->new(%parameters);

Constructor.

Returns instance of object.

  • auto_flush

    Auto flush flag.
Default is 0.

  • output_handler

    Handler for print output strings.
Must be a GLOB.
Default is undef.

  • skip_bad_types

    Flag, that means bad 'CSS::Struct' types skipping.
Default value is 0.

flush

my $ret_or_undef = $css->flush($reset_flag);

Flush CSS structure in object. If defined 'output_handler' flush to its as structure string. Or return CSS structure as array. If enabled $reset_flag, then resets internal variables via reset method.

Returns output string or undef.

put(@data)

$css->put(@data);

Put CSS structure in format specified in CSS::Struct.

Returns undef.

reset

$css->reset;

Resets internal variables.

Returns undef.

ERRORS

From CSS::Struct::Output:
        Auto-flush can't use without output handler.
        Bad comment delimeters.
        Bad data.
        Bad number of arguments.
                ('CSS::Struct' structure array),
        Bad type of data.
        Cannot write to output handler.
        No opened selector.
        Output handler is bad file handler.
        Unknown parameter '%s'.

EXAMPLE1

use strict;
use warnings;

use CSS::Struct::Output::Structure;
use Data::Printer;

my $css = CSS::Struct::Output::Structure->new;

# Set structure.
$css->put(['c', 'Comment']);
$css->put(['a', '@charset', 'utf-8']);
$css->put(['s', 'selector#id']);
$css->put(['s', 'div div']);
$css->put(['s', '.class']);
$css->put(['d', 'weight', '100px']);
$css->put(['d', 'font-size', '10em']);
$css->put(['e']);

# Get structure.
my $css_struct_ar = $css->flush;

# Dump out.
p $css_struct_ar;

# Output:
# \ [
#     [0] [
#         [0], "c",
#         [1], "comment"
#     ],
#     [1] [
#         [0] "a",
#         [1] "@charset",
#         [2] "utf-8"
#     ],
#     [2] [
#         [0] "s",
#         [1] "selector#id"
#     ],
#     [3] [
#         [0] "s",
#         [1] "div div"
#     ],
#     [4] [
#         [0] "s",
#         [1] ".class"
#     ],
#     [5] [
#         [0] "d",
#         [1] "weight",
#         [2] "100px"
#     ],
#     [6] [
#         [0] "d",
#         [1] "font-size",
#         [2] "10em"
#     ],
#     [7] [
#         [0] "e"
#     ]
# ]

EXAMPLE2

use strict;
use warnings;

use CSS::Struct::Output::Structure;
use Data::Printer;

my $css = CSS::Struct::Output::Structure->new(
       'output_handler' => \*STDOUT,
);

# Set structure.
$css->put(['c', 'Comment']);
$css->put(['a', 'charset', 'utf-8']);
$css->put(['s', 'selector#id']);
$css->put(['s', 'div div']);
$css->put(['s', '.class']);
$css->put(['d', 'weight', '100px']);
$css->put(['d', 'font-size', '10em']);
$css->put(['e']);

# Get structure.
$css->flush;

# Output:
# ['c', 'comment']
# ['a', 'charset', 'utf-8']
# ['s', 'selector#id']
# ['s', 'div div']
# ['s', '.class']
# ['d', 'weight', '100px']
# ['d', 'font-size', '10em']
# ['e']

DEPENDENCIES

CSS::Struct::Output, Error::Pure.

SEE ALSO

CSS::Struct

Struct oriented CSS manipulation.

CSS::Struct::Output

Base class for CSS::Struct::Output::*.

CSS::Struct::Output::Indent

Indent printing 'CSS::Struct' structure to CSS code.

CSS::Struct::Output::Raw

Raw printing 'CSS::Struct' structure to CSS code.

REPOSITORY

https://github.com/michal-josef-spacek/CSS-Struct-Output-Structure

AUTHOR

Michal Josef Špaček mailto:skim@cpan.org

http://skim.cz

LICENSE AND COPYRIGHT

© 2021-2023 Michal Josef Špaček

BSD 2-Clause License

VERSION

0.04