data

### Index Up << >>

## data

CALL INFORMATION
  Parameters: table field key

  Positional parameters in same order.

  The attribute hash reference is passed to the subroutine after the parameters as the last argument. This may mean that there are parameters not shown here.

  Must pass named parameter interpolate=1 to cause interpolation.

  Invalidates cache: no

  Called Routine:

  ASP/perl tag calls:

          $Tag->data(
              {
               table => VALUE,
               field => VALUE,
               key => VALUE,
              }
          )

       OR

          $Tag->data($table, $field, $key, $ATTRHASH);

  Attribute aliases

                  base ==> table
                  code ==> key
                  col ==> field
                  column ==> field
                  database ==> table
                  name ==> field
                  row ==> key

DESCRIPTION
  Syntax: [data table=db_table column=column_name key=key filter=``uc|lc|name|namecase|no_white|etc.''* append=1* value=``value to set to''* increment=1* ]

  Returns the value of the field in a database table, or (DEPRECATED) from the session namespace. If the optional value is supplied, the entry will be changed to that value. If the option increment* is present, the field will be atomically incremented with the value in value. Use negative numbers in value to decrement. The `append` attribute causes the value to be appended; and finally, the `filter` attribute is a set of MiniVend filters that are applied to the data 1) after it is read; or 2)before it is placed in the table.

  If a DBM-based database is to be modified, it must be flagged writable on the page calling the write tag. Use [tag flag write]products[/tag] to mark the `products` database writable, for example. This must be done before ANY access to that table.

  DEPRECATED BEHAVIOR: (replace with session tag). In addition, the [data ...] tag can access a number of elements in the MiniVend session database:

          accesses           Accesses within the last 30 seconds
          arg                The argument passed in a [page ...] or [area ...] tag
          browser            The user browser string
          cybercash_error    Error from last CyberCash operation
          cybercash_result   Hash of results from CyberCash (access with usertag)
          host               MiniVend's idea of the host (modified by DomainTail)
          last_error         The last error from the error logging
          last_url           The current MiniVend path_info
          logged_in          Whether the user is logged in (add-on UserDB feature)
          pageCount          Number of unique URLs generated
          prev_url           The previous path_info
          referer            HTTP_REFERER string
          ship_message       The last error messages from shipping
          source             Source of original entry to MiniVend
          time               Time (seconds since Jan 1, 1970) of last access
          user               The REMOTE_USER string
          username           User name logged in as (UserDB feature)

  NOTE: Databases will hide session values, so don't name a database ``session''. or you won't be able to use the [data ...] tag to read them. Case is sensitive, so in a pinch you could call the database ``Session'', but it would be better not to use that name at all.

### Index Up << >>