package Org::Element::Table; use 5.010; use locale; use Log::ger; use Moo; extends 'Org::Element'; with 'Org::ElementRole'; with 'Org::ElementRole::Block'; our $AUTHORITY = 'cpan:PERLANCAR'; # AUTHORITY our $DATE = '2023-11-06'; # DATE our $DIST = 'Org-Parser'; # DIST our $VERSION = '0.561'; # VERSION has _dummy => (is => 'rw'); # workaround Moo bug sub BUILD { require Org::Element::TableRow; require Org::Element::TableHLine; require Org::Element::TableCell; my ($self, $args) = @_; my $pass = $args->{pass} // 1; # parse _str into rows & cells my $_str = $args->{_str}; if (defined $_str && !defined($self->children)) { if (!defined($self->_str_include_children)) { $self->_str_include_children(1); } my $doc = $self->document; my @rows0 = split /\R/, $_str; $self->children([]); for my $row0 (@rows0) { log_trace("table line: %s", $row0); next unless $row0 =~ /\S/; my $row; if ($row0 =~ /^\s*\|--+(?:\+--+)*\|?\s*$/) { $row = Org::Element::TableHLine->new(parent => $self); } elsif ($row0 =~ /^\s*\|\s*(.+?)\s*\|?\s*$/) { my $s = $1; $row = Org::Element::TableRow->new( parent => $self, children=>[]); for my $cell0 (split /\s*\|\s*/, $s) { my $cell = Org::Element::TableCell->new( parent => $row, children=>[]); $doc->_add_text($cell0, $cell, $pass); push @{ $row->children }, $cell; } } else { $self->die("Invalid line in table: $row0"); } push @{$self->children}, $row; } } } sub rows { my ($self) = @_; return [] unless $self->children; my $rows = []; for my $el (@{$self->children}) { push @$rows, $el if $el->isa('Org::Element::TableRow'); } $rows; } sub row_count { my ($self) = @_; return 0 unless $self->children; my $n = 0; for my $el (@{$self->children}) { $n++ if $el->isa('Org::Element::TableRow'); } $n; } sub column_count { my ($self) = @_; return 0 unless $self->children; # get first row my $row; for my $el (@{$self->children}) { if ($el->isa('Org::Element::TableRow')) { $row = $el; last; } } return 0 unless $row; # table doesn't have any row my $n = 0; for my $el (@{$row->children}) { $n++ if $el->isa('Org::Element::TableCell'); } $n; } sub as_aoa { my ($self) = @_; return [] unless $self->children; my @rows; for my $row (@{$self->children}) { next unless $row->isa('Org::Element::TableRow'); push @rows, $row->as_array; } \@rows; } 1; # ABSTRACT: Represent Org table __END__ =pod =encoding UTF-8 =head1 NAME Org::Element::Table - Represent Org table =head1 VERSION This document describes version 0.561 of Org::Element::Table (from Perl distribution Org-Parser), released on 2023-11-06. =head1 DESCRIPTION Derived from L. Must have L or L instances as its children. =for Pod::Coverage BUILD =head1 ATTRIBUTES =head1 METHODS =head2 $table->rows() => ELEMENTS Return the rows of the table. =head2 $table->as_aoa() => ARRAY Return the rows of the table, each row already an arrayref of cells produced using as_array() method. Horizontal lines will be skipped/ignored. =head2 $table->row_count() => INT Return the number of rows that the table has. =head2 $table->column_count() => INT Return the number of columns that the table has. It is counted from the first row. =head1 HOMEPAGE Please visit the project's homepage at L. =head1 SOURCE Source repository is at L. =head1 AUTHOR perlancar =head1 CONTRIBUTING To contribute, you can send patches by email/via RT, or send pull requests on GitHub. Most of the time, you don't need to build the distribution yourself. You can simply modify the code, then test via: % prove -l If you want to build the distribution (e.g. to try to install it locally on your system), you can install L, L, L, and sometimes one or two other Dist::Zilla- and/or Pod::Weaver plugins. Any additional steps required beyond that are considered a bug and can be reported to me. =head1 COPYRIGHT AND LICENSE This software is copyright (c) 2023, 2022, 2021, 2020, 2019, 2017, 2016, 2015, 2014, 2013, 2012, 2011 by perlancar . This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. =head1 BUGS Please report any bugs or feature requests on the bugtracker website L When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature. =cut