Using ReadArgs() from asm

[oRBIT]

I was checking out dos/ReadArgs() but came to the conclusion that I don't understand much of the parameters it would require.
My program expects just a single parameter which should be a filename (incl path, if that matters). What should I provide in the template-parameter that ReadArgs() requires?

Thanks in advance

[thomas]

	move.l	#template,d1
	move.l	#filename,d2
	moveq	#0,d3
	move.l	DOSBase,a6
	jsr	-798(a6)


template:
	dc.b	"FILE/A",0
filename:
	dc.l	0

The result in D0 is a pointer which you have to pass to FreeArgs when you are done. If D0 is 0, something went wrong and IoErr() will return the reason (which you can then pass to PrintFault() to inform the user). If D0 is non-zero, the longword at filename is filled with a pointer to the file name.

What should I provide in the template-parameter that ReadArgs() requires?

The template is what you would expect when you enter commandname ? in a shell window. It has to follow certain syntax rules which are described in the autodocs.

My program expects just a single parameter which should be a filename (incl path, if that matters).

You'll get what the user enters. If you need an absolute path, you have to determine it yourself (for example with NameFromLock).

[oRBIT]

Cool, thanks alot, will try that.. By the way, how did you know about "FILE/A"? What's FILE in this context? Just a name? Or some kind of parametername?

[StingRay]

FILE is the filename and /A means that it is required, i.e. no filename given -> error.

Here's an example from one of my tools:

TEMPLATE	dc.b	"DISKFILE/A,DIR,WP=WRITEPITCHES/S,SPLIT/S,SH=SAVEHEADER/S",0

Might make it a bit more clear. DISKFILE is a filename for a diskimage and the only parameter that is required, WP,S and SH are optional switches (thus the /S).

[thomas]

Originally Posted by oRBIT

Cool, thanks alot, will try that.. By the way, how did you know about "FILE/A"? What's FILE in this context? Just a name? Or some kind of parametername?

I've edited my first post. Please also read the autodocs. FILE is just a name you can specify. It's also a keyword the user can enter to rearrange the arguments (if you had more than one). "/A" means the argument is required.