--------------------
is_secure() FUNCTION
--------------------

  ------------
  USAGE FORMAT
  ------------

    Where $rv is the numeric return value:

    $rv = is_secure();

  -----------
  DESCRIPTION
  -----------

    Returns whether or not a secure HTTPS connection is in use based on whether
    or not the Apache defined 'HTTPS' value is defined.

  ---------
  ARGUMENTS
  ---------

    NONE

  -------
  RETURNS
  -------

    1 if https:// is used
    0 if https:// is not used

  --------------
  USAGE EXAMPLES
  --------------

    ------------------------------------------------------------
    Example 1: Return Whether or Not This is a Secure Connection
    ------------------------------------------------------------

      You are <?= (&is_secure() ? '' : 'not') ?> on a secure connection.

  --------
  SEE ALSO
  --------

    TAGS

      DISPLAY

    VARIABLES

      $_URL, $_BASE