Name
funcparams — Parameters for a function referenced through a function pointer in a synopsis
Synopsis
funcparams ::=
(text | phrase
db._phrase | replaceable
| Graphic inlines | Indexing inlines | Linking inlines | Ubiquitous inlines)*
Attribute synopsis
Description
In some programming languages (such as C), it is possible for a
function to have a pointer to another function as one of its parameters.
In the syntax summary for such a function, the
funcparams
element provides a wrapper for the
function pointer.
For example, the following prototype describes the function
sort
, which takes two parameters. The first
parameter, arr
, is an array of integers. The
second parameter is a pointer to a function, comp
,
that returns an int. The comp
function
takes two parameters, both of type int *:
<funcprototype> <funcdef>void <function>sort</function></funcdef> <paramdef>int *<parameter>arr</parameter>[]</paramdef> <paramdef>int <parameter>(* comp)</parameter> <funcparams>int *, int *</funcparams></paramdef> </funcprototype>
Processing expectations
Formatted inline. For a complete description of the processing
expectations, see funcsynopsis
.
See Also
funcdef
, funcprototype
, funcsynopsisinfo
, function
, paramdef
, parameter
, returnvalue
, varargs
, void
Examples
<article xmlns='http://docbook.org/ns/docbook'> <title>Example funcparams</title> <funcsynopsis> <funcprototype> <funcdef>void <function>qsort</function></funcdef> <paramdef>void *<parameter>dataptr</parameter>[]</paramdef> ...
Get DocBook 5: The Definitive Guide now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.