NAME
    push - push a value into the front of a list

SYNOPSIS
    push(lst, val)

TYPES
    lst		list, &list
    val		any, &any

    return	any

DESCRIPTION
     This function inserts the value val onto list lst before index 0.

     This function is equivalent to calling insert(lst, 0, val).

EXAMPLE
    > lst = list(2,"three")

    list (2 elements, 2 nonzero):
      [[0]] = 2
      [[1]] = "three"

    > push(lst, 4i)
    > print lst

    list (3 elements, 3 nonzero):
      [[0]] = 4i
      [[1]] = 2
      [[2]] = "three"

LIMITS
    none

LIBRARY
    none

SEE ALSO
    append, delete, insert, islist, list, pop, remove, rsearch, search, size
