home *** CD-ROM | disk | FTP | other *** search
/ Falcon 030 Power 2 / F030_POWER2.iso / ST_STE / MAGS / ICTARI09.ARJ / ictari.09 / ASSEMBLY / COOKFIND / G_COOKIE.DOC < prev    next >
Text File  |  1994-04-14  |  1KB  |  27 lines
  1. SUB-ROUTINE NAME        Get_cookie
  2. BRIEF DESCRIPTION       Search cookie jar (if it exists) for name in d0.l
  3. FILENAME                G_COOKIE
  4. OTHER RESOURCES         None
  5. LANGUAGE                Assembler (Devpac)
  6. AUTHOR                  Simon.H.Rigby - aka PoshPaws - aka Si(gh)
  7. ENTRY PARAMETERS        D0 = Cookie Name (e.g. #"_SND")
  8. EXIT PARAMETERS         D0 = 0 if successful, -1 if not
  9.                         D1 = Value of cookie (or 0.l if not found)
  10.  
  11. DETAILS -
  12.         Searches the cookie jar (if it  exists)  for the four letter name
  13. given in d0.l. If it finds it, it returns the value of that cookie in d1.l,
  14. otherwise it returns -1 in d0 and zero in d1.
  15.         
  16. See Cookie.txt for more information on cookies and known values.
  17.  
  18. Example - Library
  19.                 move.l  #"_SND",d0
  20.                 bsr     Get_cookie
  21.                 tst.w   d0              ;0 if O.K.
  22.                 bne     cookie_fail
  23.                 ...
  24.                 ...                     ;cookie value in d1.l
  25.                 ...
  26. cookie_fail     ;default to basics - no cookie found
  27.