- publishing free software manuals
GNU Octave Manual Version 3
by John W. Eaton, David Bateman, Søren Hauberg
Paperback (6"x9"), 568 pages
ISBN 095461206X
RRP £24.95 ($39.95)

Get a printed copy>>>

1.3.5.1 A Sample Function Description

In a function description, the name of the function being described appears first. It is followed on the same line by a list of parameters. The names used for the parameters are also used in the body of the description.

Here is a description of an imaginary function foo:

Function: foo (x, y, ...)
The function foo subtracts x from y, then adds the remaining arguments to the result. If y is not supplied, then the number 19 is used by default.

foo (1, [3, 5], 3, 9)
     => [ 14, 16 ]
foo (5)
     => 14

More generally,

foo (w, x, y, ...)
==
x - w + y + ...

Any parameter whose name contains the name of a type (e.g. integer, integer1 or matrix) is expected to be of that type. Parameters named object may be of any type. Parameters with other sorts of names (e.g. new_file) are discussed specifically in the description of the function. In some sections, features common to parameters of several functions are described at the beginning.

Functions in Octave may be defined in several different ways. The category name for functions may include another name that indicates the way that the function is defined. These additional tags include

Function File
The function described is defined using Octave commands stored in a text file. See section 11.7 Function Files.
Built-in Function
The function described is written in a language like C++, C, or Fortran, and is part of the compiled Octave binary.
Loadable Function
The function described is written in a language like C++, C, or Fortran. On systems that support dynamic linking of user-supplied functions, it may be automatically linked while Octave is running, but only if it is needed.
Mapping Function
The function described works element-by-element for matrix and vector arguments.
ISBN 095461206XGNU Octave Manual Version 3See the print edition