AcornSearch - Acorn and RISC OS information searching
RISC OS Search
containing
"Nutty quip goes here!"
Home  |  About  |  Filebase Archive  |  StrongHelp Manuals  |  Newsgroups  |  Module Database
=>     R0 =     37 (Canonicalise path)
     R1 =     pointer to pathname to convert
     R2 =     pointer to buffer
     R3 =     pointer to name of path variable, or 0 for none
     R4 =     pointer to ctrl-terminated comma seperated path string, or 0 for none
     R5 =     buffer size
<=     R5 =     number of spare bytes in buffer (inc. term)

This call takes a filename (which may contain wildcards) and converts it into a complete pathname, including disc and directory name when not provided.

Example:     fred may convert to SCSI::Gamma.$.Utils.Fred

Note:     If you call once with R2 and R5 set to zero, R5 will minus the return the number of bytes needed. Now you can call again having allocated -R5 bytes from somewhere.

[sh-index] Back to list of manuals