Sponsoring The Perl Toolchain Summit 2025: Help make this important event another success Learn more

 / 
Lucy-0.6.2
River stage two • 13 direct dependents • 20 total dependents
/ Lucy::Search::Span

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.