home *** CD-ROM | disk | FTP | other *** search
/ Carousel / CAROUSEL.cdr / mactosh / hc / x_tools1.sit / X-Tools1.1 / card_10564.txt < prev    next >
Text File  |  1988-01-27  |  1KB  |  51 lines
  1. -- card: 10564 from stack: in.1
  2. -- bmap block id: 0
  3. -- flags: 0000
  4. -- background id: 3468
  5. -- name: 
  6.  
  7.  
  8. -- part contents for background part 1
  9. ----- text -----
  10.  
  11. This renames a file, keeping it in the same folder (or at the root of the volume).
  12. "filename" is a full pathname, and "newName" is a replacement for the last component of that path. 
  13. ----
  14. example:
  15.  
  16.       put RenameFile("HD:Telecom:capture","session") into err
  17.  
  18. This will produce a file called "HD:Telecom:session" if it succeeds. A value of 0 is returned on success, a negative number for an Operating System error, and 1 for a parameter error. 
  19.  
  20. Error Codes:
  21.   > 0  "Parameter error with function" 
  22.  -59  "Problem during rename" 
  23.  -54  "Attempt to open locked file for writing" 
  24.  -46  "Volume locked by software"
  25.  -45  "File locked" 
  26.  -44  "Volume locked by hardware"
  27.  -43  "File not found" 
  28.  -37  "Bad volume or file name" 
  29.  -36  "I/O error" 
  30.  -35  "No such volume" 
  31.  -34  "Disk is full"
  32.  -49  "File already open for writing" 
  33.   
  34.  
  35. -- part contents for background part 9
  36. ----- text -----
  37. XFCN
  38.  
  39. -- part contents for background part 2
  40. ----- text -----
  41. RenameFile
  42.  
  43. -- part contents for background part 4
  44. ----- text -----
  45.  
  46.  RenameFile(<filename>,<newName>)
  47.  
  48.  
  49. -- part contents for background part 8
  50. ----- text -----
  51. Dewi Williams