Unit 'System' Package
[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] [#rtl]

ParamStr

Return value of a command-line argument.

Declaration

Source position: systemh.inc line 1711

function ParamStr(

  l: LongInt

):shortstring;

Description

Paramstr returns the L-th command-line argument. L must be between 0 and Paramcount, these values included. The zeroth argument is the path and file name with which the program was started.

The command-line parameters will be truncated to a length of 255, even though the operating system may support bigger command-lines. The Objpas unit (used in objfpc or delphi mode) defines versions of Paramstr which return the full-length command-line arguments, using ansistrings.

In the interest of portability, the ParamStr function tries to behave the same on all operating systems: like the original ParamStr function in Turbo Pascal. This means even on Unix, paramstr(0) returns the full path to the program executable. A notable exception is Mac OS X, where the returned value depends on how the application was started. It may be that just the name of the application is returned (in case of a command-line launch), so it is best to avoid using it on that platform.

In general, it's a bad idea to rely on the location of the binary. Often, this goes against best OS practices. Configuration data should (or can) not be stored next to the binary, but on designated locations. What locations these are, is very much operating system dependent. Therefore, ParamStr(0) should be used with care.

For an example, see Paramcount.

Errors

None.

See also

Paramcount

  

Return number of command-line parameters passed to the program.


Documentation generated on: Oct 02 2024