The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Lucy::Search::Span - An offset, a length, and a weight.

SYNOPSIS

    my $combined_length = $upper_span->get_length
        + ( $upper_span->get_offset - $lower_span->get_offset );
    my $combined_span = Lucy::Search::Span->new(
        offset => $lower_span->get_offset,
        length => $combined_length,
    );
    ...

DESCRIPTION

Span objects store information about a span across an array of… something. The unit is context-dependent.

Text is one possibility, in which case offset and length might be measured in Unicode code points. However, the Span could also refer to a span within an array of tokens, for example – in which case the start and offset might be measured in token positions.

CONSTRUCTORS

new

    my $span = Lucy::Search::Span->new(
        offset => 75,     # required
        length => 7,      # required
        weight => 1.0,    # default 0.0
    );

Create a new Span.

  • offset - Integer offset, unit is context-dependent.

  • length - Integer length, unit is context-dependent.

  • weight - A floating point weight.

METHODS

get_offset

    my $int = $span->get_offset();

Accessor for offset attribute.

set_offset

    $span->set_offset($offset);

Setter for offset attribute.

get_length

    my $int = $span->get_length();

Accessor for length attribute.

set_length

    $span->set_length($length);

Setter for length attribute.

get_weight

    my $float = $span->get_weight();

Accessor for weight attribute.

set_weight

    $span->set_weight($weight);

Setter for weight attribute.

compare_to

    my $int = $span->compare_to($other);

Indicate whether one object is less than, equal to, or greater than another.

  • other - Another Obj.

Returns: 0 if the objects are equal, a negative number if self is less than other, and a positive number if self is greater than other.

INHERITANCE

Lucy::Search::Span isa Clownfish::Obj.