Ubuntu.Components.Arguments

The Arguments class provides a way to declare what command line parameters are expected by the application. More...

Properties

• arguments : list<Argument>
• defaultArgument : Argument
• error : bool
• errorMessage : string
• values : Object

Methods

• void printUsage()
• void quitWithError(string errorMessage)

Detailed Description

Example of use:

Arguments {
id: args
defaultArgument.help: "Expects URL of the media to play."
defaultArgument.valueNames: ["URL"]
Argument {
name: "fullscreen"
help: "whether or not the media will be played fullscreen"
required: false
}
Argument {
name: "volume"
help: "level to which to set the volume"
required: false
valueNames: ["VOLUME_LEVEL"]
}
}

The code above ensures that at least one argument is passed on the command line which will then be available in QML via the defaultArgument property. Optionally two other arguments can be passed:

--fullscreen that will be exposed as a boolean property: values.fullscreen

--volume that will be exposed as a string property: values.volume

Item {
Label {
text: "volume = " + args.values.volume
}
Label {
text: "fullscreen = " + args.values.fullscreen
}
Label {
text: "URL = " + args.defaultArgument.at(0)
}
}

If the application is launched with the incorrect arguments or with the --usage argument an help will be outputted on the command line and the application will exit:

Usage: application [--fullscreen] [--volume=VOLUME_LEVEL] URL
Options:
--fullscreen         whether or not the media will be played fullscreen
--volume=VOLUME_LEVE level to which to set the volume
Expects URL of the media to play.

See also Argument.

Property Documentation

List of command line arguments that are expected by the application.

See detailed description above for an example on how to use it.

The default argument corresponds to the values passed on the command line without any name.

For example in:

./application --volume=42 http://myaddress

http://myaddress is the first value of the default argument.

Whether or not the command line arguments passed to the application correspond to the expected arguments.

Also set when calling quitWithError

Error message describing how the command line arguments passed to the application failed to correspond to the expected arguments.

Also set when calling quitWithError

Object of which properties have the values of the command line arguments.

Method Documentation

Outputs help to the console on how to pass arguments to the application.

Exits the application outputting errorMessage to the console.