
{{alias}}( [options] )
    Returns State of the Union (SOTU) addresses.

    Each State of the Union address is represented by an object with the
    following fields:

    - year: speech year
    - name: President name
    - party: the President's political party
    - text: speech text

    The following political parties are recognized:

    - Democratic
    - Republican
    - Democratic-Republican
    - Federalist
    - National Union
    - Whig
    - Whig & Democratic
    - none

    Parameters
    ----------
    options: Object (optional)
        Function options.

    options.name: String|Array<string> (optional)
        President name(s).

    options.party: String|Array<string> (optional)
        Political party (or parties).

    options.year: integer|Array<integer> (optional)
        Year(s).

    options.range: Array<integer> (optional)
        Two-element array specifying a year range.

    Returns
    -------
    out: Array<Object>
        State of the Union addresses.

    Examples
    --------
    > var out = {{alias}}()
    [ {...}, {...}, ... ]

    // Retrieve addresses by one or more Presidents...
    > var opts = { 'name': 'Barack Obama' };
    > out = {{alias}}( opts )
    [ {...}, {...}, ... ]

    // Retrieve addresses by one or more political parties...
    > opts = { 'party': [ 'Democratic', 'Federalist' ] };
    > out = {{alias}}( opts )
    [ {...}, {...}, ... ]

    // Retrieve addresses from one or more years...
    > opts = { 'year': [ 2008, 2009, 2011 ] };
    > out = {{alias}}( opts )
    [ {...}, {...}, {...} ]

    // Retrieve addresses from a range of consecutive years...
    > opts = { 'range': [ 2008, 2016 ] }
    > out = {{alias}}( opts )
    [ {...}, {...}, ... ]

    See Also
    --------

