☺唐鳳☻
and 1 contributors
    * tests

    * compare

    * set_start_open / set_start_closed
    * set_end_open / set_end_closed
        - better names ?

    * set_density 

    * is_singleton

    * spans - return List of Span

    * "backtracking" - see Perl5 version

    * first_span/last_span

From "Set" API:

    * equal/not_equal
    * symmetric_difference
    * proper_subset
    * proper_superset
    * subset
    * superset
    * includes/member/has
    * unicode

= NAME

Span::Set - An object representing an ordered set of spans

= SYNOPSIS

  use Set::Infinite;

  # XXX

= DESCRIPTION

This class represents an ordered set of spans.

= CONSTRUCTORS

- `new()`

Without any parameters, returns an empty span.

- `new( objects => ( 1, 2, 3 ) )`

Creates a span with a single element. This is the same as `new( start => $object, end => $object )`.

- `new( spans => $span )`

Creates a `Set::Infinite` object using an existing span.

- `new( :int, spans => $int_span )`

Creates a set with "integer" semantics.

The default is "real number" semantics (density = undef).

- `new( spans => $day_span, :density($day_duration) )`

Creates a set with "day" semantics.

= OBJECT METHODS

    # XXX

The following methods are available for Span objects:

- `start()` / `end()`

Return the start or end value of the span.

These methods may return nothing if the span is empty.

- `set_start( $object )` / `set_end( $object )`

Change the start or end value of the span.

These methods may raise a warning if the new value would put the span in an invalid state, such as `start` bigger than `end` (the span is emptied in this case).

- `start_is_open()` / `end_is_open()` / `start_is_closed()` / `end_is_closed()`

Return a logical value, whether the `start` or `end` values belong to the span ("closed") or not ("open").

- size

Return the "size" of the span.

For example: if `start` and `end` are times, then `size` will be a duration.

- `contains( Object )` / `intersects( Object )`

These methods return a logical value.

- union

  # XXX

- complement

  # XXX

- intersects

  # XXX

- intersection

  # XXX

- stringify

  # XXX

- compare

  # XXX

- is_empty()

- `spans`

Returns a list of `Span` objects.

= AUTHOR

Flavio S. Glock, <fglock@pucrs.br>

= COPYRIGHT

Copyright (c) 2005, Flavio S. Glock. All rights reserved.

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

1 POD Error

The following errors were encountered while parsing the POD:

Around line 221:

Unknown directive: =kwid