package Torello.HTML.Tools.Images;

import Torello.HTML.HTMLNode;
import java.util.Vector;
import java.util.function.Function;

/**
 * A functional-interface for returning the portion of the page that contains the list of
 * images on the site - usually one line from the Node-Search Package classes.
 * 
 * <BR /><BR />Should retrieve a sub-portion or sub-section of an HTML Page.  This interface
 * inherits Java's Simple {@code Function<T, U>} - where {@code 'T'} and {@code 'U'} are both of
 * type {@code Vector<HTMLNode>}.  In the Java-HTML JAR Library, a variable of type 
 * {@code Vector<HTMLNode>} is usually refered to as a <B>Vectorized-HTML</B>.
 * 
 * <BR /><BR />The lamda-target method is simply named {@code 'apply'}, and accepts a single
 * Vectorized-HTML parameter.  This method should then extract a sub-section of that web-page
 * which contains photos or pictures so that they may be downloaded and extracted.  This extracted
 * section should be returned from the lambda-target method.
 */
@FunctionalInterface
public interface SectionGet extends Function<Vector<HTMLNode>, Vector<HTMLNode>>
{
    /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUIDFI>  */
    public static final long serialVersionUID = 1;
}