</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h2><a name="Contents" href="#Contents">Contents</a></h2>
<ul>
<li><a href="#Foreword">Foreword</a>
<!--page 9 -->
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h2><a name="Foreword" href="#Foreword">Foreword</a></h2>
<p><!--para 1 -->
ISO (the International Organization for Standardization) and IEC (the International
also for information only.
<!--page 12 -->
+<p><small><a href="#Contents">Contents</a></small>
<h2><a name="Introduction" href="#Introduction">Introduction</a></h2>
<p><!--para 1 -->
With the introduction of new devices and extended character sets, new features may be
The library clause (clause 7) is based on the 1984 /usr/group Standard.
<!--page 13 -->
+<p><small><a href="#Contents">Contents</a></small>
<h1>Programming languages -- C</h1>
+<p><small><a href="#Contents">Contents</a></small>
<h2><a name="1" href="#1">1. Scope</a></h2>
<p><!--para 1 -->
This International Standard specifies the form and establishes the interpretation of
data-processing systems. It is intended for use by implementors and programmers.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h2><a name="2" href="#2">2. Normative references</a></h2>
<p><!--para 1 -->
The following normative documents contain provisions which, through reference in this
designated IEC 559:1989).
<!--page 15 -->
+<p><small><a href="#Contents">Contents</a></small>
<h2><a name="3" href="#3">3. Terms, definitions, and symbols</a></h2>
<p><!--para 1 -->
For the purposes of this International Standard, the following definitions apply. Other
Standard are to be interpreted according to ISO/IEC 2382-1. Mathematical symbols not
defined in this International Standard are to be interpreted according to ISO 31-11.
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="3.1" href="#3.1">3.1</a></h3>
<p><!--para 1 -->
<b> access</b><br>
NOTE 3 Expressions that are not evaluated do not access objects.
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="3.2" href="#3.2">3.2</a></h3>
<p><!--para 1 -->
<b> alignment</b><br>
requirement that objects of a particular type be located on storage boundaries with
addresses that are particular multiples of a byte address
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="3.3" href="#3.3">3.3</a></h3>
<p><!--para 1 -->
<b> argument</b><br>
expression, or a sequence of preprocessing tokens in the comma-separated list bounded
by the parentheses in a function-like macro invocation
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="3.4" href="#3.4">3.4</a></h3>
<p><!--para 1 -->
<b> behavior</b><br>
external appearance or action
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="3.4.1" href="#3.4.1">3.4.1</a></h4>
<p><!--para 1 -->
<b> implementation-defined behavior</b><br>
when a signed integer is shifted right.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="3.4.2" href="#3.4.2">3.4.2</a></h4>
<p><!--para 1 -->
<b> locale-specific behavior</b><br>
characters other than the 26 lowercase Latin letters.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="3.4.3" href="#3.4.3">3.4.3</a></h4>
<p><!--para 1 -->
<b> undefined behavior</b><br>
EXAMPLE An example of undefined behavior is the behavior on integer overflow.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="3.4.4" href="#3.4.4">3.4.4</a></h4>
<p><!--para 1 -->
<b> unspecified behavior</b><br>
evaluated.
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="3.5" href="#3.5">3.5</a></h3>
<p><!--para 1 -->
<b> bit</b><br>
NOTE It need not be possible to express the address of each individual bit of an object.
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="3.6" href="#3.6">3.6</a></h3>
<p><!--para 1 -->
<b> byte</b><br>
bit.
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="3.7" href="#3.7">3.7</a></h3>
<p><!--para 1 -->
<b> character</b><br>
<abstract> member of a set of elements used for the organization, control, or
representation of data
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="3.7.1" href="#3.7.1">3.7.1</a></h4>
<p><!--para 1 -->
<b> character</b><br>
<C> bit representation that fits in a byte
<!--page 17 -->
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="3.7.2" href="#3.7.2">3.7.2</a></h4>
<p><!--para 1 -->
<b> multibyte character</b><br>
NOTE The extended character set is a superset of the basic character set.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="3.7.3" href="#3.7.3">3.7.3</a></h4>
<p><!--para 1 -->
<b> wide character</b><br>
bit representation that fits in an object of type wchar_t, capable of representing any
character in the current locale
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="3.8" href="#3.8">3.8</a></h3>
<p><!--para 1 -->
<b> constraint</b><br>
restriction, either syntactic or semantic, by which the exposition of language elements is
to be interpreted
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="3.9" href="#3.9">3.9</a></h3>
<p><!--para 1 -->
<b> correctly rounded result</b><br>
representation in the result format that is nearest in value, subject to the current rounding
mode, to what the result would be given unlimited range and precision
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="3.10" href="#3.10">3.10</a></h3>
<p><!--para 1 -->
<b> diagnostic message</b><br>
message belonging to an implementation-defined subset of the implementation's message
output
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="3.11" href="#3.11">3.11</a></h3>
<p><!--para 1 -->
<b> forward reference</b><br>
reference to a later subclause of this International Standard that contains additional
information relevant to this subclause
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="3.12" href="#3.12">3.12</a></h3>
<p><!--para 1 -->
<b> implementation</b><br>
control options, that performs translation of programs for, and supports execution of
functions in, a particular execution environment
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="3.13" href="#3.13">3.13</a></h3>
<p><!--para 1 -->
<b> implementation limit</b><br>
restriction imposed upon programs by the implementation
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="3.14" href="#3.14">3.14</a></h3>
<p><!--para 1 -->
<b> object</b><br>
NOTE When referenced, an object may be interpreted as having a particular type; see <a href="#6.3.2.1">6.3.2.1</a>.
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="3.15" href="#3.15">3.15</a></h3>
<p><!--para 1 -->
<b> parameter</b><br>
entry to the function, or an identifier from the comma-separated list bounded by the
parentheses immediately following the macro name in a function-like macro definition
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="3.16" href="#3.16">3.16</a></h3>
<p><!--para 1 -->
<b> recommended practice</b><br>
specification that is strongly recommended as being in keeping with the intent of the
standard, but that may be impractical for some implementations
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="3.17" href="#3.17">3.17</a></h3>
<p><!--para 1 -->
<b> value</b><br>
precise meaning of the contents of an object when interpreted as having a specific type
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="3.17.1" href="#3.17.1">3.17.1</a></h4>
<p><!--para 1 -->
<b> implementation-defined value</b><br>
unspecified value where each implementation documents how the choice is made
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="3.17.2" href="#3.17.2">3.17.2</a></h4>
<p><!--para 1 -->
<b> indeterminate value</b><br>
either an unspecified value or a trap representation
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="3.17.3" href="#3.17.3">3.17.3</a></h4>
<p><!--para 1 -->
<b> unspecified value</b><br>
NOTE An unspecified value cannot be a trap representation.
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="3.18" href="#3.18">3.18</a></h3>
<p><!--para 1 -->
<b> [^ x ^]</b><br>
EXAMPLE [^2.4^] is 3, [^-2.4^] is -2.
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="3.19" href="#3.19">3.19</a></h3>
<p><!--para 1 -->
<b> [_ x _]</b><br>
EXAMPLE [_2.4_] is 2, [_-2.4_] is -3.
<!--page 19 -->
+<p><small><a href="#Contents">Contents</a></small>
<h2><a name="4" href="#4">4. Conformance</a></h2>
<p><!--para 1 -->
In this International Standard, ''shall'' is to be interpreted as a requirement on an
implementation.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h2><a name="5" href="#5">5. Environment</a></h2>
<p><!--para 1 -->
An implementation translates C source files and executes C programs in two data-
<p><b> Forward references</b>: In this clause, only a few of many possible forward references
have been noted.
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="5.1" href="#5.1">5.1 Conceptual models</a></h3>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="5.1.1" href="#5.1.1">5.1.1 Translation environment</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="5.1.1.1" href="#5.1.1.1">5.1.1.1 Program structure</a></h5>
<p><!--para 1 -->
A C program need not all be translated at the same time. The text of the program is kept
<p><b> Forward references</b>: linkages of identifiers (<a href="#6.2.2">6.2.2</a>), external definitions (<a href="#6.9">6.9</a>),
preprocessing directives (<a href="#6.10">6.10</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="5.1.1.2" href="#5.1.1.2">5.1.1.2 Translation phases</a></h5>
<p><!--para 1 -->
The precedence among the syntax rules of translation is specified by the following
character.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="5.1.1.3" href="#5.1.1.3">5.1.1.3 Diagnostics</a></h5>
<p><!--para 1 -->
A conforming implementation shall produce at least one diagnostic message (identified in
valid program is still correctly translated. It may also successfully translate an invalid program.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="5.1.2" href="#5.1.2">5.1.2 Execution environments</a></h4>
<p><!--para 1 -->
Two execution environments are defined: freestanding and hosted. In both cases,
environment.
<p><b> Forward references</b>: storage durations of objects (<a href="#6.2.4">6.2.4</a>), initialization (<a href="#6.7.8">6.7.8</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="5.1.2.1" href="#5.1.2.1">5.1.2.1 Freestanding environment</a></h5>
<p><!--para 1 -->
In a freestanding environment (in which C program execution may take place without any
The effect of program termination in a freestanding environment is implementation-
defined.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="5.1.2.2" href="#5.1.2.2">5.1.2.2 Hosted environment</a></h5>
<p><!--para 1 -->
A hosted environment need not be provided, but shall conform to the following
<!--page 24 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="5.1.2.2.1" href="#5.1.2.2.1">5.1.2.2.1 Program startup</a></h5>
<p><!--para 1 -->
The function called at program startup is named main. The implementation declares no
char ** argv, and so on.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="5.1.2.2.2" href="#5.1.2.2.2">5.1.2.2.2 Program execution</a></h5>
<p><!--para 1 -->
In a hosted environment, a program may use all the functions, macros, type definitions,
<!--page 25 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="5.1.2.2.3" href="#5.1.2.2.3">5.1.2.2.3 Program termination</a></h5>
<p><!--para 1 -->
If the return type of the main function is a type compatible with int, a return from the
will have ended in the former case, even where they would not have in the latter.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="5.1.2.3" href="#5.1.2.3">5.1.2.3 Program execution</a></h5>
<p><!--para 1 -->
The semantic descriptions in this International Standard describe the behavior of an
effects matter, freeing the implementations in other cases.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="5.2" href="#5.2">5.2 Environmental considerations</a></h3>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="5.2.1" href="#5.2.1">5.2.1 Character sets</a></h4>
<p><!--para 1 -->
Two sets of characters and their associated collating sequences shall be defined: the set in
<p><b> Forward references</b>: universal character names (<a href="#6.4.3">6.4.3</a>), character constants (<a href="#6.4.4.4">6.4.4.4</a>),
preprocessing directives (<a href="#6.10">6.10</a>), string literals (<a href="#6.4.5">6.4.5</a>), comments (<a href="#6.4.9">6.4.9</a>), string (<a href="#7.1.1">7.1.1</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="5.2.1.1" href="#5.2.1.1">5.2.1.1 Trigraph sequences</a></h5>
<p><!--para 1 -->
Before any other processing takes place, each occurrence of one of the following
described in ISO/IEC 646, which is a subset of the seven-bit US ASCII code set.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="5.2.1.2" href="#5.2.1.2">5.2.1.2 Multibyte characters</a></h5>
<p><!--para 1 -->
The source character set may contain multibyte characters, used to represent members of
of a sequence of valid multibyte characters.
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="5.2.2" href="#5.2.2">5.2.2 Character display semantics</a></h4>
<p><!--para 1 -->
The active position is that location on a display device where the next character output by
International Standard.
<p><b> Forward references</b>: the isprint function (<a href="#7.4.1.8">7.4.1.8</a>), the fputc function (<a href="#7.19.7.3">7.19.7.3</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="5.2.3" href="#5.2.3">5.2.3 Signals and interrupts</a></h4>
<p><!--para 1 -->
Functions shall be implemented such that they may be interrupted at any time by a signal,
image (the instructions that compose the executable representation of a function) on a
per-invocation basis.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="5.2.4" href="#5.2.4">5.2.4 Environmental limits</a></h4>
<p><!--para 1 -->
Both the translation and execution environments constrain the implementation of
environmental limits on a conforming implementation; the library-related limits are
discussed in clause 7.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="5.2.4.1" href="#5.2.4.1">5.2.4.1 Translation limits</a></h5>
<p><!--para 1 -->
The implementation shall be able to translate and execute at least one program that
<p><small><a name="note14" href="#note14">14)</a> See ''future language directions'' (<a href="#6.11.3">6.11.3</a>).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="5.2.4.2" href="#5.2.4.2">5.2.4.2 Numerical limits</a></h5>
<p><!--para 1 -->
An implementation is required to document all the limits specified in this subclause,
specified in <a href="#7.18"><stdint.h></a>.
<p><b> Forward references</b>: integer types <a href="#7.18"><stdint.h></a> (<a href="#7.18">7.18</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="5.2.4.2.1" href="#5.2.4.2.1">5.2.4.2.1 Sizes of integer types <limits.h></a></h5>
<p><!--para 1 -->
The values given below shall be replaced by constant expressions suitable for use in #if
<p><small><a name="note15" href="#note15">15)</a> See <a href="#6.2.5">6.2.5</a>.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="5.2.4.2.2" href="#5.2.4.2.2">5.2.4.2.2 Characteristics of floating types <float.h></a></h5>
<p><!--para 1 -->
The characteristics of floating types are defined in terms of a model that describes a
limits are one less than shown here.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h2><a name="6" href="#6">6. Language</a></h2>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="6.1" href="#6.1">6.1 Notation</a></h3>
<p><!--para 1 -->
In the syntax notation used in this clause, syntactic categories (nonterminals) are
<p><!--para 3 -->
A summary of the language syntax is given in <a href="#A">annex A</a>.
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="6.2" href="#6.2">6.2 Concepts</a></h3>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.2.1" href="#6.2.1">6.2.1 Scopes of identifiers</a></h4>
<p><!--para 1 -->
An identifier can denote an object; a function; a tag or a member of a structure, union, or
(<a href="#6.9.1">6.9.1</a>), identifiers (<a href="#6.4.2">6.4.2</a>), name spaces of identifiers (<a href="#6.2.3">6.2.3</a>), macro replacement (<a href="#6.10.3">6.10.3</a>),
source file inclusion (<a href="#6.10.2">6.10.2</a>), statements (<a href="#6.8">6.8</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.2.2" href="#6.2.2">6.2.2 Linkages of identifiers</a></h4>
<p><!--para 1 -->
An identifier declared in different scopes or in the same scope more than once can be
<p><small><a name="note23" href="#note23">23)</a> As specified in <a href="#6.2.1">6.2.1</a>, the later declaration might hide the prior declaration.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.2.3" href="#6.2.3">6.2.3 Name spaces of identifiers</a></h4>
<p><!--para 1 -->
If more than one declaration of a particular identifier is visible at any point in a
<p><small><a name="note24" href="#note24">24)</a> There is only one name space for tags even though three are possible.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.2.4" href="#6.2.4">6.2.4 Storage durations of objects</a></h4>
<p><!--para 1 -->
An object has a storage duration that determines its lifetime. There are three storage
embedded block prior to the declaration, leaves the scope of the declaration.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.2.5" href="#6.2.5">6.2.5 Types</a></h4>
<p><!--para 1 -->
The meaning of a value stored in an object or returned by a function is determined by the
arguments to functions, return values from functions, and members of unions.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.2.6" href="#6.2.6">6.2.6 Representations of types</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.2.6.1" href="#6.2.6.1">6.2.6.1 General</a></h5>
<p><!--para 1 -->
The representations of all types are unspecified except as stated in this subclause.
on values of type T may distinguish between them.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.2.6.2" href="#6.2.6.2">6.2.6.2 Integer types</a></h5>
<p><!--para 1 -->
For unsigned integer types other than unsigned char, the bits of the object
bits.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.2.7" href="#6.2.7">6.2.7 Compatible type and composite type</a></h4>
<p><!--para 1 -->
Two types have compatible type if their types are the same. Additional rules for
<p><small><a name="note47" href="#note47">47)</a> As specified in <a href="#6.2.1">6.2.1</a>, the later declaration might hide the prior declaration.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="6.3" href="#6.3">6.3 Conversions</a></h3>
<p><!--para 1 -->
Several operators convert operand values from one type to another automatically. This
representation.
<p><b> Forward references</b>: cast operators (<a href="#6.5.4">6.5.4</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.3.1" href="#6.3.1">6.3.1 Arithmetic operands</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.3.1.1" href="#6.3.1.1">6.3.1.1 Boolean, characters, and integers</a></h5>
<p><!--para 1 -->
Every integer type has an integer conversion rank defined as follows:
shift operators, as specified by their respective subclauses.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.3.1.2" href="#6.3.1.2">6.3.1.2 Boolean type</a></h5>
<p><!--para 1 -->
When any scalar value is converted to _Bool, the result is 0 if the value compares equal
to 0; otherwise, the result is 1.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.3.1.3" href="#6.3.1.3">6.3.1.3 Signed and unsigned integers</a></h5>
<p><!--para 1 -->
When a value with integer type is converted to another integer type other than _Bool, if
<p><small><a name="note49" href="#note49">49)</a> The rules describe arithmetic on the mathematical value, not the value of a given type of expression.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.3.1.4" href="#6.3.1.4">6.3.1.4 Real floating and integer</a></h5>
<p><!--para 1 -->
When a finite value of real floating type is converted to an integer type other than _Bool,
range of portable real floating values is (-1, Utype_MAX+1).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.3.1.5" href="#6.3.1.5">6.3.1.5 Real floating types</a></h5>
<p><!--para 1 -->
When a float is promoted to double or long double, or a double is promoted
value, chosen in an implementation-defined manner. If the value being converted is
outside the range of values that can be represented, the behavior is undefined.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.3.1.6" href="#6.3.1.6">6.3.1.6 Complex types</a></h5>
<p><!--para 1 -->
When a value of complex type is converted to another complex type, both the real and
imaginary parts follow the conversion rules for the corresponding real types.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.3.1.7" href="#6.3.1.7">6.3.1.7 Real and complex</a></h5>
<p><!--para 1 -->
When a value of real type is converted to a complex type, the real part of the complex
complex value is discarded and the value of the real part is converted according to the
conversion rules for the corresponding real type.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.3.1.8" href="#6.3.1.8">6.3.1.8 Usual arithmetic conversions</a></h5>
<p><!--para 1 -->
Many operators that expect operands of arithmetic type cause conversions and yield result
described in <a href="#6.3.1.4">6.3.1.4</a> and <a href="#6.3.1.5">6.3.1.5</a>.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.3.2" href="#6.3.2">6.3.2 Other operands</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.3.2.1" href="#6.3.2.1">6.3.2.1 Lvalues, arrays, and function designators</a></h5>
<p><!--para 1 -->
An lvalue is an expression with an object type or an incomplete type other than void;<sup><a href="#note53"><b>53)</b></a></sup>
designator and violates the constraint in <a href="#6.5.3.4">6.5.3.4</a>.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.3.2.2" href="#6.3.2.2">6.3.2.2 void</a></h5>
<p><!--para 1 -->
The (nonexistent) value of a void expression (an expression that has type void) shall not
expression, its value or designator is discarded. (A void expression is evaluated for its
side effects.)
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.3.2.3" href="#6.3.2.3">6.3.2.3 Pointers</a></h5>
<p><!--para 1 -->
A pointer to void may be converted to or from a pointer to any incomplete or object
correctly aligned for a pointer to type C.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="6.4" href="#6.4">6.4 Lexical elements</a></h3>
<p><b>Syntax</b>
<p><!--para 1 -->
occur in source files.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.4.1" href="#6.4.1">6.4.1 Keywords</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
<p><small><a name="note59" href="#note59">59)</a> One possible specification for imaginary types appears in <a href="#G">annex G</a>.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.4.2" href="#6.4.2">6.4.2 Identifiers</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.4.2.1" href="#6.4.2.1">6.4.2.1 General</a></h5>
<p><b>Syntax</b>
<p><!--para 1 -->
Extended characters may produce a long external identifier.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.4.2.2" href="#6.4.2.2">6.4.2.2 Predefined identifiers</a></h5>
<p><b>Semantics</b>
<p><!--para 1 -->
identifier is explicitly declared using the name __func__, the behavior is undefined.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.4.3" href="#6.4.3">6.4.3 Universal character names</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
<p><small><a name="note63" href="#note63">63)</a> Short identifiers for characters were first specified in ISO/IEC 10646-1/AMD9:1997.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.4.4" href="#6.4.4">6.4.4 Constants</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
<p><!--para 3 -->
Each constant has a type, determined by its form and value, as detailed later.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.4.4.1" href="#6.4.4.1">6.4.4.1 Integer constants</a></h5>
<p><b>Syntax</b>
<p><!--para 1 -->
its list and has no extended integer type, then the integer constant has no type.
<!--page 69 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.4.4.2" href="#6.4.4.2">6.4.4.2 Floating constants</a></h5>
<p><b>Syntax</b>
<p><!--para 1 -->
floating constants (see <a href="#7.20.1.3">7.20.1.3</a>).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.4.4.3" href="#6.4.4.3">6.4.4.3 Enumeration constants</a></h5>
<p><b>Syntax</b>
<p><!--para 1 -->
An identifier declared as an enumeration constant has type int.
<p><b> Forward references</b>: enumeration specifiers (<a href="#6.7.2.2">6.7.2.2</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.4.4.4" href="#6.4.4.4">6.4.4.4 Character constants</a></h5>
<p><b>Syntax</b>
<p><!--para 1 -->
the result is not a token and a diagnostic is required. See ''future language directions'' (<a href="#6.11.4">6.11.4</a>).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.4.5" href="#6.4.5">6.4.5 String literals</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
it by a \0 escape sequence.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.4.6" href="#6.4.6">6.4.6 Punctuators</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
interchanged.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.4.7" href="#6.4.7">6.4.7 Header names</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
<p><small><a name="note70" href="#note70">70)</a> For an example of a header name preprocessing token used in a #pragma directive, see <a href="#6.10.9">6.10.9</a>.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.4.8" href="#6.4.8">6.4.8 Preprocessing numbers</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
<!--page 78 -->
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.4.9" href="#6.4.9">6.4.9 Comments</a></h4>
<p><!--para 1 -->
Except within a character constant, a string literal, or a comment, the characters /*
<p><small><a name="note71" href="#note71">71)</a> Thus, /* ... */ comments do not nest.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="6.5" href="#6.5">6.5 Expressions</a></h3>
<p><!--para 1 -->
An expression is a sequence of operators and operands that specifies computation of a
documented.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.5.1" href="#6.5.1">6.5.1 Primary expressions</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
<p><small><a name="note79" href="#note79">79)</a> Thus, an undeclared identifier is a violation of the syntax.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.5.2" href="#6.5.2">6.5.2 Postfix operators</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
argument-expression-list , assignment-expression
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.5.2.1" href="#6.5.2.1">6.5.2.1 Array subscripting</a></h5>
<p><b>Constraints</b>
<p><!--para 1 -->
(<a href="#6.5.3.2">6.5.3.2</a>), array declarators (<a href="#6.7.5.2">6.7.5.2</a>).
<!--page 83 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.5.2.2" href="#6.5.2.2">6.5.2.2 Function calls</a></h5>
<p><b>Constraints</b>
<p><!--para 1 -->
adjusted to have a pointer type as described in <a href="#6.9.1">6.9.1</a>.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.5.2.3" href="#6.5.2.3">6.5.2.3 Structure and union members</a></h5>
<p><b>Constraints</b>
<p><!--para 1 -->
its operand), the expression (&E)->MOS is the same as E.MOS.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.5.2.4" href="#6.5.2.4">6.5.2.4 Postfix increment and decrement operators</a></h5>
<p><b>Constraints</b>
<p><!--para 1 -->
it).
<p><b> Forward references</b>: additive operators (<a href="#6.5.6">6.5.6</a>), compound assignment (<a href="#6.5.16.2">6.5.16.2</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.5.2.5" href="#6.5.2.5">6.5.2.5 Compound literals</a></h5>
<p><b>Constraints</b>
<p><!--para 1 -->
the same or overlapping representations.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.5.3" href="#6.5.3">6.5.3 Unary operators</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
& * + - ~ !
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.5.3.1" href="#6.5.3.1">6.5.3.1 Prefix increment and decrement operators</a></h5>
<p><b>Constraints</b>
<p><!--para 1 -->
operand is decremented.
<p><b> Forward references</b>: additive operators (<a href="#6.5.6">6.5.6</a>), compound assignment (<a href="#6.5.16.2">6.5.16.2</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.5.3.2" href="#6.5.3.2">6.5.3.2 Address and indirection operators</a></h5>
<p><b>Constraints</b>
<p><!--para 1 -->
end of its lifetime.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.5.3.3" href="#6.5.3.3">6.5.3.3 Unary arithmetic operators</a></h5>
<p><b>Constraints</b>
<p><!--para 1 -->
<!--page 92 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.5.3.4" href="#6.5.3.4">6.5.3.4 The sizeof operator</a></h5>
<p><b>Constraints</b>
<p><!--para 1 -->
size of the adjusted (pointer) type (see <a href="#6.9.1">6.9.1</a>).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.5.4" href="#6.5.4">6.5.4 Cast operators</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
unqualified version of the type.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.5.5" href="#6.5.5">6.5.5 Multiplicative operators</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
<p><small><a name="note90" href="#note90">90)</a> This is often called ''truncation toward zero''.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.5.6" href="#6.5.6">6.5.6 Additive operators</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
element'' requirements.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.5.7" href="#6.5.7">6.5.7 Bitwise shift operators</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
part of the quotient of E1 / 2E2 . If E1 has a signed type and a negative value, the
resulting value is implementation-defined.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.5.8" href="#6.5.8">6.5.8 Relational operators</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
means (a<b)<c; in other words, ''if a is less than b, compare 1 to c; otherwise, compare 0 to c''.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.5.9" href="#6.5.9">6.5.9 Equality operators</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
behavior.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.5.10" href="#6.5.10">6.5.10 Bitwise AND operator</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
<!--page 100 -->
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.5.11" href="#6.5.11">6.5.11 Bitwise exclusive OR operator</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
in the result is set if and only if exactly one of the corresponding bits in the converted
operands is set).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.5.12" href="#6.5.12">6.5.12 Bitwise inclusive OR operator</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
operands is set).
<!--page 101 -->
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.5.13" href="#6.5.13">6.5.13 Logical AND operator</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
there is a sequence point after the evaluation of the first operand. If the first operand
compares equal to 0, the second operand is not evaluated.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.5.14" href="#6.5.14">6.5.14 Logical OR operator</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
unequal to 0, the second operand is not evaluated.
<!--page 102 -->
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.5.15" href="#6.5.15">6.5.15 Conditional operator</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
<p><small><a name="note95" href="#note95">95)</a> A conditional expression does not yield an lvalue.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.5.16" href="#6.5.16">6.5.16 Assignment operators</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
behavior is undefined.
<!--page 104 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.5.16.1" href="#6.5.16.1">6.5.16.1 Simple assignment</a></h5>
<p><b>Constraints</b>
<p><!--para 1 -->
not volatile from the type int volatile * const).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.5.16.2" href="#6.5.16.2">6.5.16.2 Compound assignment</a></h5>
<p><b>Constraints</b>
<p><!--para 1 -->
expression E1 = E1 op (E2) only in that the lvalue E1 is evaluated only once.
<!--page 106 -->
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.5.17" href="#6.5.17">6.5.17 Comma operator</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
<p><small><a name="note97" href="#note97">97)</a> A comma operator does not yield an lvalue.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="6.6" href="#6.6">6.6 Constant expressions</a></h3>
<p><b>Syntax</b>
<p><!--para 1 -->
the expression is a valid integer constant expression with value one.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="6.7" href="#6.7">6.7 Declarations</a></h3>
<p><b>Syntax</b>
<p><!--para 1 -->
<p><small><a name="note101" href="#note101">101)</a> Function definitions have a different syntax, described in <a href="#6.9.1">6.9.1</a>.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.7.1" href="#6.7.1">6.7.1 Storage-class specifiers</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
register is sizeof.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.7.2" href="#6.7.2">6.7.2 Type specifiers</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
<p><small><a name="note104" href="#note104">104)</a> Freestanding implementations are not required to provide complex types. *
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.7.2.1" href="#6.7.2.1">6.7.2.1 Structure and union specifiers</a></h5>
<p><b>Syntax</b>
<p><!--para 1 -->
layouts.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.7.2.2" href="#6.7.2.2">6.7.2.2 Enumeration specifiers</a></h5>
<p><b>Syntax</b>
<p><!--para 1 -->
been seen.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.7.2.3" href="#6.7.2.3">6.7.2.3 Tags</a></h5>
<p><b>Constraints</b>
<p><!--para 1 -->
<p><small><a name="note113" href="#note113">113)</a> A similar construction with enum does not exist.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.7.3" href="#6.7.3">6.7.3 Type qualifiers</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
<p><small><a name="note118" href="#note118">118)</a> Both of these can occur through the use of typedefs.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.7.3.1" href="#6.7.3.1">6.7.3.1 Formal definition of restrict</a></h5>
<p><!--para 1 -->
Let D be a declaration of an ordinary identifier that provides a means of designating an
expressions *p and p[1] are not.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.7.4" href="#6.7.4">6.7.4 Function specifiers</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
duration are also distinct in each of the definitions.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.7.5" href="#6.7.5">6.7.5 Declarators</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
directly or via one or more typedefs.
<p><b> Forward references</b>: array declarators (<a href="#6.7.5.2">6.7.5.2</a>), type definitions (<a href="#6.7.7">6.7.7</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.7.5.1" href="#6.7.5.1">6.7.5.1 Pointer declarators</a></h5>
<p><b>Semantics</b>
<p><!--para 1 -->
declares constant_ptr as an object that has type ''const-qualified pointer to int''.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.7.5.2" href="#6.7.5.2">6.7.5.2 Array declarators</a></h5>
<p><b>Constraints</b>
<p><!--para 1 -->
<p><small><a name="note124" href="#note124">124)</a> Thus, * can be used only in function declarations that are not definitions (see <a href="#6.7.5.3">6.7.5.3</a>).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.7.5.3" href="#6.7.5.3">6.7.5.3 Function declarators (including prototypes)</a></h5>
<p><b>Constraints</b>
<p><!--para 1 -->
<p><small><a name="note127" href="#note127">127)</a> If both function types are ''old style'', parameter types are not compared.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.7.6" href="#6.7.6">6.7.6 Type names</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
parameter specification'', rather than redundant parentheses around the omitted identifier.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.7.7" href="#6.7.7">6.7.7 Type definitions</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
}
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.7.8" href="#6.7.8">6.7.8 Initialization</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
<p><small><a name="note133" href="#note133">133)</a> In particular, the evaluation order need not be the same as the order of subobject initialization.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="6.8" href="#6.8">6.8 Statements and blocks</a></h3>
<p><b>Syntax</b>
<p><!--para 1 -->
<p><b> Forward references</b>: expression and null statements (<a href="#6.8.3">6.8.3</a>), selection statements
(<a href="#6.8.4">6.8.4</a>), iteration statements (<a href="#6.8.5">6.8.5</a>), the return statement (<a href="#6.8.6.4">6.8.6.4</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.8.1" href="#6.8.1">6.8.1 Labeled statements</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
them.
<p><b> Forward references</b>: the goto statement (<a href="#6.8.6.1">6.8.6.1</a>), the switch statement (<a href="#6.8.4.2">6.8.4.2</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.8.2" href="#6.8.2">6.8.2 Compound statement</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
<p><!--para 2 -->
A compound statement is a block.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.8.3" href="#6.8.3">6.8.3 Expression and null statements</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
<p><small><a name="note134" href="#note134">134)</a> Such as assignments, and function calls which have side effects.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.8.4" href="#6.8.4">6.8.4 Selection statements</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
enclosing block. Each associated substatement is also a block whose scope is a strict
subset of the scope of the selection statement.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.8.4.1" href="#6.8.4.1">6.8.4.1 The if statement</a></h5>
<p><b>Constraints</b>
<p><!--para 1 -->
An else is associated with the lexically nearest preceding if that is allowed by the
syntax.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.8.4.2" href="#6.8.4.2">6.8.4.2 The switch statement</a></h5>
<p><b>Constraints</b>
<p><!--para 1 -->
default label associated with the switch that is in the block containing the declaration.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.8.5" href="#6.8.5">6.8.5 Iteration statements</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
statement is not evaluated before entering the loop body, nor is clause-1 of a for statement.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.8.5.1" href="#6.8.5.1">6.8.5.1 The while statement</a></h5>
<p><!--para 1 -->
The evaluation of the controlling expression takes place before each execution of the loop
body.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.8.5.2" href="#6.8.5.2">6.8.5.2 The do statement</a></h5>
<p><!--para 1 -->
The evaluation of the controlling expression takes place after each execution of the loop
body.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.8.5.3" href="#6.8.5.3">6.8.5.3 The for statement</a></h5>
<p><!--para 1 -->
The statement
specifies an operation (such as incrementing) that is performed after each iteration.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.8.6" href="#6.8.6">6.8.6 Jump statements</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
<!--page 149 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.8.6.1" href="#6.8.6.1">6.8.6.1 The goto statement</a></h5>
<p><b>Constraints</b>
<p><!--para 1 -->
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.8.6.2" href="#6.8.6.2">6.8.6.2 The continue statement</a></h5>
<p><b>Constraints</b>
<p><!--para 1 -->
<p><small><a name="note138" href="#note138">138)</a> Following the contin: label is a null statement.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.8.6.3" href="#6.8.6.3">6.8.6.3 The break statement</a></h5>
<p><b>Constraints</b>
<p><!--para 1 -->
<!--page 151 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.8.6.4" href="#6.8.6.4">6.8.6.4 The return statement</a></h5>
<p><b>Constraints</b>
<p><!--para 1 -->
range and precision.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="6.9" href="#6.9">6.9 External definitions</a></h3>
<p><b>Syntax</b>
<p><!--para 1 -->
external definition for it.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.9.1" href="#6.9.1">6.9.1 Function definitions</a></h4>
<p><b>Syntax</b>
<p><!--para 1 -->
<p><small><a name="note142" href="#note142">142)</a> See ''future language directions'' (<a href="#6.11.7">6.11.7</a>).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.9.2" href="#6.9.2">6.9.2 External object definitions</a></h4>
<p><b>Semantics</b>
<p><!--para 1 -->
zero on program startup.
<!--page 157 -->
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="6.10" href="#6.10">6.10 Preprocessing directives</a></h3>
<p><b>Syntax</b>
<p><!--para 1 -->
# character string literal creation operator in <a href="#6.10.3.2">6.10.3.2</a>, for example).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.10.1" href="#6.10.1">6.10.1 Conditional inclusion</a></h4>
<p><b>Constraints</b>
<p><!--para 1 -->
including within a preprocessing directive.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.10.2" href="#6.10.2">6.10.2 Source file inclusion</a></h4>
<p><b>Constraints</b>
<p><!--para 1 -->
phases in <a href="#5.1.1.2">5.1.1.2</a>); thus, an expansion that results in two string literals is an invalid directive.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.10.3" href="#6.10.3">6.10.3 Macro replacement</a></h4>
<p><b>Constraints</b>
<p><!--para 1 -->
<p><small><a name="note150" href="#note150">150)</a> Despite the name, a non-directive is a preprocessing directive.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.10.3.1" href="#6.10.3.1">6.10.3.1 Argument substitution</a></h5>
<p><!--para 1 -->
After the arguments for the invocation of a function-like macro have been identified,
were a parameter, and the variable arguments shall form the preprocessing tokens used to
replace it.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.10.3.2" href="#6.10.3.2">6.10.3.2 The # operator</a></h5>
<p><b>Constraints</b>
<p><!--para 1 -->
## operators is unspecified.
<!--page 166 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.10.3.3" href="#6.10.3.3">6.10.3.3 The ## operator</a></h5>
<p><b>Constraints</b>
<p><!--para 1 -->
exist only within translation phase 4.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.10.3.4" href="#6.10.3.4">6.10.3.4 Rescanning and further replacement</a></h5>
<p><!--para 1 -->
After all parameters in the replacement list have been substituted and # and ##
as a preprocessing directive even if it resembles one, but all pragma unary operator
expressions within it are then processed as specified in <a href="#6.10.9">6.10.9</a> below.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="6.10.3.5" href="#6.10.3.5">6.10.3.5 Scope of macro definitions</a></h5>
<p><!--para 1 -->
A macro definition lasts (independent of block structure) until a corresponding #undef
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.10.4" href="#6.10.4">6.10.4 Line control</a></h4>
<p><b>Constraints</b>
<p><!--para 1 -->
previous forms and is then processed as appropriate.
<!--page 171 -->
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.10.5" href="#6.10.5">6.10.5 Error directive</a></h4>
<p><b>Semantics</b>
<p><!--para 1 -->
causes the implementation to produce a diagnostic message that includes the specified
sequence of preprocessing tokens.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.10.6" href="#6.10.6">6.10.6 Pragma directive</a></h4>
<p><b>Semantics</b>
<p><!--para 1 -->
<p><small><a name="note153" href="#note153">153)</a> See ''future language directions'' (<a href="#6.11.8">6.11.8</a>).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.10.7" href="#6.10.7">6.10.7 Null directive</a></h4>
<p><b>Semantics</b>
<p><!--para 1 -->
</pre>
has no effect.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.10.8" href="#6.10.8">6.10.8 Predefined macro names</a></h4>
<p><!--para 1 -->
The following macro names<sup><a href="#note154"><b>154)</b></a></sup> shall be defined by the implementation:
int that is increased with each revision of this International Standard.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.10.9" href="#6.10.9">6.10.9 Pragma operator</a></h4>
<p><b>Semantics</b>
<p><!--para 1 -->
LISTING ( ..\listing.dir )
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="6.11" href="#6.11">6.11 Future language directions</a></h3>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.11.1" href="#6.11.1">6.11.1 Floating types</a></h4>
<p><!--para 1 -->
Future standardization may include additional floating-point types, including those with
greater range, precision, or both than long double.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.11.2" href="#6.11.2">6.11.2 Linkages of identifiers</a></h4>
<p><!--para 1 -->
Declaring an identifier with internal linkage at file scope without the static storage-
class specifier is an obsolescent feature.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.11.3" href="#6.11.3">6.11.3 External names</a></h4>
<p><!--para 1 -->
Restriction of the significance of an external name to fewer than 255 characters
(considering each universal character name or extended source character as a single
character) is an obsolescent feature that is a concession to existing implementations.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.11.4" href="#6.11.4">6.11.4 Character escape sequences</a></h4>
<p><!--para 1 -->
Lowercase letters as escape sequences are reserved for future standardization. Other
characters may be used in extensions.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.11.5" href="#6.11.5">6.11.5 Storage-class specifiers</a></h4>
<p><!--para 1 -->
The placement of a storage-class specifier other than at the beginning of the declaration
specifiers in a declaration is an obsolescent feature.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.11.6" href="#6.11.6">6.11.6 Function declarators</a></h4>
<p><!--para 1 -->
The use of function declarators with empty parentheses (not prototype-format parameter
type declarators) is an obsolescent feature.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.11.7" href="#6.11.7">6.11.7 Function definitions</a></h4>
<p><!--para 1 -->
The use of function definitions with separate parameter identifier and declaration lists
(not prototype-format parameter type and identifier declarators) is an obsolescent feature.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.11.8" href="#6.11.8">6.11.8 Pragma directives</a></h4>
<p><!--para 1 -->
Pragmas whose first preprocessing token is STDC are reserved for future standardization.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="6.11.9" href="#6.11.9">6.11.9 Predefined macro names</a></h4>
<p><!--para 1 -->
Macro names beginning with __STDC_ are reserved for future standardization.
<!--page 176 -->
+<p><small><a href="#Contents">Contents</a></small>
<h2><a name="7" href="#7">7. Library</a></h2>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.1" href="#7.1">7.1 Introduction</a></h3>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.1.1" href="#7.1.1">7.1.1 Definitions of terms</a></h4>
<p><!--para 1 -->
A string is a contiguous sequence of characters terminated by and including the first null
implementation's choice.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.1.2" href="#7.1.2">7.1.2 Standard headers</a></h4>
<p><!--para 1 -->
Each library function is declared, with a type that includes a prototype, in a header,<sup><a href="#note159"><b>159)</b></a></sup>
necessarily valid source file names.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.1.3" href="#7.1.3">7.1.3 Reserved identifiers</a></h4>
<p><!--para 1 -->
Each header declares or defines all identifiers listed in its associated subclause, and
setjmp, and va_end.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.1.4" href="#7.1.4">7.1.4 Use of library functions</a></h4>
<p><!--para 1 -->
Each of the following statements applies unless explicitly stated otherwise in the detailed
<p><small><a name="note164" href="#note164">164)</a> Thus, a signal handler cannot, in general, call standard library functions.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.2" href="#7.2">7.2 Diagnostics <assert.h></a></h3>
<p><!--para 1 -->
The header <a href="#7.2"><assert.h></a> defines the assert macro and refers to another macro,
macro definition is suppressed in order to access an actual function, the behavior is
undefined.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.2.1" href="#7.2.1">7.2.1 Program diagnostics</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.2.1.1" href="#7.2.1.1">7.2.1.1 The assert macro</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
Assertion failed: expression, function abc, file xyz, line nnn.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.3" href="#7.3">7.3 Complex arithmetic <complex.h></a></h3>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.3.1" href="#7.3.1">7.3.1 Introduction</a></h4>
<p><!--para 1 -->
The header <a href="#7.3"><complex.h></a> defines macros and declares functions that support complex
<p><small><a name="note168" href="#note168">168)</a> A specification for imaginary types is in informative <a href="#G">annex G</a>.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.3.2" href="#7.3.2">7.3.2 Conventions</a></h4>
<p><!--para 1 -->
Values are interpreted as radians, not degrees. An implementation may set errno but is
not required to.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.3.3" href="#7.3.3">7.3.3 Branch cuts</a></h4>
<p><!--para 1 -->
Some of the functions below have branch cuts, across which the function is
the finite endpoint of the cut along the negative real axis approaches the cut from above,
so the cut maps to the positive imaginary axis.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.3.4" href="#7.3.4">7.3.4 The CX_LIMITED_RANGE pragma</a></h4>
<p><b>Synopsis</b>
<p><!--para 1 -->
where the programmer can determine they are safe.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.3.5" href="#7.3.5">7.3.5 Trigonometric functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.3.5.1" href="#7.3.5.1">7.3.5.1 The cacos functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
mathematically unbounded along the imaginary axis and in the interval [0, pi ] along the
real axis.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.3.5.2" href="#7.3.5.2">7.3.5.2 The casin functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
along the real axis.
<!--page 185 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.3.5.3" href="#7.3.5.3">7.3.5.3 The catan functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
mathematically unbounded along the imaginary axis and in the interval [-pi /2, +pi /2]
along the real axis.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.3.5.4" href="#7.3.5.4">7.3.5.4 The ccos functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The ccos functions return the complex cosine value.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.3.5.5" href="#7.3.5.5">7.3.5.5 The csin functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The csin functions return the complex sine value.
<!--page 186 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.3.5.6" href="#7.3.5.6">7.3.5.6 The ctan functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The ctan functions return the complex tangent value.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.3.6" href="#7.3.6">7.3.6 Hyperbolic functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.3.6.1" href="#7.3.6.1">7.3.6.1 The cacosh functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
half-strip of non-negative values along the real axis and in the interval [-ipi , +ipi ] along
the imaginary axis.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.3.6.2" href="#7.3.6.2">7.3.6.2 The casinh functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
strip mathematically unbounded along the real axis and in the interval [-ipi /2, +ipi /2]
along the imaginary axis.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.3.6.3" href="#7.3.6.3">7.3.6.3 The catanh functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
strip mathematically unbounded along the real axis and in the interval [-ipi /2, +ipi /2]
along the imaginary axis.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.3.6.4" href="#7.3.6.4">7.3.6.4 The ccosh functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The ccosh functions return the complex hyperbolic cosine value.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.3.6.5" href="#7.3.6.5">7.3.6.5 The csinh functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The csinh functions return the complex hyperbolic sine value.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.3.6.6" href="#7.3.6.6">7.3.6.6 The ctanh functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The ctanh functions return the complex hyperbolic tangent value.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.3.7" href="#7.3.7">7.3.7 Exponential and logarithmic functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.3.7.1" href="#7.3.7.1">7.3.7.1 The cexp functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The cexp functions return the complex base-e exponential value.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.3.7.2" href="#7.3.7.2">7.3.7.2 The clog functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
mathematically unbounded along the real axis and in the interval [-ipi , +ipi ] along the
imaginary axis.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.3.8" href="#7.3.8">7.3.8 Power and absolute-value functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.3.8.1" href="#7.3.8.1">7.3.8.1 The cabs functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The cabs functions return the complex absolute value.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.3.8.2" href="#7.3.8.2">7.3.8.2 The cpow functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The cpow functions return the complex power function value.
<!--page 190 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.3.8.3" href="#7.3.8.3">7.3.8.3 The csqrt functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The csqrt functions return the complex square root value, in the range of the right half-
plane (including the imaginary axis).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.3.9" href="#7.3.9">7.3.9 Manipulation functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.3.9.1" href="#7.3.9.1">7.3.9.1 The carg functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The carg functions return the value of the argument in the interval [-pi , +pi ].
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.3.9.2" href="#7.3.9.2">7.3.9.2 The cimag functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><small><a name="note170" href="#note170">170)</a> For a variable z of complex type, z == creal(z) + cimag(z)*I.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.3.9.3" href="#7.3.9.3">7.3.9.3 The conj functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The conj functions return the complex conjugate value.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.3.9.4" href="#7.3.9.4">7.3.9.4 The cproj functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<!--page 192 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.3.9.5" href="#7.3.9.5">7.3.9.5 The creal functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><small><a name="note171" href="#note171">171)</a> For a variable z of complex type, z == creal(z) + cimag(z)*I.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.4" href="#7.4">7.4 Character handling <ctype.h></a></h3>
<p><!--para 1 -->
The header <a href="#7.4"><ctype.h></a> declares several functions useful for classifying and mapping
values lie from 0 (NUL) through 0x1F (US), and the character 0x7F (DEL).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.4.1" href="#7.4.1">7.4.1 Character classification functions</a></h4>
<p><!--para 1 -->
The functions in this subclause return nonzero (true) if and only if the value of the
argument c conforms to that in the description of the function.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.4.1.1" href="#7.4.1.1">7.4.1.1 The isalnum function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 2 -->
The isalnum function tests for any character for which isalpha or isdigit is true.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.4.1.2" href="#7.4.1.2">7.4.1.2 The isalpha function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
characters; all four combinations are possible.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.4.1.3" href="#7.4.1.3">7.4.1.3 The isblank function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
space (' '), and horizontal tab ('\t'). In the "C" locale, isblank returns true only
for the standard blank characters.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.4.1.4" href="#7.4.1.4">7.4.1.4 The iscntrl function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 2 -->
The iscntrl function tests for any control character.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.4.1.5" href="#7.4.1.5">7.4.1.5 The isdigit function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 2 -->
The isdigit function tests for any decimal-digit character (as defined in <a href="#5.2.1">5.2.1</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.4.1.6" href="#7.4.1.6">7.4.1.6 The isgraph function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 2 -->
The isgraph function tests for any printing character except space (' ').
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.4.1.7" href="#7.4.1.7">7.4.1.7 The islower function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
isspace is true. In the "C" locale, islower returns true only for the lowercase
letters (as defined in <a href="#5.2.1">5.2.1</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.4.1.8" href="#7.4.1.8">7.4.1.8 The isprint function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 2 -->
The isprint function tests for any printing character including space (' ').
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.4.1.9" href="#7.4.1.9">7.4.1.9 The ispunct function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
locale, ispunct returns true for every printing character for which neither isspace
nor isalnum is true.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.4.1.10" href="#7.4.1.10">7.4.1.10 The isspace function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
('\n'), carriage return ('\r'), horizontal tab ('\t'), and vertical tab ('\v'). In the
"C" locale, isspace returns true only for the standard white-space characters.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.4.1.11" href="#7.4.1.11">7.4.1.11 The isupper function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
isspace is true. In the "C" locale, isupper returns true only for the uppercase
letters (as defined in <a href="#5.2.1">5.2.1</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.4.1.12" href="#7.4.1.12">7.4.1.12 The isxdigit function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 2 -->
The isxdigit function tests for any hexadecimal-digit character (as defined in <a href="#6.4.4.1">6.4.4.1</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.4.2" href="#7.4.2">7.4.2 Character case mapping functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.4.2.1" href="#7.4.2.1">7.4.2.1 The tolower function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
for any given locale); otherwise, the argument is returned unchanged.
<!--page 197 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.4.2.2" href="#7.4.2.2">7.4.2.2 The toupper function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
for any given locale); otherwise, the argument is returned unchanged.
<!--page 198 -->
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.5" href="#7.5">7.5 Errors <errno.h></a></h3>
<p><!--para 1 -->
The header <a href="#7.5"><errno.h></a> defines several macros, all relating to the reporting of error
<p><small><a name="note177" href="#note177">177)</a> See ''future library directions'' (<a href="#7.26.3">7.26.3</a>).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.6" href="#7.6">7.6 Floating-point environment <fenv.h></a></h3>
<p><!--para 1 -->
The header <a href="#7.6"><fenv.h></a> declares two types and several macros and functions to provide
FLT_ROUNDS, they are not required to do so.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.6.1" href="#7.6.1">7.6.1 The FENV_ACCESS pragma</a></h4>
<p><b>Synopsis</b>
<p><!--para 1 -->
''off'', just one evaluation of x + 1 would suffice.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.6.2" href="#7.6.2">7.6.2 Floating-point exceptions</a></h4>
<p><!--para 1 -->
The following functions provide access to the floating-point status flags.<sup><a href="#note186"><b>186)</b></a></sup> The int
content of flags.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.6.2.1" href="#7.6.2.1">7.6.2.1 The feclearexcept function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<!--page 203 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.6.2.2" href="#7.6.2.2">7.6.2.2 The fegetexceptflag function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The fegetexceptflag function returns zero if the representation was successfully
stored. Otherwise, it returns a nonzero value.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.6.2.3" href="#7.6.2.3">7.6.2.3 The feraiseexcept function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
in <a href="#F.7.6">F.7.6</a> is in the same spirit.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.6.2.4" href="#7.6.2.4">7.6.2.4 The fesetexceptflag function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
all the specified flags were successfully set to the appropriate state. Otherwise, it returns
a nonzero value.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.6.2.5" href="#7.6.2.5">7.6.2.5 The fetestexcept function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><small><a name="note188" href="#note188">188)</a> This mechanism allows testing several floating-point exceptions with just one function call.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.6.3" href="#7.6.3">7.6.3 Rounding</a></h4>
<p><!--para 1 -->
The fegetround and fesetround functions provide control of rounding direction
modes.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.6.3.1" href="#7.6.3.1">7.6.3.1 The fegetround function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
representing the current rounding direction or a negative value if there is no such
rounding direction macro or the current rounding direction is not determinable.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.6.3.2" href="#7.6.3.2">7.6.3.2 The fesetround function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.6.4" href="#7.6.4">7.6.4 Environment</a></h4>
<p><!--para 1 -->
The functions in this section manage the floating-point environment -- status flags and
control modes -- as one entity.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.6.4.1" href="#7.6.4.1">7.6.4.1 The fegetenv function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The fegetenv function returns zero if the environment was successfully stored.
Otherwise, it returns a nonzero value.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.6.4.2" href="#7.6.4.2">7.6.4.2 The feholdexcept function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
function to write routines that hide spurious floating-point exceptions from their callers.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.6.4.3" href="#7.6.4.3">7.6.4.3 The fesetenv function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The fesetenv function returns zero if the environment was successfully established.
Otherwise, it returns a nonzero value.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.6.4.4" href="#7.6.4.4">7.6.4.4 The feupdateenv function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
}
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.7" href="#7.7">7.7 Characteristics of floating types <float.h></a></h3>
<p><!--para 1 -->
The header <a href="#7.7"><float.h></a> defines several macros that expand to various limits and
in <a href="#5.2.4.2.2">5.2.4.2.2</a>.
<!--page 210 -->
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.8" href="#7.8">7.8 Format conversion of integer types <inttypes.h></a></h3>
<p><!--para 1 -->
The header <a href="#7.8"><inttypes.h></a> includes the header <a href="#7.18"><stdint.h></a> and extends it with
<p><small><a name="note190" href="#note190">190)</a> See ''future library directions'' (<a href="#7.26.4">7.26.4</a>).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.8.1" href="#7.8.1">7.8.1 Macros for format specifiers</a></h4>
<p><!--para 1 -->
Each of the following object-like macros<sup><a href="#note191"><b>191)</b></a></sup> expands to a character string literal
same.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.8.2" href="#7.8.2">7.8.2 Functions for greatest-width integer types</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.8.2.1" href="#7.8.2.1">7.8.2.1 The imaxabs function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><small><a name="note193" href="#note193">193)</a> The absolute value of the most negative number cannot be represented in two's complement.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.8.2.2" href="#7.8.2.2">7.8.2.2 The imaxdiv function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
quot (the quotient) and rem (the remainder), each of which has type intmax_t. If
either part of the result cannot be represented, the behavior is undefined.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.8.2.3" href="#7.8.2.3">7.8.2.3 The strtoimax and strtoumax functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
(<a href="#7.20.1.4">7.20.1.4</a>).
<!--page 213 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.8.2.4" href="#7.8.2.4">7.8.2.4 The wcstoimax and wcstoumax functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
(<a href="#7.24.4.1.2">7.24.4.1.2</a>).
<!--page 214 -->
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.9" href="#7.9">7.9 Alternative spellings <iso646.h></a></h3>
<p><!--para 1 -->
The header <a href="#7.9"><iso646.h></a> defines the following eleven macros (on the left) that expand
xor_eq ^=
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.10" href="#7.10">7.10 Sizes of integer types <limits.h></a></h3>
<p><!--para 1 -->
The header <a href="#7.10"><limits.h></a> defines several macros that expand to various limits and
in <a href="#5.2.4.2.1">5.2.4.2.1</a>.
<!--page 216 -->
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.11" href="#7.11">7.11 Localization <locale.h></a></h3>
<p><!--para 1 -->
The header <a href="#7.11"><locale.h></a> declares two functions, one type, and defines several macros.
<p><small><a name="note195" href="#note195">195)</a> See ''future library directions'' (<a href="#7.26.5">7.26.5</a>).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.11.1" href="#7.11.1">7.11.1 Locale control</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.11.1.1" href="#7.11.1.1">7.11.1.1 The setlocale function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
locale when category has the value LC_ALL.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.11.2" href="#7.11.2">7.11.2 Numeric formatting convention inquiry</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.11.2.1" href="#7.11.2.1">7.11.2.1 The localeconv function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
</pre>
<!--page 224 -->
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.12" href="#7.12">7.12 Mathematics <math.h></a></h3>
<p><!--para 1 -->
The header <a href="#7.12"><math.h></a> declares two types and many mathematical functions and defines
substantially slower.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.12.1" href="#7.12.1">7.12.1 Treatment of error conditions</a></h4>
<p><!--para 1 -->
The behavior of each of the functions in <a href="#7.12"><math.h></a> is specified for all representable
also ''flush-to-zero'' underflow.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.12.2" href="#7.12.2">7.12.2 The FP_CONTRACT pragma</a></h4>
<p><b>Synopsis</b>
<p><!--para 1 -->
<!--page 228 -->
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.12.3" href="#7.12.3">7.12.3 Classification macros</a></h4>
<p><!--para 1 -->
In the synopses in this subclause, real-floating indicates that the argument shall be an
expression of real floating type.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.3.1" href="#7.12.3.1">7.12.3.1 The fpclassify macro</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
become subnormal when converted to double, and zero when converted to float.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.3.2" href="#7.12.3.2">7.12.3.2 The isfinite macro</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The isfinite macro returns a nonzero value if and only if its argument has a finite
value.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.3.3" href="#7.12.3.3">7.12.3.3 The isinf macro</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The isinf macro returns a nonzero value if and only if its argument has an infinite
value.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.3.4" href="#7.12.3.4">7.12.3.4 The isnan macro</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
NaNs in the evaluation type but not in the semantic type.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.3.5" href="#7.12.3.5">7.12.3.5 The isnormal macro</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The isnormal macro returns a nonzero value if and only if its argument has a normal
value.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.3.6" href="#7.12.3.6">7.12.3.6 The signbit macro</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
unsigned, it is treated as positive.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.12.4" href="#7.12.4">7.12.4 Trigonometric functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.4.1" href="#7.12.4.1">7.12.4.1 The acos functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<!--page 231 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.4.2" href="#7.12.4.2">7.12.4.2 The asin functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The asin functions return arcsin x in the interval [-pi /2, +pi /2] radians.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.4.3" href="#7.12.4.3">7.12.4.3 The atan functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The atan functions return arctan x in the interval [-pi /2, +pi /2] radians.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.4.4" href="#7.12.4.4">7.12.4.4 The atan2 functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The atan2 functions return arctan y/x in the interval [-pi , +pi ] radians.
<!--page 232 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.4.5" href="#7.12.4.5">7.12.4.5 The cos functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The cos functions return cos x.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.4.6" href="#7.12.4.6">7.12.4.6 The sin functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The sin functions return sin x.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.4.7" href="#7.12.4.7">7.12.4.7 The tan functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The tan functions return tan x.
<!--page 233 -->
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.12.5" href="#7.12.5">7.12.5 Hyperbolic functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.5.1" href="#7.12.5.1">7.12.5.1 The acosh functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The acosh functions return arcosh x in the interval [0, +(inf)].
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.5.2" href="#7.12.5.2">7.12.5.2 The asinh functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The asinh functions return arsinh x.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.5.3" href="#7.12.5.3">7.12.5.3 The atanh functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The atanh functions return artanh x.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.5.4" href="#7.12.5.4">7.12.5.4 The cosh functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The cosh functions return cosh x.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.5.5" href="#7.12.5.5">7.12.5.5 The sinh functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The sinh functions return sinh x.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.5.6" href="#7.12.5.6">7.12.5.6 The tanh functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The tanh functions return tanh x.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.12.6" href="#7.12.6">7.12.6 Exponential and logarithmic functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.6.1" href="#7.12.6.1">7.12.6.1 The exp functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The exp functions return e<sup>x</sup>.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.6.2" href="#7.12.6.2">7.12.6.2 The exp2 functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The exp2 functions return 2<sup>x</sup>.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.6.3" href="#7.12.6.3">7.12.6.3 The expm1 functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><small><a name="note208" href="#note208">208)</a> For small magnitude x, expm1(x) is expected to be more accurate than exp(x) - 1.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.6.4" href="#7.12.6.4">7.12.6.4 The frexp functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
frexp functions return the value x, such that x has a magnitude in the interval [1/2, 1) or
zero, and value equals x 2<sup>*exp</sup> . If value is zero, both parts of the result are zero.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.6.5" href="#7.12.6.5">7.12.6.5 The ilogb functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The ilogb functions return the exponent of x as a signed int value.
<p><b> Forward references</b>: the logb functions (<a href="#7.12.6.11">7.12.6.11</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.6.6" href="#7.12.6.6">7.12.6.6 The ldexp functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The ldexp functions return x 2<sup>exp</sup> .
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.6.7" href="#7.12.6.7">7.12.6.7 The log functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The log functions return loge x.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.6.8" href="#7.12.6.8">7.12.6.8 The log10 functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The log10 functions return log10 x.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.6.9" href="#7.12.6.9">7.12.6.9 The log1p functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><small><a name="note209" href="#note209">209)</a> For small magnitude x, log1p(x) is expected to be more accurate than log(1 + x).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.6.10" href="#7.12.6.10">7.12.6.10 The log2 functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<!--page 239 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.6.11" href="#7.12.6.11">7.12.6.11 The logb functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The logb functions return the signed exponent of x.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.6.12" href="#7.12.6.12">7.12.6.12 The modf functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The modf functions return the signed fractional part of value.
<!--page 240 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.6.13" href="#7.12.6.13">7.12.6.13 The scalbn and scalbln functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The scalbn and scalbln functions return x FLT_RADIX<sup>n</sup> .
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.12.7" href="#7.12.7">7.12.7 Power and absolute-value functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.7.1" href="#7.12.7.1">7.12.7.1 The cbrt functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The cbrt functions return x<sup>1/3</sup>.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.7.2" href="#7.12.7.2">7.12.7.2 The fabs functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The fabs functions return | x |.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.7.3" href="#7.12.7.3">7.12.7.3 The hypot functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 4 -->
The hypot functions return (sqrt)(x<sup>2</sup> + y<sup>2</sup>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.7.4" href="#7.12.7.4">7.12.7.4 The pow functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The pow functions return x<sup>y</sup>.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.7.5" href="#7.12.7.5">7.12.7.5 The sqrt functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The sqrt functions return (sqrt)(x).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.12.8" href="#7.12.8">7.12.8 Error and gamma functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.8.1" href="#7.12.8.1">7.12.8.1 The erf functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
(sqrt)(pi) 0
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.8.2" href="#7.12.8.2">7.12.8.2 The erfc functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
</pre>
<!--page 243 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.8.3" href="#7.12.8.3">7.12.8.3 The lgamma functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The lgamma functions return loge | (Gamma)(x) |.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.8.4" href="#7.12.8.4">7.12.8.4 The tgamma functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The tgamma functions return (Gamma)(x).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.12.9" href="#7.12.9">7.12.9 Nearest integer functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.9.1" href="#7.12.9.1">7.12.9.1 The ceil functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The ceil functions return [^x^], expressed as a floating-point number.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.9.2" href="#7.12.9.2">7.12.9.2 The floor functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The floor functions return [_x_], expressed as a floating-point number.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.9.3" href="#7.12.9.3">7.12.9.3 The nearbyint functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The nearbyint functions return the rounded integer value.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.9.4" href="#7.12.9.4">7.12.9.4 The rint functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The rint functions return the rounded integer value.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.9.5" href="#7.12.9.5">7.12.9.5 The lrint and llrint functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The lrint and llrint functions return the rounded integer value.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.9.6" href="#7.12.9.6">7.12.9.6 The round functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The round functions return the rounded integer value.
<!--page 246 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.9.7" href="#7.12.9.7">7.12.9.7 The lround and llround functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The lround and llround functions return the rounded integer value.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.9.8" href="#7.12.9.8">7.12.9.8 The trunc functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The trunc functions return the truncated integer value.
<!--page 247 -->
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.12.10" href="#7.12.10">7.12.10 Remainder functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.10.1" href="#7.12.10.1">7.12.10.1 The fmod functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
whether a domain error occurs or the fmod functions return zero is implementation-
defined.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.10.2" href="#7.12.10.2">7.12.10.2 The remainder functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
x.'' This definition is applicable for all implementations.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.10.3" href="#7.12.10.3">7.12.10.3 The remquo functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
pointed to by quo is unspecified and whether a domain error occurs or the functions
return zero is implementation defined.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.12.11" href="#7.12.11">7.12.11 Manipulation functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.11.1" href="#7.12.11.1">7.12.11.1 The copysign functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The copysign functions return a value with the magnitude of x and the sign of y.
<!--page 249 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.11.2" href="#7.12.11.2">7.12.11.2 The nan functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
If the implementation does not support quiet NaNs, the functions return zero.
<p><b> Forward references</b>: the strtod, strtof, and strtold functions (<a href="#7.20.1.3">7.20.1.3</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.11.3" href="#7.12.11.3">7.12.11.3 The nextafter functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
function.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.11.4" href="#7.12.11.4">7.12.11.4 The nexttoward functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
range or precision in a floating second argument.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.12.12" href="#7.12.12">7.12.12 Maximum, minimum, and positive difference functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.12.1" href="#7.12.12.1">7.12.12.1 The fdim functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The fdim functions return the positive difference value.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.12.2" href="#7.12.12.2">7.12.12.2 The fmax functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
fmax functions choose the numeric value. See <a href="#F.9.9.2">F.9.9.2</a>.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.12.3" href="#7.12.12.3">7.12.12.3 The fmin functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><small><a name="note214" href="#note214">214)</a> The fmin functions are analogous to the fmax functions in their treatment of NaNs.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.12.13" href="#7.12.13">7.12.13 Floating multiply-add</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.13.1" href="#7.12.13.1">7.12.13.1 The fma functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<!--page 252 -->
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.12.14" href="#7.12.14">7.12.14 Comparison macros</a></h4>
<p><!--para 1 -->
The relational and equality operators support the usual mathematical relationships
NaNs; the result in these cases is false.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.14.1" href="#7.12.14.1">7.12.14.1 The isgreater macro</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The isgreater macro returns the value of (x) > (y).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.14.2" href="#7.12.14.2">7.12.14.2 The isgreaterequal macro</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The isgreaterequal macro returns the value of (x) >= (y).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.14.3" href="#7.12.14.3">7.12.14.3 The isless macro</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The isless macro returns the value of (x) < (y).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.14.4" href="#7.12.14.4">7.12.14.4 The islessequal macro</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The islessequal macro returns the value of (x) <= (y).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.14.5" href="#7.12.14.5">7.12.14.5 The islessgreater macro</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The islessgreater macro returns the value of (x) < (y) || (x) > (y).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.12.14.6" href="#7.12.14.6">7.12.14.6 The isunordered macro</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The isunordered macro returns 1 if its arguments are unordered and 0 otherwise.
<!--page 255 -->
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.13" href="#7.13">7.13 Nonlocal jumps <setjmp.h></a></h3>
<p><!--para 1 -->
The header <a href="#7.13"><setjmp.h></a> defines the macro setjmp, and declares one function and
a program.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.13.1" href="#7.13.1">7.13.1 Save calling environment</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.13.1.1" href="#7.13.1.1">7.13.1.1 The setjmp macro</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 5 -->
If the invocation appears in any other context, the behavior is undefined.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.13.2" href="#7.13.2">7.13.2 Restore calling environment</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.13.2.1" href="#7.13.2.1">7.13.2.1 The longjmp function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><small><a name="note218" href="#note218">218)</a> This includes, but is not limited to, the floating-point status flags and the state of open files.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.14" href="#7.14">7.14 Signal handling <signal.h></a></h3>
<p><!--para 1 -->
The header <a href="#7.14"><signal.h></a> declares a type and two functions and defines several macros,
and termination.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.14.1" href="#7.14.1">7.14.1 Specify signal handling</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.14.1.1" href="#7.14.1.1">7.14.1.1 The signal function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><small><a name="note220" href="#note220">220)</a> If any signal is generated by an asynchronous signal handler, the behavior is undefined.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.14.2" href="#7.14.2">7.14.2 Send signal</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.14.2.1" href="#7.14.2.1">7.14.2.1 The raise function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The raise function returns zero if successful, nonzero if unsuccessful.
<!--page 261 -->
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.15" href="#7.15">7.15 Variable arguments <stdarg.h></a></h3>
<p><!--para 1 -->
The header <a href="#7.15"><stdarg.h></a> declares a type and defines four macros, for advancing
case the original function may make further use of the original list after the other function returns.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.15.1" href="#7.15.1">7.15.1 Variable argument list access macros</a></h4>
<p><!--para 1 -->
The va_start and va_arg macros described in this subclause shall be implemented
shall be matched by a corresponding invocation of the va_end macro in the same
function.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.15.1.1" href="#7.15.1.1">7.15.1.1 The va_arg macro</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
value of the argument after that specified by parmN . Successive invocations return the
values of the remaining arguments in succession.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.15.1.2" href="#7.15.1.2">7.15.1.2 The va_copy macro</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The va_copy macro returns no value.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.15.1.3" href="#7.15.1.3">7.15.1.3 The va_end macro</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The va_end macro returns no value.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.15.1.4" href="#7.15.1.4">7.15.1.4 The va_start macro</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
}
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.16" href="#7.16">7.16 Boolean type and values <stdbool.h></a></h3>
<p><!--para 1 -->
The header <a href="#7.16"><stdbool.h></a> defines four macros.
<p><small><a name="note222" href="#note222">222)</a> See ''future library directions'' (<a href="#7.26.7">7.26.7</a>).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.17" href="#7.17">7.17 Common definitions <stddef.h></a></h3>
<p><!--para 1 -->
The following types and macros are defined in the standard header <a href="#7.17"><stddef.h></a>. Some
<p><b> Forward references</b>: localization (<a href="#7.11">7.11</a>).
<!--page 267 -->
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.18" href="#7.18">7.18 Integer types <stdint.h></a></h3>
<p><!--para 1 -->
The header <a href="#7.18"><stdint.h></a> declares sets of integer types having specified widths, and
<p><small><a name="note224" href="#note224">224)</a> Some of these types may denote implementation-defined extended integer types.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.18.1" href="#7.18.1">7.18.1 Integer types</a></h4>
<p><!--para 1 -->
When typedef names differing only in the absence or presence of the initial u are defined,
<!--page 268 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.18.1.1" href="#7.18.1.1">7.18.1.1 Exact-width integer types</a></h5>
<p><!--para 1 -->
The typedef name intN_t designates a signed integer type with width N , no padding
widths of 8, 16, 32, or 64 bits, no padding bits, and (for the signed types) that have a
two's complement representation, it shall define the corresponding typedef names.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.18.1.2" href="#7.18.1.2">7.18.1.2 Minimum-width integer types</a></h5>
<p><!--para 1 -->
The typedef name int_leastN_t designates a signed integer type with a width of at
</pre>
All other types of this form are optional.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.18.1.3" href="#7.18.1.3">7.18.1.3 Fastest minimum-width integer types</a></h5>
<p><!--para 1 -->
Each of the following types designates an integer type that is usually fastest<sup><a href="#note225"><b>225)</b></a></sup> to operate
signedness and width requirements.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.18.1.4" href="#7.18.1.4">7.18.1.4 Integer types capable of holding object pointers</a></h5>
<p><!--para 1 -->
The following type designates a signed integer type with the property that any valid
</pre>
These types are optional.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.18.1.5" href="#7.18.1.5">7.18.1.5 Greatest-width integer types</a></h5>
<p><!--para 1 -->
The following type designates a signed integer type capable of representing any value of
</pre>
These types are required.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.18.2" href="#7.18.2">7.18.2 Limits of specified-width integer types</a></h4>
<p><!--para 1 -->
The following object-like macros<sup><a href="#note226"><b>226)</b></a></sup> specify the minimum and maximum limits of the
before <a href="#7.18"><stdint.h></a> is included.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.18.2.1" href="#7.18.2.1">7.18.2.1 Limits of exact-width integer types</a></h5>
<p><!--para 1 -->
<ul>
</pre>
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.18.2.2" href="#7.18.2.2">7.18.2.2 Limits of minimum-width integer types</a></h5>
<p><!--para 1 -->
<ul>
</pre>
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.18.2.3" href="#7.18.2.3">7.18.2.3 Limits of fastest minimum-width integer types</a></h5>
<p><!--para 1 -->
<ul>
</pre>
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.18.2.4" href="#7.18.2.4">7.18.2.4 Limits of integer types capable of holding object pointers</a></h5>
<p><!--para 1 -->
<ul>
</pre>
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.18.2.5" href="#7.18.2.5">7.18.2.5 Limits of greatest-width integer types</a></h5>
<p><!--para 1 -->
<ul>
</pre>
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.18.3" href="#7.18.3">7.18.3 Limits of other integer types</a></h4>
<p><!--para 1 -->
The following object-like macros<sup><a href="#note227"><b>227)</b></a></sup> specify the minimum and maximum limits of
character set.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.18.4" href="#7.18.4">7.18.4 Macros for integer constants</a></h4>
<p><!--para 1 -->
The following function-like macros<sup><a href="#note230"><b>230)</b></a></sup> expand to integer constants suitable for
defined before <a href="#7.18"><stdint.h></a> is included.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.18.4.1" href="#7.18.4.1">7.18.4.1 Macros for minimum-width integer constants</a></h5>
<p><!--para 1 -->
The macro INTN_C(value) shall expand to an integer constant expression
example, if uint_least64_t is a name for the type unsigned long long int,
then UINT64_C(0x123) might expand to the integer constant 0x123ULL.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.18.4.2" href="#7.18.4.2">7.18.4.2 Macros for greatest-width integer constants</a></h5>
<p><!--para 1 -->
The following macro expands to an integer constant expression having the value specified
UINTMAX_C(value)
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.19" href="#7.19">7.19 Input/output <stdio.h></a></h3>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.19.1" href="#7.19.1">7.19.1 Introduction</a></h4>
<p><!--para 1 -->
The header <a href="#7.19"><stdio.h></a> declares three types, several macros, and many functions for
all possible strings of length FILENAME_MAX cannot be expected to be opened successfully.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.19.2" href="#7.19.2">7.19.2 Streams</a></h4>
<p><!--para 1 -->
Input and output, whether to or from physical devices such as terminals and tape drives,
<p><small><a name="note233" href="#note233">233)</a> The three predefined streams stdin, stdout, and stderr are unoriented at program startup.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.19.3" href="#7.19.3">7.19.3 Files</a></h4>
<p><!--para 1 -->
A stream is associated with an external file (which may be a physical device) by opening
with state-dependent encoding that does not assuredly end in the initial shift state.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.19.4" href="#7.19.4">7.19.4 Operations on files</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.4.1" href="#7.19.4.1">7.19.4.1 The remove function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The remove function returns zero if the operation succeeds, nonzero if it fails.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.4.2" href="#7.19.4.2">7.19.4.2 The rename function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
or that it is necessary to copy its contents to effectuate its renaming.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.4.3" href="#7.19.4.3">7.19.4.3 The tmpfile function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
cannot be created, the tmpfile function returns a null pointer.
<p><b> Forward references</b>: the fopen function (<a href="#7.19.5.3">7.19.5.3</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.4.4" href="#7.19.4.4">7.19.4.4 The tmpnam function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
is ended, and before program termination.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.19.5" href="#7.19.5">7.19.5 File access functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.5.1" href="#7.19.5.1">7.19.5.1 The fclose function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The fclose function returns zero if the stream was successfully closed, or EOF if any
errors were detected.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.5.2" href="#7.19.5.2">7.19.5.2 The fflush function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
error occurs, otherwise it returns zero.
<p><b> Forward references</b>: the fopen function (<a href="#7.19.5.3">7.19.5.3</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.5.3" href="#7.19.5.3">7.19.5.3 The fopen function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
conform to the properties in <a href="#7.19.2">7.19.2</a>).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.5.4" href="#7.19.5.4">7.19.5.4 The freopen function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
returned by the fopen function may be assigned.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.5.5" href="#7.19.5.5">7.19.5.5 The setbuf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The setbuf function returns no value.
<p><b> Forward references</b>: the setvbuf function (<a href="#7.19.5.6">7.19.5.6</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.5.6" href="#7.19.5.6">7.19.5.6 The setvbuf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
before a buffer that has automatic storage duration is deallocated upon block exit.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.19.6" href="#7.19.6">7.19.6 Formatted input/output functions</a></h4>
<p><!--para 1 -->
The formatted input/output functions shall behave as if there is a sequence point after the
<p><small><a name="note240" href="#note240">240)</a> The fprintf functions perform writes to memory for the %n specifier.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.6.1" href="#7.19.6.1">7.19.6.1 The fprintf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
the case of fixed-point conversion by the source value as well.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.6.2" href="#7.19.6.2">7.19.6.2 The fscanf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><small><a name="note253" href="#note253">253)</a> See ''future library directions'' (<a href="#7.26.9">7.26.9</a>).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.6.3" href="#7.19.6.3">7.19.6.3 The printf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The printf function returns the number of characters transmitted, or a negative value if
an output or encoding error occurred.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.6.4" href="#7.19.6.4">7.19.6.4 The scanf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
assigned, which can be fewer than provided for, or even zero, in the event of an early
matching failure.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.6.5" href="#7.19.6.5">7.19.6.5 The snprintf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
value if an encoding error occurred. Thus, the null-terminated output has been
completely written if and only if the returned value is nonnegative and less than n.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.6.6" href="#7.19.6.6">7.19.6.6 The sprintf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The sprintf function returns the number of characters written in the array, not
counting the terminating null character, or a negative value if an encoding error occurred.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.6.7" href="#7.19.6.7">7.19.6.7 The sscanf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
early matching failure.
<!--page 304 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.6.8" href="#7.19.6.8">7.19.6.8 The vfprintf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
vsscanf invoke the va_arg macro, the value of arg after the return is indeterminate.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.6.9" href="#7.19.6.9">7.19.6.9 The vfscanf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
items assigned, which can be fewer than provided for, or even zero, in the event of an
early matching failure.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.6.10" href="#7.19.6.10">7.19.6.10 The vprintf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
if an output or encoding error occurred.
<!--page 306 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.6.11" href="#7.19.6.11">7.19.6.11 The vscanf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
items assigned, which can be fewer than provided for, or even zero, in the event of an
early matching failure.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.6.12" href="#7.19.6.12">7.19.6.12 The vsnprintf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
completely written if and only if the returned value is nonnegative and less than n.
<!--page 307 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.6.13" href="#7.19.6.13">7.19.6.13 The vsprintf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The vsprintf function returns the number of characters written in the array, not
counting the terminating null character, or a negative value if an encoding error occurred.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.6.14" href="#7.19.6.14">7.19.6.14 The vsscanf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
early matching failure.
<!--page 308 -->
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.19.7" href="#7.19.7">7.19.7 Character input/output functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.7.1" href="#7.19.7.1">7.19.7.1 The fgetc function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><small><a name="note255" href="#note255">255)</a> An end-of-file and a read error can be distinguished by use of the feof and ferror functions.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.7.2" href="#7.19.7.2">7.19.7.2 The fgets function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<!--page 309 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.7.3" href="#7.19.7.3">7.19.7.3 The fputc function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The fputc function returns the character written. If a write error occurs, the error
indicator for the stream is set and fputc returns EOF.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.7.4" href="#7.19.7.4">7.19.7.4 The fputs function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The fputs function returns EOF if a write error occurs; otherwise it returns a
nonnegative value.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.7.5" href="#7.19.7.5">7.19.7.5 The getc function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
getc returns EOF. If a read error occurs, the error indicator for the stream is set and
getc returns EOF.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.7.6" href="#7.19.7.6">7.19.7.6 The getchar function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
getchar returns EOF. If a read error occurs, the error indicator for the stream is set and
getchar returns EOF.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.7.7" href="#7.19.7.7">7.19.7.7 The gets function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><b> Forward references</b>: future library directions (<a href="#7.26.9">7.26.9</a>).
<!--page 311 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.7.8" href="#7.19.7.8">7.19.7.8 The putc function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The putc function returns the character written. If a write error occurs, the error
indicator for the stream is set and putc returns EOF.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.7.9" href="#7.19.7.9">7.19.7.9 The putchar function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The putchar function returns the character written. If a write error occurs, the error
indicator for the stream is set and putchar returns EOF.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.7.10" href="#7.19.7.10">7.19.7.10 The puts function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
value.
<!--page 312 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.7.11" href="#7.19.7.11">7.19.7.11 The ungetc function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><small><a name="note256" href="#note256">256)</a> See ''future library directions'' (<a href="#7.26.9">7.26.9</a>).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.19.8" href="#7.19.8">7.19.8 Direct input/output functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.8.1" href="#7.19.8.1">7.19.8.1 The fread function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
fread returns zero and the contents of the array and the state of the stream remain
unchanged.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.8.2" href="#7.19.8.2">7.19.8.2 The fwrite function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
less than nmemb only if a write error is encountered. If size or nmemb is zero,
fwrite returns zero and the state of the stream remains unchanged.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.19.9" href="#7.19.9">7.19.9 File positioning functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.9.1" href="#7.19.9.1">7.19.9.1 The fgetpos function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
returns nonzero and stores an implementation-defined positive value in errno.
<p><b> Forward references</b>: the fsetpos function (<a href="#7.19.9.3">7.19.9.3</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.9.2" href="#7.19.9.2">7.19.9.2 The fseek function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The fseek function returns nonzero only for a request that cannot be satisfied.
<p><b> Forward references</b>: the ftell function (<a href="#7.19.9.4">7.19.9.4</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.9.3" href="#7.19.9.3">7.19.9.3 The fsetpos function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
If successful, the fsetpos function returns zero; on failure, the fsetpos function
returns nonzero and stores an implementation-defined positive value in errno.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.9.4" href="#7.19.9.4">7.19.9.4 The ftell function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
for the stream. On failure, the ftell function returns -1L and stores an
implementation-defined positive value in errno.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.9.5" href="#7.19.9.5">7.19.9.5 The rewind function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The rewind function returns no value.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.19.10" href="#7.19.10">7.19.10 Error-handling functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.10.1" href="#7.19.10.1">7.19.10.1 The clearerr function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The clearerr function returns no value.
<!--page 317 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.10.2" href="#7.19.10.2">7.19.10.2 The feof function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The feof function returns nonzero if and only if the end-of-file indicator is set for
stream.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.10.3" href="#7.19.10.3">7.19.10.3 The ferror function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The ferror function returns nonzero if and only if the error indicator is set for
stream.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.19.10.4" href="#7.19.10.4">7.19.10.4 The perror function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><b> Forward references</b>: the strerror function (<a href="#7.21.6.2">7.21.6.2</a>).
<!--page 318 -->
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.20" href="#7.20">7.20 General utilities <stdlib.h></a></h3>
<p><!--para 1 -->
The header <a href="#7.20"><stdlib.h></a> declares five types and several functions of general utility, and
<p><small><a name="note257" href="#note257">257)</a> See ''future library directions'' (<a href="#7.26.10">7.26.10</a>).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.20.1" href="#7.20.1">7.20.1 Numeric conversion functions</a></h4>
<p><!--para 1 -->
The functions atof, atoi, atol, and atoll need not affect the value of the integer
expression errno on an error. If the value of the result cannot be represented, the
behavior is undefined.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.1.1" href="#7.20.1.1">7.20.1.1 The atof function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The atof function returns the converted value.
<p><b> Forward references</b>: the strtod, strtof, and strtold functions (<a href="#7.20.1.3">7.20.1.3</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.1.2" href="#7.20.1.2">7.20.1.2 The atoi, atol, and atoll functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
(<a href="#7.20.1.4">7.20.1.4</a>).
<!--page 320 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.1.3" href="#7.20.1.3">7.20.1.3 The strtod, strtof, and strtold functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
to the same internal floating value, but if not will round to adjacent values.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.1.4" href="#7.20.1.4">7.20.1.4 The strtol, strtoll, strtoul, and strtoull functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
and sign of the value, if any), and the value of the macro ERANGE is stored in errno.
<!--page 324 -->
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.20.2" href="#7.20.2">7.20.2 Pseudo-random sequence generation functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.2.1" href="#7.20.2.1">7.20.2.1 The rand function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 5 -->
The value of the RAND_MAX macro shall be at least 32767.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.2.2" href="#7.20.2.2">7.20.2.2 The srand function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.20.3" href="#7.20.3">7.20.3 Memory management functions</a></h4>
<p><!--para 1 -->
The order and contiguity of storage allocated by successive calls to the calloc,
defined: either a null pointer is returned, or the behavior is as if the size were some
nonzero value, except that the returned pointer shall not be used to access an object.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.3.1" href="#7.20.3.1">7.20.3.1 The calloc function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
constant.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.3.2" href="#7.20.3.2">7.20.3.2 The free function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The free function returns no value.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.3.3" href="#7.20.3.3">7.20.3.3 The malloc function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The malloc function returns either a null pointer or a pointer to the allocated space.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.3.4" href="#7.20.3.4">7.20.3.4 The realloc function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
allocated.
<!--page 327 -->
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.20.4" href="#7.20.4">7.20.4 Communication with the environment</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.4.1" href="#7.20.4.1">7.20.4.1 The abort function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The abort function does not return to its caller.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.4.2" href="#7.20.4.2">7.20.4.2 The atexit function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The atexit function returns zero if the registration succeeds, nonzero if it fails.
<p><b> Forward references</b>: the exit function (<a href="#7.20.4.3">7.20.4.3</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.4.3" href="#7.20.4.3">7.20.4.3 The exit function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
other registered functions.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.4.4" href="#7.20.4.4">7.20.4.4 The _Exit function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<!--page 329 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.4.5" href="#7.20.4.5">7.20.4.5 The getenv function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
overwritten by a subsequent call to the getenv function. If the specified name cannot
be found, a null pointer is returned.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.4.6" href="#7.20.4.6">7.20.4.6 The system function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
function does return, it returns an implementation-defined value.
<!--page 330 -->
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.20.5" href="#7.20.5">7.20.5 Searching and sorting utilities</a></h4>
<p><!--para 1 -->
These utilities make use of a comparison function to search or sort arrays of unspecified
</pre>
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.5.1" href="#7.20.5.1">7.20.5.1 The bsearch function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><small><a name="note264" href="#note264">264)</a> In practice, the entire array is sorted according to the comparison function.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.5.2" href="#7.20.5.2">7.20.5.2 The qsort function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<!--page 332 -->
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.20.6" href="#7.20.6">7.20.6 Integer arithmetic functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.6.1" href="#7.20.6.1">7.20.6.1 The abs, labs and llabs functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><small><a name="note265" href="#note265">265)</a> The absolute value of the most negative number cannot be represented in two's complement.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.6.2" href="#7.20.6.2">7.20.6.2 The div, ldiv, and lldiv functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<!--page 333 -->
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.20.7" href="#7.20.7">7.20.7 Multibyte/wide character conversion functions</a></h4>
<p><!--para 1 -->
The behavior of the multibyte character functions is affected by the LC_CTYPE category
character codes, but are grouped with an adjacent multibyte character.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.7.1" href="#7.20.7.1">7.20.7.1 The mblen function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<!--page 334 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.7.2" href="#7.20.7.2">7.20.7.2 The mbtowc function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
In no case will the value returned be greater than n or the value of the MB_CUR_MAX
macro.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.7.3" href="#7.20.7.3">7.20.7.3 The wctomb function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 5 -->
In no case will the value returned be greater than the value of the MB_CUR_MAX macro.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.20.8" href="#7.20.8">7.20.8 Multibyte/wide string conversion functions</a></h4>
<p><!--para 1 -->
The behavior of the multibyte string functions is affected by the LC_CTYPE category of
the current locale.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.8.1" href="#7.20.8.1">7.20.8.1 The mbstowcs function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><small><a name="note267" href="#note267">267)</a> The array will not be null-terminated if the value returned is n.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.20.8.2" href="#7.20.8.2">7.20.8.2 The wcstombs function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
any.<sup><a href="#note267"><b>267)</b></a></sup>
<!--page 337 -->
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.21" href="#7.21">7.21 String handling <string.h></a></h3>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.21.1" href="#7.21.1">7.21.1 String function conventions</a></h4>
<p><!--para 1 -->
The header <a href="#7.21"><string.h></a> declares one type and several functions, and defines one
<p><small><a name="note268" href="#note268">268)</a> See ''future library directions'' (<a href="#7.26.11">7.26.11</a>).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.21.2" href="#7.21.2">7.21.2 Copying functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.21.2.1" href="#7.21.2.1">7.21.2.1 The memcpy function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<!--page 338 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.21.2.2" href="#7.21.2.2">7.21.2.2 The memmove function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The memmove function returns the value of s1.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.21.2.3" href="#7.21.2.3">7.21.2.3 The strcpy function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The strcpy function returns the value of s1.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.21.2.4" href="#7.21.2.4">7.21.2.4 The strncpy function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
not be null-terminated.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.21.3" href="#7.21.3">7.21.3 Concatenation functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.21.3.1" href="#7.21.3.1">7.21.3.1 The strcat function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The strcat function returns the value of s1.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.21.3.2" href="#7.21.3.2">7.21.3.2 The strncat function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
strlen(s1)+n+1.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.21.4" href="#7.21.4">7.21.4 Comparison functions</a></h4>
<p><!--para 1 -->
The sign of a nonzero value returned by the comparison functions memcmp, strcmp,
pair of characters (both interpreted as unsigned char) that differ in the objects being
compared.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.21.4.1" href="#7.21.4.1">7.21.4.1 The memcmp function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
comparison.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.21.4.2" href="#7.21.4.2">7.21.4.2 The strcmp function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<!--page 341 -->
pointed to by s2.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.21.4.3" href="#7.21.4.3">7.21.4.3 The strcoll function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
accordingly as the string pointed to by s1 is greater than, equal to, or less than the string
pointed to by s2 when both are interpreted as appropriate to the current locale.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.21.4.4" href="#7.21.4.4">7.21.4.4 The strncmp function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
accordingly as the possibly null-terminated array pointed to by s1 is greater than, equal
to, or less than the possibly null-terminated array pointed to by s2.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.21.4.5" href="#7.21.4.5">7.21.4.5 The strxfrm function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.21.5" href="#7.21.5">7.21.5 Search functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.21.5.1" href="#7.21.5.1">7.21.5.1 The memchr function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The memchr function returns a pointer to the located character, or a null pointer if the
character does not occur in the object.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.21.5.2" href="#7.21.5.2">7.21.5.2 The strchr function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
character does not occur in the string.
<!--page 343 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.21.5.3" href="#7.21.5.3">7.21.5.3 The strcspn function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The strcspn function returns the length of the segment.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.21.5.4" href="#7.21.5.4">7.21.5.4 The strpbrk function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The strpbrk function returns a pointer to the character, or a null pointer if no character
from s2 occurs in s1.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.21.5.5" href="#7.21.5.5">7.21.5.5 The strrchr function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
occur in the string.
<!--page 344 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.21.5.6" href="#7.21.5.6">7.21.5.6 The strspn function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The strspn function returns the length of the segment.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.21.5.7" href="#7.21.5.7">7.21.5.7 The strstr function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The strstr function returns a pointer to the located string, or a null pointer if the string
is not found. If s2 points to a string with zero length, the function returns s1.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.21.5.8" href="#7.21.5.8">7.21.5.8 The strtok function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.21.6" href="#7.21.6">7.21.6 Miscellaneous functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.21.6.1" href="#7.21.6.1">7.21.6.1 The memset function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The memset function returns the value of s.
<!--page 346 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.21.6.2" href="#7.21.6.2">7.21.6.2 The strerror function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
specific. The array pointed to shall not be modified by the program, but may be
overwritten by a subsequent call to the strerror function.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.21.6.3" href="#7.21.6.3">7.21.6.3 The strlen function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
character.
<!--page 347 -->
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.22" href="#7.22">7.22 Type-generic math <tgmath.h></a></h3>
<p><!--para 1 -->
The header <a href="#7.22"><tgmath.h></a> includes the headers <a href="#7.12"><math.h></a> and <a href="#7.3"><complex.h></a> and
the behavior is undefined.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.23" href="#7.23">7.23 Date and time <time.h></a></h3>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.23.1" href="#7.23.1">7.23.1 Components of time</a></h4>
<p><!--para 1 -->
The header <a href="#7.23"><time.h></a> defines two macros, and declares several types and functions for
<p><small><a name="note274" href="#note274">274)</a> The range [0, 60] for tm_sec allows for a positive leap second.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.23.2" href="#7.23.2">7.23.2 Time manipulation functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.23.2.1" href="#7.23.2.1">7.23.2.1 The clock function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
the program and its return value subtracted from the value returned by subsequent calls.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.23.2.2" href="#7.23.2.2">7.23.2.2 The difftime function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<!--page 352 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.23.2.3" href="#7.23.2.3">7.23.2.3 The mktime function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
causes it to attempt to determine whether Daylight Saving Time is in effect for the specified time.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.23.2.4" href="#7.23.2.4">7.23.2.4 The time function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
available. If timer is not a null pointer, the return value is also assigned to the object it
points to.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.23.3" href="#7.23.3">7.23.3 Time conversion functions</a></h4>
<p><!--para 1 -->
Except for the strftime function, these functions each return a pointer to one of two
previous call to any of them. The implementation shall behave as if no other library
functions call these functions.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.23.3.1" href="#7.23.3.1">7.23.3.1 The asctime function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The asctime function returns a pointer to the string.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.23.3.2" href="#7.23.3.2">7.23.3.2 The ctime function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><b> Forward references</b>: the localtime function (<a href="#7.23.3.4">7.23.3.4</a>).
<!--page 355 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.23.3.3" href="#7.23.3.3">7.23.3.3 The gmtime function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The gmtime function returns a pointer to the broken-down time, or a null pointer if the
specified time cannot be converted to UTC.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.23.3.4" href="#7.23.3.4">7.23.3.4 The localtime function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The localtime function returns a pointer to the broken-down time, or a null pointer if
the specified time cannot be converted to local time.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.23.3.5" href="#7.23.3.5">7.23.3.5 The strftime function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
zero is returned and the contents of the array are indeterminate.
<!--page 360 -->
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.24" href="#7.24">7.24 Extended multibyte and wide character utilities <wchar.h></a></h3>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.24.1" href="#7.24.1">7.24.1 Introduction</a></h4>
<p><!--para 1 -->
The header <a href="#7.24"><wchar.h></a> declares four data types, one tag, four macros, and many
<p><small><a name="note279" href="#note279">279)</a> The value of the macro WEOF may differ from that of EOF and need not be negative.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.24.2" href="#7.24.2">7.24.2 Formatted wide character input/output functions</a></h4>
<p><!--para 1 -->
The formatted wide character input/output functions shall behave as if there is a sequence
<p><small><a name="note280" href="#note280">280)</a> The fwprintf functions perform writes to memory for the %n specifier.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.2.1" href="#7.24.2.1">7.24.2.1 The fwprintf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
the case of fixed-point conversion by the source value as well.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.2.2" href="#7.24.2.2">7.24.2.2 The fwscanf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><small><a name="note290" href="#note290">290)</a> See ''future library directions'' (<a href="#7.26.12">7.26.12</a>).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.2.3" href="#7.24.2.3">7.24.2.3 The swprintf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
counting the terminating null wide character, or a negative value if an encoding error
occurred or if n or more wide characters were requested to be written.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.2.4" href="#7.24.2.4">7.24.2.4 The swscanf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
early matching failure.
<!--page 375 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.2.5" href="#7.24.2.5">7.24.2.5 The vfwprintf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
invoke the va_arg macro, the value of arg after the return is indeterminate.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.2.6" href="#7.24.2.6">7.24.2.6 The vfwscanf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
items assigned, which can be fewer than provided for, or even zero, in the event of an
early matching failure.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.2.7" href="#7.24.2.7">7.24.2.7 The vswprintf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
occurred or if n or more wide characters were requested to be generated.
<!--page 377 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.2.8" href="#7.24.2.8">7.24.2.8 The vswscanf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
items assigned, which can be fewer than provided for, or even zero, in the event of an
early matching failure.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.2.9" href="#7.24.2.9">7.24.2.9 The vwprintf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
value if an output or encoding error occurred.
<!--page 378 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.2.10" href="#7.24.2.10">7.24.2.10 The vwscanf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
items assigned, which can be fewer than provided for, or even zero, in the event of an
early matching failure.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.2.11" href="#7.24.2.11">7.24.2.11 The wprintf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The wprintf function returns the number of wide characters transmitted, or a negative
value if an output or encoding error occurred.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.2.12" href="#7.24.2.12">7.24.2.12 The wscanf function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
items assigned, which can be fewer than provided for, or even zero, in the event of an
early matching failure.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.24.3" href="#7.24.3">7.24.3 Wide character input/output functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.3.1" href="#7.24.3.1">7.24.3.1 The fgetwc function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
Also, errno will be set to EILSEQ by input/output functions only if an encoding error occurs.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.3.2" href="#7.24.3.2">7.24.3.2 The fgetws function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
null pointer is returned. If a read or encoding error occurs during the operation, the array
contents are indeterminate and a null pointer is returned.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.3.3" href="#7.24.3.3">7.24.3.3 The fputwc function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
error indicator for the stream is set and fputwc returns WEOF. If an encoding error
occurs, the value of the macro EILSEQ is stored in errno and fputwc returns WEOF.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.3.4" href="#7.24.3.4">7.24.3.4 The fputws function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
returns a nonnegative value.
<!--page 381 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.3.5" href="#7.24.3.5">7.24.3.5 The fwide function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><small><a name="note293" href="#note293">293)</a> If the orientation of the stream has already been determined, fwide does not change it.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.3.6" href="#7.24.3.6">7.24.3.6 The getwc function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The getwc function returns the next wide character from the input stream pointed to by
stream, or WEOF.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.3.7" href="#7.24.3.7">7.24.3.7 The getwchar function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The getwchar function returns the next wide character from the input stream pointed to
by stdin, or WEOF.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.3.8" href="#7.24.3.8">7.24.3.8 The putwc function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The putwc function returns the wide character written, or WEOF.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.3.9" href="#7.24.3.9">7.24.3.9 The putwchar function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The putwchar function returns the character written, or WEOF.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.3.10" href="#7.24.3.10">7.24.3.10 The ungetwc function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The ungetwc function returns the wide character pushed back, or WEOF if the operation
fails.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.24.4" href="#7.24.4">7.24.4 General wide string utilities</a></h4>
<p><!--para 1 -->
The header <a href="#7.24"><wchar.h></a> declares a number of functions useful for wide string
zero wide characters.
<!--page 384 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.1" href="#7.24.4.1">7.24.4.1 Wide string numeric conversion functions</a></h5>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.1.1" href="#7.24.4.1.1">7.24.4.1.1 The wcstod, wcstof, and wcstold functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
to the same internal floating value, but if not will round to adjacent values.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.1.2" href="#7.24.4.1.2">7.24.4.1.2 The wcstol, wcstoll, wcstoul, and wcstoull functions</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
LLONG_MAX, ULONG_MAX, or ULLONG_MAX is returned (according to the return type
sign of the value, if any), and the value of the macro ERANGE is stored in errno.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.2" href="#7.24.4.2">7.24.4.2 Wide string copying functions</a></h5>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.2.1" href="#7.24.4.2.1">7.24.4.2.1 The wcscpy function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The wcscpy function returns the value of s1.
<!--page 389 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.2.2" href="#7.24.4.2.2">7.24.4.2.2 The wcsncpy function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
result will not be null-terminated.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.2.3" href="#7.24.4.2.3">7.24.4.2.3 The wmemcpy function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<!--page 390 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.2.4" href="#7.24.4.2.4">7.24.4.2.4 The wmemmove function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The wmemmove function returns the value of s1.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.3" href="#7.24.4.3">7.24.4.3 Wide string concatenation functions</a></h5>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.3.1" href="#7.24.4.3.1">7.24.4.3.1 The wcscat function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The wcscat function returns the value of s1.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.3.2" href="#7.24.4.3.2">7.24.4.3.2 The wcsncat function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
wcslen(s1)+n+1.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.4" href="#7.24.4.4">7.24.4.4 Wide string comparison functions</a></h5>
<p><!--para 1 -->
Unless explicitly stated otherwise, the functions described in this subclause order two
wide characters the same way as two integers of the underlying integer type designated
by wchar_t.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.4.1" href="#7.24.4.4.1">7.24.4.4.1 The wcscmp function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
accordingly as the wide string pointed to by s1 is greater than, equal to, or less than the
wide string pointed to by s2.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.4.2" href="#7.24.4.4.2">7.24.4.4.2 The wcscoll function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
wide string pointed to by s2 when both are interpreted as appropriate to the current
locale.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.4.3" href="#7.24.4.4.3">7.24.4.4.3 The wcsncmp function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
accordingly as the possibly null-terminated array pointed to by s1 is greater than, equal
to, or less than the possibly null-terminated array pointed to by s2.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.4.4" href="#7.24.4.4.4">7.24.4.4.4 The wcsxfrm function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.4.5" href="#7.24.4.4.5">7.24.4.4.5 The wmemcmp function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
accordingly as the object pointed to by s1 is greater than, equal to, or less than the object
pointed to by s2.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.5" href="#7.24.4.5">7.24.4.5 Wide string search functions</a></h5>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.5.1" href="#7.24.4.5.1">7.24.4.5.1 The wcschr function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The wcschr function returns a pointer to the located wide character, or a null pointer if
the wide character does not occur in the wide string.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.5.2" href="#7.24.4.5.2">7.24.4.5.2 The wcscspn function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The wcscspn function returns the length of the segment.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.5.3" href="#7.24.4.5.3">7.24.4.5.3 The wcspbrk function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The wcspbrk function returns a pointer to the wide character in s1, or a null pointer if
no wide character from s2 occurs in s1.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.5.4" href="#7.24.4.5.4">7.24.4.5.4 The wcsrchr function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The wcsrchr function returns a pointer to the wide character, or a null pointer if c does
not occur in the wide string.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.5.5" href="#7.24.4.5.5">7.24.4.5.5 The wcsspn function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The wcsspn function returns the length of the segment.
<!--page 395 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.5.6" href="#7.24.4.5.6">7.24.4.5.6 The wcsstr function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
wide string is not found. If s2 points to a wide string with zero length, the function
returns s1.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.5.7" href="#7.24.4.5.7">7.24.4.5.7 The wcstok function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.5.8" href="#7.24.4.5.8">7.24.4.5.8 The wmemchr function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
the wide character does not occur in the object.
<!--page 397 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.6" href="#7.24.4.6">7.24.4.6 Miscellaneous functions</a></h5>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.6.1" href="#7.24.4.6.1">7.24.4.6.1 The wcslen function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The wcslen function returns the number of wide characters that precede the terminating
null wide character.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.4.6.2" href="#7.24.4.6.2">7.24.4.6.2 The wmemset function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 3 -->
The wmemset function returns the value of s.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.24.5" href="#7.24.5">7.24.5 Wide character time conversion functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.5.1" href="#7.24.5.1">7.24.5.1 The wcsftime function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
wide character. Otherwise, zero is returned and the contents of the array are
indeterminate.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.24.6" href="#7.24.6">7.24.6 Extended multibyte/wide character conversion utilities</a></h4>
<p><!--para 1 -->
The header <a href="#7.24"><wchar.h></a> declares an extended set of functions useful for conversion
character string.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.6.1" href="#7.24.6.1">7.24.6.1 Single-byte/wide character conversion functions</a></h5>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.6.1.1" href="#7.24.6.1.1">7.24.6.1.1 The btowc function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
does not constitute a valid single-byte character in the initial shift state. Otherwise, it
returns the wide character representation of that character.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.6.1.2" href="#7.24.6.1.2">7.24.6.1.2 The wctob function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
length one in the initial shift state. Otherwise, it returns the single-byte representation of
that character as an unsigned char converted to an int.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.6.2" href="#7.24.6.2">7.24.6.2 Conversion state functions</a></h5>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.6.2.1" href="#7.24.6.2.1">7.24.6.2.1 The mbsinit function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The mbsinit function returns nonzero if ps is a null pointer or if the pointed-to object
describes an initial conversion state; otherwise, it returns zero.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.6.3" href="#7.24.6.3">7.24.6.3 Restartable multibyte/wide character conversion functions</a></h5>
<p><!--para 1 -->
These functions differ from the corresponding multibyte character functions of <a href="#7.20.7">7.20.7</a>
Also unlike their corresponding functions, the return value does not represent whether the
encoding is state-dependent.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.6.3.1" href="#7.24.6.3.1">7.24.6.3.1 The mbrlen function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><b> Forward references</b>: the mbrtowc function (<a href="#7.24.6.3.2">7.24.6.3.2</a>).
<!--page 401 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.6.3.2" href="#7.24.6.3.2">7.24.6.3.2 The mbrtowc function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
sequence of redundant shift sequences (for implementations with state-dependent encodings).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.6.3.3" href="#7.24.6.3.3">7.24.6.3.3 The wcrtomb function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
the function stores the value of the macro EILSEQ in errno and returns
(size_t)(-1); the conversion state is unspecified.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.6.4" href="#7.24.6.4">7.24.6.4 Restartable multibyte/wide string conversion functions</a></h5>
<p><!--para 1 -->
These functions differ from the corresponding multibyte string functions of <a href="#7.20.8">7.20.8</a>
to reflect the amount of the source processed by that invocation.
<!--page 403 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.6.4.1" href="#7.24.6.4.1">7.24.6.4.1 The mbsrtowcs function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><small><a name="note301" href="#note301">301)</a> Thus, the value of len is ignored if dst is a null pointer.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.24.6.4.2" href="#7.24.6.4.2">7.24.6.4.2 The wcsrtombs function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
include those necessary to reach the initial shift state immediately before the null byte.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.25" href="#7.25">7.25 Wide character classification and mapping utilities <wctype.h></a></h3>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.25.1" href="#7.25.1">7.25.1 Introduction</a></h4>
<p><!--para 1 -->
The header <a href="#7.25"><wctype.h></a> declares three data types, one macro, and many functions.<sup><a href="#note303"><b>303)</b></a></sup>
<p><small><a name="note303" href="#note303">303)</a> See ''future library directions'' (<a href="#7.26.13">7.26.13</a>).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.25.2" href="#7.25.2">7.25.2 Wide character classification utilities</a></h4>
<p><!--para 1 -->
The header <a href="#7.25"><wctype.h></a> declares several functions useful for classifying wide
term control wide character refers to a member of a locale-specific set of wide characters
that are not printing wide characters.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.25.2.1" href="#7.25.2.1">7.25.2.1 Wide character classification functions</a></h5>
<p><!--para 1 -->
The functions in this subclause return nonzero (true) if and only if the value of the
&& iswspace(wc) is true, but not both.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.25.2.1.1" href="#7.25.2.1.1">7.25.2.1.1 The iswalnum function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The iswalnum function tests for any wide character for which iswalpha or
iswdigit is true.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.25.2.1.2" href="#7.25.2.1.2">7.25.2.1.2 The iswalpha function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
wide characters; all four combinations are possible.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.25.2.1.3" href="#7.25.2.1.3">7.25.2.1.3 The iswblank function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
characters are the following: space (L' '), and horizontal tab (L'\t'). In the "C"
locale, iswblank returns true only for the standard blank characters.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.25.2.1.4" href="#7.25.2.1.4">7.25.2.1.4 The iswcntrl function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 2 -->
The iswcntrl function tests for any control wide character.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.25.2.1.5" href="#7.25.2.1.5">7.25.2.1.5 The iswdigit function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The iswdigit function tests for any wide character that corresponds to a decimal-digit
character (as defined in <a href="#5.2.1">5.2.1</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.25.2.1.6" href="#7.25.2.1.6">7.25.2.1.6 The iswgraph function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
characters other than ' '.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.25.2.1.7" href="#7.25.2.1.7">7.25.2.1.7 The iswlower function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
letter or is one of a locale-specific set of wide characters for which none of iswcntrl,
iswdigit, iswpunct, or iswspace is true.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.25.2.1.8" href="#7.25.2.1.8">7.25.2.1.8 The iswprint function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
<p><!--para 2 -->
The iswprint function tests for any printing wide character.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.25.2.1.9" href="#7.25.2.1.9">7.25.2.1.9 The iswpunct function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
specific set of punctuation wide characters for which neither iswspace nor iswalnum
is true.<sup><a href="#note306"><b>306)</b></a></sup>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.25.2.1.10" href="#7.25.2.1.10">7.25.2.1.10 The iswspace function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
set of white-space wide characters for which none of iswalnum, iswgraph, or
iswpunct is true.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.25.2.1.11" href="#7.25.2.1.11">7.25.2.1.11 The iswupper function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
letter or is one of a locale-specific set of wide characters for which none of iswcntrl,
iswdigit, iswpunct, or iswspace is true.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.25.2.1.12" href="#7.25.2.1.12">7.25.2.1.12 The iswxdigit function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The iswxdigit function tests for any wide character that corresponds to a
hexadecimal-digit character (as defined in <a href="#6.4.4.1">6.4.4.1</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.25.2.2" href="#7.25.2.2">7.25.2.2 Extensible wide character classification functions</a></h5>
<p><!--para 1 -->
The functions wctype and iswctype provide extensible wide character classification
as well as testing equivalent to that performed by the functions described in the previous
subclause (<a href="#7.25.2.1">7.25.2.1</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.25.2.2.1" href="#7.25.2.2.1">7.25.2.2.1 The iswctype function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
character wc has the property described by desc.
<p><b> Forward references</b>: the wctype function (<a href="#7.25.2.2.2">7.25.2.2.2</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.25.2.2.2" href="#7.25.2.2.2">7.25.2.2.2 The wctype function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
as the second argument to the iswctype function; otherwise, it returns zero. *
<!--page 411 -->
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.25.3" href="#7.25.3">7.25.3 Wide character case mapping utilities</a></h4>
<p><!--para 1 -->
The header <a href="#7.25"><wctype.h></a> declares several functions useful for mapping wide characters.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.25.3.1" href="#7.25.3.1">7.25.3.1 Wide character case mapping functions</a></h5>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.25.3.1.1" href="#7.25.3.1.1">7.25.3.1.1 The towlower function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
characters (always the same one for any given locale); otherwise, the argument is
returned unchanged.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.25.3.1.2" href="#7.25.3.1.2">7.25.3.1.2 The towupper function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
characters (always the same one for any given locale); otherwise, the argument is
returned unchanged.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.25.3.2" href="#7.25.3.2">7.25.3.2 Extensible wide character case mapping functions</a></h5>
<p><!--para 1 -->
The functions wctrans and towctrans provide extensible wide character mapping as
previous subclause (<a href="#7.25.3.1">7.25.3.1</a>).
<!--page 412 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.25.3.2.1" href="#7.25.3.2.1">7.25.3.2.1 The towctrans function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
The towctrans function returns the mapped value of wc using the mapping described
by desc.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="7.25.3.2.2" href="#7.25.3.2.2">7.25.3.2.2 The wctrans function</a></h5>
<p><b>Synopsis</b>
<p><!--para 1 -->
as the second argument to the towctrans function; otherwise, it returns zero.
<!--page 413 -->
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="7.26" href="#7.26">7.26 Future library directions</a></h3>
<p><!--para 1 -->
The following names are grouped under individual headers for convenience. All external
names described below are reserved no matter what headers are included by the program.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.26.1" href="#7.26.1">7.26.1 Complex arithmetic <complex.h></a></h4>
<p><!--para 1 -->
The function names
and the same names suffixed with f or l may be added to the declarations in the
<a href="#7.3"><complex.h></a> header.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.26.2" href="#7.26.2">7.26.2 Character handling <ctype.h></a></h4>
<p><!--para 1 -->
Function names that begin with either is or to, and a lowercase letter may be added to
the declarations in the <a href="#7.4"><ctype.h></a> header.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.26.3" href="#7.26.3">7.26.3 Errors <errno.h></a></h4>
<p><!--para 1 -->
Macros that begin with E and a digit or E and an uppercase letter may be added to the
declarations in the <a href="#7.5"><errno.h></a> header.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.26.4" href="#7.26.4">7.26.4 Format conversion of integer types <inttypes.h></a></h4>
<p><!--para 1 -->
Macro names beginning with PRI or SCN followed by any lowercase letter or X may be
added to the macros defined in the <a href="#7.8"><inttypes.h></a> header.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.26.5" href="#7.26.5">7.26.5 Localization <locale.h></a></h4>
<p><!--para 1 -->
Macros that begin with LC_ and an uppercase letter may be added to the definitions in
the <a href="#7.11"><locale.h></a> header.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.26.6" href="#7.26.6">7.26.6 Signal handling <signal.h></a></h4>
<p><!--para 1 -->
Macros that begin with either SIG and an uppercase letter or SIG_ and an uppercase
letter may be added to the definitions in the <a href="#7.14"><signal.h></a> header.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.26.7" href="#7.26.7">7.26.7 Boolean type and values <stdbool.h></a></h4>
<p><!--para 1 -->
The ability to undefine and perhaps then redefine the macros bool, true, and false is
an obsolescent feature.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.26.8" href="#7.26.8">7.26.8 Integer types <stdint.h></a></h4>
<p><!--para 1 -->
Typedef names beginning with int or uint and ending with _t may be added to the
<a href="#7.18"><stdint.h></a> header.
<!--page 414 -->
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.26.9" href="#7.26.9">7.26.9 Input/output <stdio.h></a></h4>
<p><!--para 1 -->
Lowercase letters may be added to the conversion specifiers and length modifiers in
The use of ungetc on a binary stream where the file position indicator is zero prior to
the call is an obsolescent feature.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.26.10" href="#7.26.10">7.26.10 General utilities <stdlib.h></a></h4>
<p><!--para 1 -->
Function names that begin with str and a lowercase letter may be added to the
declarations in the <a href="#7.20"><stdlib.h></a> header.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.26.11" href="#7.26.11">7.26.11 String handling <string.h></a></h4>
<p><!--para 1 -->
Function names that begin with str, mem, or wcs and a lowercase letter may be added
to the declarations in the <a href="#7.21"><string.h></a> header.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.26.12" href="#7.26.12">7.26.12 Extended multibyte and wide character utilities <wchar.h></a></h4>
<p><!--para 1 -->
Function names that begin with wcs and a lowercase letter may be added to the
Lowercase letters may be added to the conversion specifiers and length modifiers in
fwprintf and fwscanf. Other characters may be used in extensions.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="7.26.13" href="#7.26.13">7.26.13 Wide character classification and mapping utilities</a></h4>
<a href="#7.25"><wctype.h></a>
<p><!--para 1 -->
declarations in the <a href="#7.25"><wctype.h></a> header.
<!--page 415 -->
+<p><small><a href="#Contents">Contents</a></small>
<h2><a name="A" href="#A">Annex A</a></h2>
<pre>
(informative)
NOTE The notation is described in <a href="#6.1">6.1</a>.
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="A.1" href="#A.1">A.1 Lexical grammar</a></h3>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="A.1.1" href="#A.1.1">A.1.1 Lexical elements</a></h4>
(<a href="#6.4">6.4</a>) token:
<pre>
each non-white-space character that cannot be one of the above
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="A.1.2" href="#A.1.2">A.1.2 Keywords</a></h4>
(<a href="#6.4.1">6.4.1</a>) keyword: one of
<!--page 416 -->
else register union
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="A.1.3" href="#A.1.3">A.1.3 Identifiers</a></h4>
(<a href="#6.4.2.1">6.4.2.1</a>) identifier:
<pre>
0 1 2 3 4 5 6 7 8 9
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="A.1.4" href="#A.1.4">A.1.4 Universal character names</a></h4>
(<a href="#6.4.3">6.4.3</a>) universal-character-name:
<pre>
hexadecimal-digit hexadecimal-digit
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="A.1.5" href="#A.1.5">A.1.5 Constants</a></h4>
(<a href="#6.4.4">6.4.4</a>) constant:
<pre>
hexadecimal-escape-sequence hexadecimal-digit
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="A.1.6" href="#A.1.6">A.1.6 String literals</a></h4>
(<a href="#6.4.5">6.4.5</a>) string-literal:
<pre>
escape-sequence
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="A.1.7" href="#A.1.7">A.1.7 Punctuators</a></h4>
(<a href="#6.4.6">6.4.6</a>) punctuator: one of
<pre>
<: :> <% %> %: %:%:
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="A.1.8" href="#A.1.8">A.1.8 Header names</a></h4>
(<a href="#6.4.7">6.4.7</a>) header-name:
<pre>
the new-line character and "
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="A.1.9" href="#A.1.9">A.1.9 Preprocessing numbers</a></h4>
(<a href="#6.4.8">6.4.8</a>) pp-number:
<!--page 421 -->
pp-number .
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="A.2" href="#A.2">A.2 Phrase structure grammar</a></h3>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="A.2.1" href="#A.2.1">A.2.1 Expressions</a></h4>
(<a href="#6.5.1">6.5.1</a>) primary-expression:
<pre>
conditional-expression
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="A.2.2" href="#A.2.2">A.2.2 Declarations</a></h4>
(<a href="#6.7">6.7</a>) declaration:
<pre>
. identifier
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="A.2.3" href="#A.2.3">A.2.3 Statements</a></h4>
(<a href="#6.8">6.8</a>) statement:
<pre>
return expression<sub>opt</sub> ;
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="A.2.4" href="#A.2.4">A.2.4 External definitions</a></h4>
(<a href="#6.9">6.9</a>) translation-unit:
<pre>
declaration-list declaration
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="A.3" href="#A.3">A.3 Preprocessing directives</a></h3>
(<a href="#6.10">6.10</a>) preprocessing-file:
<pre>
the new-line character
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h2><a name="B" href="#B">Annex B</a></h2>
<pre>
(informative)
Library summary
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.1" href="#B.1">B.1 Diagnostics <assert.h></a></h3>
<pre>
NDEBUG
void assert(scalar expression);
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.2" href="#B.2">B.2 Complex <complex.h></a></h3>
<!--page 432 -->
<!--page 433 -->
long double creall(long double complex z);
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.3" href="#B.3">B.3 Character handling <ctype.h></a></h3>
<pre>
int isalnum(int c);
int toupper(int c);
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.4" href="#B.4">B.4 Errors <errno.h></a></h3>
<pre>
EDOM EILSEQ ERANGE errno
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.5" href="#B.5">B.5 Floating-point environment <fenv.h></a></h3>
<!--page 434 -->
<pre>
int feupdateenv(const fenv_t *envp);
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.6" href="#B.6">B.6 Characteristics of floating types <float.h></a></h3>
<pre>
FLT_ROUNDS DBL_MIN_EXP FLT_MAX
FLT_MIN_EXP LDBL_MAX_10_EXP
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.7" href="#B.7">B.7 Format conversion of integer types <inttypes.h></a></h3>
<!--page 435 -->
<pre>
wchar_t ** restrict endptr, int base);
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.8" href="#B.8">B.8 Alternative spellings <iso646.h></a></h3>
<pre>
and bitor not_eq xor
bitand not or_eq
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.9" href="#B.9">B.9 Sizes of integer types <limits.h></a></h3>
<pre>
CHAR_BIT CHAR_MAX INT_MIN ULONG_MAX
CHAR_MIN USHRT_MAX LONG_MAX
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.10" href="#B.10">B.10 Localization <locale.h></a></h3>
<pre>
struct lconv LC_ALL LC_CTYPE LC_NUMERIC
struct lconv *localeconv(void);
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.11" href="#B.11">B.11 Mathematics <math.h></a></h3>
<!--page 436 -->
<!--page 437 -->
int isunordered(real-floating x, real-floating y);
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.12" href="#B.12">B.12 Nonlocal jumps <setjmp.h></a></h3>
<pre>
jmp_buf
void longjmp(jmp_buf env, int val);
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.13" href="#B.13">B.13 Signal handling <signal.h></a></h3>
<pre>
sig_atomic_t SIG_IGN SIGILL SIGTERM
int raise(int sig);
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.14" href="#B.14">B.14 Variable arguments <stdarg.h></a></h3>
<pre>
va_list
void va_start(va_list ap, parmN);
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.15" href="#B.15">B.15 Boolean type and values <stdbool.h></a></h3>
<!--page 441 -->
<pre>
__bool_true_false_are_defined
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.16" href="#B.16">B.16 Common definitions <stddef.h></a></h3>
<pre>
ptrdiff_t size_t wchar_t NULL
offsetof(type, member-designator)
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.17" href="#B.17">B.17 Integer types <stdint.h></a></h3>
<pre>
intN_t INT_LEASTN_MIN PTRDIFF_MAX
UINTN_MAX PTRDIFF_MIN
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.18" href="#B.18">B.18 Input/output <stdio.h></a></h3>
<!--page 442 -->
<!--page 443 -->
void perror(const char *s);
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.19" href="#B.19">B.19 General utilities <stdlib.h></a></h3>
<!--page 444 -->
<!--page 445 -->
const wchar_t * restrict pwcs, size_t n);
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.20" href="#B.20">B.20 String handling <string.h></a></h3>
<!--page 446 -->
<pre>
size_t strlen(const char *s);
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.21" href="#B.21">B.21 Type-generic math <tgmath.h></a></h3>
<pre>
acos sqrt fmod nextafter
pow fmin nearbyint creal
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.22" href="#B.22">B.22 Date and time <time.h></a></h3>
<!--page 447 -->
<pre>
const struct tm * restrict timeptr);
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.23" href="#B.23">B.23 Extended multibyte/wide character utilities <wchar.h></a></h3>
<!--page 448 -->
<!--page 449 -->
mbstate_t * restrict ps);
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="B.24" href="#B.24">B.24 Wide character classification and mapping utilities <wctype.h></a></h3>
<!--page 450 -->
<!--page 451 -->
wctrans_t wctrans(const char *property);
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h2><a name="C" href="#C">Annex C</a></h2>
<pre>
(informative)
<!--page 452 -->
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h2><a name="D" href="#D">Annex D</a></h2>
<pre>
(normative)
2133-2138, 2160-2182, 3005-3007, 3021-3029
</table>
+<p><small><a href="#Contents">Contents</a></small>
<h2><a name="E" href="#E">Annex E</a></h2>
<pre>
(informative)
#define LDBL_MIN 1E-37
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h2><a name="F" href="#F">Annex F</a></h2>
<pre>
(normative)
IEC 60559 floating-point arithmetic
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="F.1" href="#F.1">F.1 Introduction</a></h3>
<p><!--para 1 -->
This annex specifies C language support for the IEC 60559 floating-point standard. The
a binding between the C language and IEC 60559 is indicated, the IEC 60559-specified
behavior is adopted by reference, unless stated otherwise.
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="F.2" href="#F.2">F.2 Types</a></h3>
<p><!--para 1 -->
The C floating types match the IEC 60559 formats as follows:
all double values.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="F.2.1" href="#F.2.1">F.2.1 Infinities, signed zeros, and NaNs</a></h4>
<p><!--para 1 -->
This specification does not define the behavior of signaling NaNs.<sup><a href="#note309"><b>309)</b></a></sup> It generally uses
sufficient for closure of the arithmetic.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="F.3" href="#F.3">F.3 Operators and functions</a></h3>
<p><!--para 1 -->
C operators and functions provide IEC 60559 required and recommended facilities as
macros defined in <a href="#7.12.3">7.12.3</a> do not distinguish signaling from quiet NaNs).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="F.4" href="#F.4">F.4 Floating to integer conversion</a></h3>
<p><!--para 1 -->
If the floating value is infinite or NaN or if the integral part of the floating value exceeds
<a href="#7.12"><math.h></a>.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="F.5" href="#F.5">F.5 Binary-decimal conversion</a></h3>
<p><!--para 1 -->
Conversion from the widest supported IEC 60559 format to decimal with
DBL_DIG are 18 and 15, respectively, for these formats.)
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="F.6" href="#F.6">F.6 Contracted expressions</a></h3>
<p><!--para 1 -->
A contracted expression treats infinities, NaNs, signed zeros, subnormals, and the
consistent with the basic arithmetic operations. A contracted expression should deliver
the same value as its uncontracted counterpart, else should be correctly rounded (once).
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="F.7" href="#F.7">F.7 Floating-point environment</a></h3>
<p><!--para 1 -->
The floating-point environment defined in <a href="#7.6"><fenv.h></a> includes the IEC 60559 floating-
<p><small><a name="note312" href="#note312">312)</a> This specification does not require dynamic rounding precision nor trap enablement modes.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="F.7.1" href="#F.7.1">F.7.1 Environment management</a></h4>
<p><!--para 1 -->
IEC 60559 requires that floating-point operations implicitly raise floating-point exception
which allows certain optimizations (see <a href="#F.8">F.8</a>).
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="F.7.2" href="#F.7.2">F.7.2 Translation</a></h4>
<p><!--para 1 -->
During translation the IEC 60559 default modes are in effect:
strtod, provide execution-time conversion of numeric strings.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="F.7.3" href="#F.7.3">F.7.3 Execution</a></h4>
<p><!--para 1 -->
At program startup the floating-point environment is initialized as prescribed by
<li> Trapping or stopping (if supported) is disabled on all floating-point exceptions.
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="F.7.4" href="#F.7.4">F.7.4 Constant expressions</a></h4>
<p><!--para 1 -->
An arithmetic constant expression of floating type, other than one in an initializer for an
</pre>
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="F.7.5" href="#F.7.5">F.7.5 Initialization</a></h4>
<p><!--para 1 -->
All computation for automatic initialization is done (as if) at execution time; thus, it is
could be done at translation time, regardless of the expression evaluation method.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="F.7.6" href="#F.7.6">F.7.6 Changing the environment</a></h4>
<p><!--para 1 -->
Operations defined in <a href="#6.5">6.5</a> and functions and macros defined for the standard libraries
''inexact'', or ''underflow'' and ''inexact''), then ''overflow'' or ''underflow'' is raised
before ''inexact''.
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="F.8" href="#F.8">F.8 Optimization</a></h3>
<p><!--para 1 -->
This section identifies code transformations that might subvert IEC 60559-specified
behavior, and others that do not.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="F.8.1" href="#F.8.1">F.8.1 Global transformations</a></h4>
<p><!--para 1 -->
Floating-point arithmetic operations and external function calls may entail side effects
if (0 < n) x + 1;
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="F.8.2" href="#F.8.2">F.8.2 Expression transformations</a></h4>
<p><!--para 1 -->
<table border=1>
for complex z.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="F.8.3" href="#F.8.3">F.8.3 Relational operators</a></h4>
<p><!--para 1 -->
<table border=1>
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="F.8.4" href="#F.8.4">F.8.4 Constant arithmetic</a></h4>
<p><!--para 1 -->
The implementation shall honor floating-point exceptions raised by execution-time
<p><small><a name="note319" href="#note319">319)</a> 0 - 0 yields -0 instead of +0 just when the rounding direction is downward.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="F.9" href="#F.9">F.9 Mathematics <math.h></a></h3>
<p><!--para 1 -->
This subclause contains specifications of <a href="#7.12"><math.h></a> facilities that are particularly suited
avoiding them would be too costly.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="F.9.1" href="#F.9.1">F.9.1 Trigonometric functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.1.1" href="#F.9.1.1">F.9.1.1 The acos functions</a></h5>
<p><!--para 1 -->
<ul>
<!--page 468 -->
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.1.2" href="#F.9.1.2">F.9.1.2 The asin functions</a></h5>
<p><!--para 1 -->
<ul>
| x | > 1.
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.1.3" href="#F.9.1.3">F.9.1.3 The atan functions</a></h5>
<p><!--para 1 -->
<ul>
<li> atan((+-)(inf)) returns (+-)pi /2.
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.1.4" href="#F.9.1.4">F.9.1.4 The atan2 functions</a></h5>
<p><!--para 1 -->
<ul>
the ''divide-by-zero'' floating-point exception.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.1.5" href="#F.9.1.5">F.9.1.5 The cos functions</a></h5>
<p><!--para 1 -->
<ul>
<li> cos((+-)(inf)) returns a NaN and raises the ''invalid'' floating-point exception.
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.1.6" href="#F.9.1.6">F.9.1.6 The sin functions</a></h5>
<p><!--para 1 -->
<ul>
<!--page 469 -->
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.1.7" href="#F.9.1.7">F.9.1.7 The tan functions</a></h5>
<p><!--para 1 -->
<ul>
<li> tan((+-)(inf)) returns a NaN and raises the ''invalid'' floating-point exception.
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="F.9.2" href="#F.9.2">F.9.2 Hyperbolic functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.2.1" href="#F.9.2.1">F.9.2.1 The acosh functions</a></h5>
<p><!--para 1 -->
<ul>
<li> acosh(+(inf)) returns +(inf).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.2.2" href="#F.9.2.2">F.9.2.2 The asinh functions</a></h5>
<p><!--para 1 -->
<ul>
<li> asinh((+-)(inf)) returns (+-)(inf).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.2.3" href="#F.9.2.3">F.9.2.3 The atanh functions</a></h5>
<p><!--para 1 -->
<ul>
| x | > 1.
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.2.4" href="#F.9.2.4">F.9.2.4 The cosh functions</a></h5>
<p><!--para 1 -->
<ul>
<li> cosh((+-)(inf)) returns +(inf).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.2.5" href="#F.9.2.5">F.9.2.5 The sinh functions</a></h5>
<p><!--para 1 -->
<ul>
<li> sinh((+-)(inf)) returns (+-)(inf).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.2.6" href="#F.9.2.6">F.9.2.6 The tanh functions</a></h5>
<p><!--para 1 -->
<ul>
<!--page 470 -->
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="F.9.3" href="#F.9.3">F.9.3 Exponential and logarithmic functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.3.1" href="#F.9.3.1">F.9.3.1 The exp functions</a></h5>
<p><!--para 1 -->
<ul>
<li> exp(+(inf)) returns +(inf).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.3.2" href="#F.9.3.2">F.9.3.2 The exp2 functions</a></h5>
<p><!--para 1 -->
<ul>
<li> exp2(+(inf)) returns +(inf).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.3.3" href="#F.9.3.3">F.9.3.3 The expm1 functions</a></h5>
<p><!--para 1 -->
<ul>
<li> expm1(+(inf)) returns +(inf).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.3.4" href="#F.9.3.4">F.9.3.4 The frexp functions</a></h5>
<p><!--para 1 -->
<ul>
}
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.3.5" href="#F.9.3.5">F.9.3.5 The ilogb functions</a></h5>
<p><!--para 1 -->
If the correct result is outside the range of the return type, the numeric result is
unspecified and the ''invalid'' floating-point exception is raised.
<!--page 471 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.3.6" href="#F.9.3.6">F.9.3.6 The ldexp functions</a></h5>
<p><!--para 1 -->
On a binary system, ldexp(x, exp) is equivalent to scalbn(x, exp).
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.3.7" href="#F.9.3.7">F.9.3.7 The log functions</a></h5>
<p><!--para 1 -->
<ul>
<li> log(+(inf)) returns +(inf).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.3.8" href="#F.9.3.8">F.9.3.8 The log10 functions</a></h5>
<p><!--para 1 -->
<ul>
<li> log10(+(inf)) returns +(inf).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.3.9" href="#F.9.3.9">F.9.3.9 The log1p functions</a></h5>
<p><!--para 1 -->
<ul>
<li> log1p(+(inf)) returns +(inf).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.3.10" href="#F.9.3.10">F.9.3.10 The log2 functions</a></h5>
<p><!--para 1 -->
<ul>
<li> log2(+(inf)) returns +(inf).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.3.11" href="#F.9.3.11">F.9.3.11 The logb functions</a></h5>
<p><!--para 1 -->
<ul>
<!--page 472 -->
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.3.12" href="#F.9.3.12">F.9.3.12 The modf functions</a></h5>
<p><!--para 1 -->
<ul>
}
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.3.13" href="#F.9.3.13">F.9.3.13 The scalbn and scalbln functions</a></h5>
<p><!--para 1 -->
<ul>
<li> scalbn((+-)(inf), n) returns (+-)(inf).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="F.9.4" href="#F.9.4">F.9.4 Power and absolute value functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.4.1" href="#F.9.4.1">F.9.4.1 The cbrt functions</a></h5>
<p><!--para 1 -->
<ul>
<li> cbrt((+-)(inf)) returns (+-)(inf).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.4.2" href="#F.9.4.2">F.9.4.2 The fabs functions</a></h5>
<p><!--para 1 -->
<ul>
<!--page 473 -->
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.4.3" href="#F.9.4.3">F.9.4.3 The hypot functions</a></h5>
<p><!--para 1 -->
<ul>
<li> hypot((+-)(inf), y) returns +(inf), even if y is a NaN.
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.4.4" href="#F.9.4.4">F.9.4.4 The pow functions</a></h5>
<p><!--para 1 -->
<ul>
<!--page 474 -->
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.4.5" href="#F.9.4.5">F.9.4.5 The sqrt functions</a></h5>
<p><!--para 1 -->
sqrt is fully specified as a basic arithmetic operation in IEC 60559.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="F.9.5" href="#F.9.5">F.9.5 Error and gamma functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.5.1" href="#F.9.5.1">F.9.5.1 The erf functions</a></h5>
<p><!--para 1 -->
<ul>
<li> erf((+-)(inf)) returns (+-)1.
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.5.2" href="#F.9.5.2">F.9.5.2 The erfc functions</a></h5>
<p><!--para 1 -->
<ul>
<li> erfc(+(inf)) returns +0.
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.5.3" href="#F.9.5.3">F.9.5.3 The lgamma functions</a></h5>
<p><!--para 1 -->
<ul>
<li> lgamma(+(inf)) returns +(inf).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.5.4" href="#F.9.5.4">F.9.5.4 The tgamma functions</a></h5>
<p><!--para 1 -->
<ul>
<li> tgamma(+(inf)) returns +(inf).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="F.9.6" href="#F.9.6">F.9.6 Nearest integer functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.6.1" href="#F.9.6.1">F.9.6.1 The ceil functions</a></h5>
<p><!--para 1 -->
<ul>
}
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.6.2" href="#F.9.6.2">F.9.6.2 The floor functions</a></h5>
<p><!--para 1 -->
<ul>
<p><!--para 2 -->
See the sample implementation for ceil in <a href="#F.9.6.1">F.9.6.1</a>.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.6.3" href="#F.9.6.3">F.9.6.3 The nearbyint functions</a></h5>
<p><!--para 1 -->
The nearbyint functions use IEC 60559 rounding according to the current rounding
<li> nearbyint((+-)(inf)) returns (+-)(inf) (for all rounding directions).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.6.4" href="#F.9.6.4">F.9.6.4 The rint functions</a></h5>
<p><!--para 1 -->
The rint functions differ from the nearbyint functions only in that they do raise the
''inexact'' floating-point exception if the result differs in value from the argument.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.6.5" href="#F.9.6.5">F.9.6.5 The lrint and llrint functions</a></h5>
<p><!--para 1 -->
The lrint and llrint functions provide floating-to-integer conversion as prescribed
exception.
<!--page 476 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.6.6" href="#F.9.6.6">F.9.6.6 The round functions</a></h5>
<p><!--para 1 -->
<ul>
The round functions may, but are not required to, raise the ''inexact'' floating-point
exception for non-integer numeric arguments, as this implementation does.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.6.7" href="#F.9.6.7">F.9.6.7 The lround and llround functions</a></h5>
<p><!--para 1 -->
The lround and llround functions differ from the lrint and llrint functions
round halfway cases away from zero and need not raise the ''inexact'' floating-point
exception for non-integer arguments that round to within the range of the return type.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.6.8" href="#F.9.6.8">F.9.6.8 The trunc functions</a></h5>
<p><!--para 1 -->
The trunc functions use IEC 60559 rounding toward zero (regardless of the current
<!--page 477 -->
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="F.9.7" href="#F.9.7">F.9.7 Remainder functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.7.1" href="#F.9.7.1">F.9.7.1 The fmod functions</a></h5>
<p><!--para 1 -->
<ul>
}
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.7.2" href="#F.9.7.2">F.9.7.2 The remainder functions</a></h5>
<p><!--para 1 -->
The remainder functions are fully specified as a basic arithmetic operation in
IEC 60559.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.7.3" href="#F.9.7.3">F.9.7.3 The remquo functions</a></h5>
<p><!--para 1 -->
The remquo functions follow the specifications for the remainder functions. They
have no further specifications special to IEC 60559 implementations.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="F.9.8" href="#F.9.8">F.9.8 Manipulation functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.8.1" href="#F.9.8.1">F.9.8.1 The copysign functions</a></h5>
<p><!--para 1 -->
copysign is specified in the Appendix to IEC 60559.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.8.2" href="#F.9.8.2">F.9.8.2 The nan functions</a></h5>
<p><!--para 1 -->
All IEC 60559 implementations support quiet NaNs, in all floating formats.
<!--page 478 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.8.3" href="#F.9.8.3">F.9.8.3 The nextafter functions</a></h5>
<p><!--para 1 -->
<ul>
exceptions for the function value subnormal or zero and x != y.
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.8.4" href="#F.9.8.4">F.9.8.4 The nexttoward functions</a></h5>
<p><!--para 1 -->
No additional requirements beyond those on nextafter.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="F.9.9" href="#F.9.9">F.9.9 Maximum, minimum, and positive difference functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.9.1" href="#F.9.9.1">F.9.9.1 The fdim functions</a></h5>
<p><!--para 1 -->
No additional requirements.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.9.2" href="#F.9.9.2">F.9.9.2 The fmax functions</a></h5>
<p><!--para 1 -->
If just one argument is a NaN, the fmax functions return the other argument (if both
return +0; however, implementation in software might be impractical.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.9.3" href="#F.9.9.3">F.9.9.3 The fmin functions</a></h5>
<p><!--para 1 -->
The fmin functions are analogous to the fmax functions (see <a href="#F.9.9.2">F.9.9.2</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="F.9.10" href="#F.9.10">F.9.10 Floating multiply-add</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="F.9.10.1" href="#F.9.10.1">F.9.10.1 The fma functions</a></h5>
<p><!--para 1 -->
<ul>
<!--page 479 -->
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h2><a name="G" href="#G">Annex G</a></h2>
<pre>
(informative)
IEC 60559-compatible complex arithmetic
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="G.1" href="#G.1">G.1 Introduction</a></h3>
<p><!--para 1 -->
This annex supplements <a href="#F">annex F</a> to specify complex arithmetic for compatibility with
recommended practice. An implementation that defines
__STDC_IEC_559_COMPLEX__ should conform to the specifications in this annex.
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="G.2" href="#G.2">G.2 Types</a></h3>
<p><!--para 1 -->
There is a new keyword _Imaginary, which is used to specify imaginary types. It is
<p><!--para 5 -->
The imaginary type domain comprises the imaginary types.
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="G.3" href="#G.3">G.3 Conventions</a></h3>
<p><!--para 1 -->
A complex or imaginary value with at least one infinite part is regarded as an infinity
a zero if each of its parts is a zero.
<!--page 480 -->
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="G.4" href="#G.4">G.4 Conversions</a></h3>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="G.4.1" href="#G.4.1">G.4.1 Imaginary types</a></h4>
<p><!--para 1 -->
Conversions among imaginary types follow rules analogous to those for real floating
types.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="G.4.2" href="#G.4.2">G.4.2 Real and imaginary</a></h4>
<p><!--para 1 -->
When a value of imaginary type is converted to a real type other than _Bool,<sup><a href="#note324"><b>324)</b></a></sup> the
<p><small><a name="note324" href="#note324">324)</a> See <a href="#6.3.1.2">6.3.1.2</a>.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="G.4.3" href="#G.4.3">G.4.3 Imaginary and complex</a></h4>
<p><!--para 1 -->
When a value of imaginary type is converted to a complex type, the real part of the
complex value is discarded and the value of the imaginary part is converted according to
the conversion rules for the corresponding real types.
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="G.5" href="#G.5">G.5 Binary operators</a></h3>
<p><!--para 1 -->
The following subclauses supplement <a href="#6.5">6.5</a> in order to specify the type of the result for an
<!--page 481 -->
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="G.5.1" href="#G.5.1">G.5.1 Multiplicative operators</a></h4>
<p><b>Semantics</b>
<p><!--para 1 -->
(at least where the state for CX_LIMITED_RANGE is ''off'').
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="G.5.2" href="#G.5.2">G.5.2 Additive operators</a></h4>
<p><b>Semantics</b>
<p><!--para 1 -->
x + iy (x (+-) u) + iy x + i(y (+-) v) (x (+-) u) + i(y (+-) v)
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="G.6" href="#G.6">G.6 Complex arithmetic <complex.h></a></h3>
<p><!--para 1 -->
The macros
other part is a NaN.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="G.6.1" href="#G.6.1">G.6.1 Trigonometric functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="G.6.1.1" href="#G.6.1.1">G.6.1.1 The cacos functions</a></h5>
<p><!--para 1 -->
<ul>
<li> cacos(NaN + iNaN) returns NaN + iNaN.
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="G.6.2" href="#G.6.2">G.6.2 Hyperbolic functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="G.6.2.1" href="#G.6.2.1">G.6.2.1 The cacosh functions</a></h5>
<p><!--para 1 -->
<ul>
<li> cacosh(NaN + iNaN) returns NaN + iNaN.
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="G.6.2.2" href="#G.6.2.2">G.6.2.2 The casinh functions</a></h5>
<p><!--para 1 -->
<ul>
<li> casinh(NaN + iNaN) returns NaN + iNaN.
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="G.6.2.3" href="#G.6.2.3">G.6.2.3 The catanh functions</a></h5>
<p><!--para 1 -->
<ul>
<li> catanh(NaN + iNaN) returns NaN + iNaN.
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="G.6.2.4" href="#G.6.2.4">G.6.2.4 The ccosh functions</a></h5>
<p><!--para 1 -->
<ul>
<li> ccosh(NaN + iNaN) returns NaN + iNaN.
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="G.6.2.5" href="#G.6.2.5">G.6.2.5 The csinh functions</a></h5>
<p><!--para 1 -->
<ul>
<li> csinh(NaN + iNaN) returns NaN + iNaN.
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="G.6.2.6" href="#G.6.2.6">G.6.2.6 The ctanh functions</a></h5>
<p><!--para 1 -->
<ul>
<!--page 490 -->
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="G.6.3" href="#G.6.3">G.6.3 Exponential and logarithmic functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="G.6.3.1" href="#G.6.3.1">G.6.3.1 The cexp functions</a></h5>
<p><!--para 1 -->
<ul>
<li> cexp(NaN + iNaN) returns NaN + iNaN.
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="G.6.3.2" href="#G.6.3.2">G.6.3.2 The clog functions</a></h5>
<p><!--para 1 -->
<ul>
<li> clog(NaN + iNaN) returns NaN + iNaN.
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="G.6.4" href="#G.6.4">G.6.4 Power and absolute-value functions</a></h4>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="G.6.4.1" href="#G.6.4.1">G.6.4.1 The cpow functions</a></h5>
<p><!--para 1 -->
The cpow functions raise floating-point exceptions if appropriate for the calculation of
implementations that treat special cases more carefully.
</small>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="G.6.4.2" href="#G.6.4.2">G.6.4.2 The csqrt functions</a></h5>
<p><!--para 1 -->
<ul>
<!--page 492 -->
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="G.7" href="#G.7">G.7 Type-generic math <tgmath.h></a></h3>
<p><!--para 1 -->
Type-generic macros that accept complex arguments also accept imaginary arguments. If
atanh(iy) = i atan(y)
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h2><a name="H" href="#H">Annex H</a></h2>
<pre>
(informative)
Language independent arithmetic
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="H.1" href="#H.1">H.1 Introduction</a></h3>
<p><!--para 1 -->
This annex documents the extent to which the C language supports the ISO/IEC 10967-1
standard for language-independent arithmetic (LIA-1). LIA-1 is more general than
IEC 60559 (<a href="#F">annex F</a>) in that it covers integer and diverse floating-point arithmetics.
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="H.2" href="#H.2">H.2 Types</a></h3>
<p><!--para 1 -->
The relevant C arithmetic types meet the requirements of LIA-1 types if an
implementation adds notification of exceptional arithmetic operations and meets the 1
unit in the last place (ULP) accuracy requirement (LIA-1 subclause <a href="#5.2.8">5.2.8</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="H.2.1" href="#H.2.1">H.2.1 Boolean type</a></h4>
<p><!--para 1 -->
The LIA-1 data type Boolean is implemented by the C data type bool with values of
true and false, all from <a href="#7.16"><stdbool.h></a>.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="H.2.2" href="#H.2.2">H.2.2 Integer types</a></h4>
<p><!--para 1 -->
The signed C integer types int, long int, long long int, and the corresponding
is always 0 for the unsigned types, and is not provided for those types.
<!--page 494 -->
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="H.2.2.1" href="#H.2.2.1">H.2.2.1 Integer operations</a></h5>
<p><!--para 1 -->
The integer operations on integer types are the following:
</pre>
where x and y are expressions of the same integer type.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="H.2.3" href="#H.2.3">H.2.3 Floating-point types</a></h4>
<p><!--para 1 -->
The C floating-point types float, double, and long double are compatible with
operations (see <a href="#F">annex F</a>) along with IEC 60559 status flags and traps has LIA-1
conformant types.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="H.2.3.1" href="#H.2.3.1">H.2.3.1 Floating-point parameters</a></h5>
<p><!--para 1 -->
The parameters for a floating point data type can be accessed by the following:
rnd_style FLT_ROUNDS
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="H.2.3.2" href="#H.2.3.2">H.2.3.2 Floating-point operations</a></h5>
<p><!--para 1 -->
The floating-point operations on floating-point types are the following:
where x and y are expressions of the same floating point type, n is of type int, and li
is of type long int.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="H.2.3.3" href="#H.2.3.3">H.2.3.3 Rounding styles</a></h5>
<p><!--para 1 -->
The C Standard requires all floating types to use the same radix and rounding style, so
provided that an implementation extends FLT_ROUNDS to cover the rounding style used
in all relevant LIA-1 operations, not just addition as in C.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="H.2.4" href="#H.2.4">H.2.4 Type conversions</a></h4>
<p><!--para 1 -->
The LIA-1 type conversions are the following type casts:
implementation uses round-to-nearest.
<!--page 497 -->
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="H.3" href="#H.3">H.3 Notification</a></h3>
<p><!--para 1 -->
Notification is the process by which a user or program is informed that an exceptional
allows an implementation to cause a notification to occur when any arithmetic operation
returns an exceptional value as defined in LIA-1 clause 5.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="H.3.1" href="#H.3.1">H.3.1 Notification alternatives</a></h4>
<p><!--para 1 -->
LIA-1 requires at least the following two alternatives for handling of notifications:
math library function calls. User-provided signal handlers for SIGFPE allow for trap-
and-resume behavior with the same constraint.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="H.3.1.1" href="#H.3.1.1">H.3.1.1 Indicators</a></h5>
<p><!--para 1 -->
C's <a href="#7.6"><fenv.h></a> status flags are compatible with the LIA-1 indicators.
This documentation makes that distinction because <a href="#7.6"><fenv.h></a> covers only the floating-
point indicators.
+<p><small><a href="#Contents">Contents</a></small>
<h5><a name="H.3.1.2" href="#H.3.1.2">H.3.1.2 Traps</a></h5>
<p><!--para 1 -->
C is compatible with LIA-1's trap requirements for arithmetic operations, but not for
resume, at the programmer's option.
<!--page 499 -->
+<p><small><a href="#Contents">Contents</a></small>
<h2><a name="I" href="#I">Annex I</a></h2>
<pre>
(informative)
<!--page 501 -->
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h2><a name="J" href="#J">Annex J</a></h2>
<pre>
(informative)
This annex collects some information about portability that appears in this International
Standard.
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="J.1" href="#J.1">J.1 Unspecified behavior</a></h3>
<p><!--para 1 -->
The following are unspecified:
<a href="#G.6.2.3">G.6.2.3</a>, <a href="#G.6.2.4">G.6.2.4</a>, <a href="#G.6.2.5">G.6.2.5</a>, <a href="#G.6.2.6">G.6.2.6</a>, <a href="#G.6.3.1">G.6.3.1</a>, <a href="#G.6.4.2">G.6.4.2</a>).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="J.2" href="#J.2">J.2 Undefined behavior</a></h3>
<p><!--para 1 -->
The behavior is undefined in the following circumstances:
<!--page 517 -->
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="J.3" href="#J.3">J.3 Implementation-defined behavior</a></h3>
<p><!--para 1 -->
A conforming implementation is required to document its choice of behavior in each of
the areas listed in this subclause. The following are implementation-defined:
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.3.1" href="#J.3.1">J.3.1 Translation</a></h4>
<p><!--para 1 -->
<ul>
retained or replaced by one space character in translation phase 3 (<a href="#5.1.1.2">5.1.1.2</a>).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.3.2" href="#J.3.2">J.3.2 Environment</a></h4>
<p><!--para 1 -->
<ul>
<li> The manner of execution of the string by the system function (<a href="#7.20.4.6">7.20.4.6</a>).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.3.3" href="#J.3.3">J.3.3 Identifiers</a></h4>
<p><!--para 1 -->
<ul>
<!--page 518 -->
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.3.4" href="#J.3.4">J.3.4 Characters</a></h4>
<p><!--para 1 -->
<ul>
represented in the execution character set (<a href="#6.4.5">6.4.5</a>).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.3.5" href="#J.3.5">J.3.5 Integers</a></h4>
<p><!--para 1 -->
<ul>
<li> The results of some bitwise operations on signed integers (<a href="#6.5">6.5</a>).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.3.6" href="#J.3.6">J.3.6 Floating point</a></h4>
<p><!--para 1 -->
<ul>
<li> The default state for the FP_CONTRACT pragma (<a href="#7.12.2">7.12.2</a>). *
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.3.7" href="#J.3.7">J.3.7 Arrays and pointers</a></h4>
<p><!--para 1 -->
<ul>
<!--page 520 -->
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.3.8" href="#J.3.8">J.3.8 Hints</a></h4>
<p><!--para 1 -->
<ul>
effective (<a href="#6.7.4">6.7.4</a>).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.3.9" href="#J.3.9">J.3.9 Structures, unions, enumerations, and bit-fields</a></h4>
<p><!--para 1 -->
<ul>
<li> The integer type compatible with each enumerated type (<a href="#6.7.2.2">6.7.2.2</a>).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.3.10" href="#J.3.10">J.3.10 Qualifiers</a></h4>
<p><!--para 1 -->
<ul>
<li> What constitutes an access to an object that has volatile-qualified type (<a href="#6.7.3">6.7.3</a>).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.3.11" href="#J.3.11">J.3.11 Preprocessing directives</a></h4>
<p><!--para 1 -->
<ul>
time of translation are not available (<a href="#6.10.8">6.10.8</a>).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.3.12" href="#J.3.12">J.3.12 Library functions</a></h4>
<p><!--para 1 -->
<ul>
IEC 60559 conformant implementation, unless explicitly specified otherwise (<a href="#F.9">F.9</a>).
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.3.13" href="#J.3.13">J.3.13 Architecture</a></h4>
<p><!--para 1 -->
<ul>
<!--page 524 -->
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="J.4" href="#J.4">J.4 Locale-specific behavior</a></h3>
<p><!--para 1 -->
The following characteristics of a hosted environment are locale-specific and are required
<!--page 525 -->
</ul>
+<p><small><a href="#Contents">Contents</a></small>
<h3><a name="J.5" href="#J.5">J.5 Common extensions</a></h3>
<p><!--para 1 -->
The following extensions are widely used in many systems, but are not portable to all
extensions are new keywords, extra library functions declared in standard headers, or
predefined macros with names that do not begin with an underscore.
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.5.1" href="#J.5.1">J.5.1 Environment arguments</a></h4>
<p><!--para 1 -->
In a hosted environment, the main function receives a third argument, char *envp[],
that provides information about the environment for this execution of the program
(<a href="#5.1.2.2.1">5.1.2.2.1</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.5.2" href="#J.5.2">J.5.2 Specialized identifiers</a></h4>
<p><!--para 1 -->
Characters other than the underscore _, letters, and digits, that are not part of the basic
source character set (such as the dollar sign $, or characters in national character sets)
may appear in an identifier (<a href="#6.4.2">6.4.2</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.5.3" href="#J.5.3">J.5.3 Lengths and cases of identifiers</a></h4>
<p><!--para 1 -->
All characters in identifiers (with or without external linkage) are significant (<a href="#6.4.2">6.4.2</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.5.4" href="#J.5.4">J.5.4 Scopes of identifiers</a></h4>
<p><!--para 1 -->
A function identifier, or the identifier of an object the declaration of which contains the
keyword extern, has file scope (<a href="#6.2.1">6.2.1</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.5.5" href="#J.5.5">J.5.5 Writable string literals</a></h4>
<p><!--para 1 -->
String literals are modifiable (in which case, identical string literals should denote distinct
objects) (<a href="#6.4.5">6.4.5</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.5.6" href="#J.5.6">J.5.6 Other arithmetic types</a></h4>
<p><!--para 1 -->
Additional arithmetic types, such as __int128 or double double, and their
other floating types, and may be used to define float_t or double_t.
<!--page 526 -->
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.5.7" href="#J.5.7">J.5.7 Function pointer casts</a></h4>
<p><!--para 1 -->
A pointer to an object or to void may be cast to a pointer to a function, allowing data to
A pointer to a function may be cast to a pointer to an object or to void, allowing a
function to be inspected or modified (for example, by a debugger) (<a href="#6.5.4">6.5.4</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.5.8" href="#J.5.8">J.5.8 Extended bit-field types</a></h4>
<p><!--para 1 -->
A bit-field may be declared with a type other than _Bool, unsigned int, or
signed int, with an appropriate maximum width (<a href="#6.7.2.1">6.7.2.1</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.5.9" href="#J.5.9">J.5.9 The fortran keyword</a></h4>
<p><!--para 1 -->
The fortran function specifier may be used in a function declaration to indicate that
calls suitable for FORTRAN should be generated, or that a different representation for the
external name is to be generated (<a href="#6.7.4">6.7.4</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.5.10" href="#J.5.10">J.5.10 The asm keyword</a></h4>
<p><!--para 1 -->
The asm keyword may be used to insert assembly language directly into the translator
asm ( character-string-literal );
</pre>
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.5.11" href="#J.5.11">J.5.11 Multiple external definitions</a></h4>
<p><!--para 1 -->
There may be more than one external definition for the identifier of an object, with or
without the explicit use of the keyword extern; if the definitions disagree, or more than
one is initialized, the behavior is undefined (<a href="#6.9.2">6.9.2</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.5.12" href="#J.5.12">J.5.12 Predefined macro names</a></h4>
<p><!--para 1 -->
Macro names that do not begin with an underscore, describing the translation and
execution environments, are defined by the implementation before translation begins
(<a href="#6.10.8">6.10.8</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.5.13" href="#J.5.13">J.5.13 Floating-point status flags</a></h4>
<p><!--para 1 -->
If any floating-point status flags are set on normal termination after all calls to functions
writes some diagnostics indicating the fact to the stderr stream, if it is still open,
<!--page 527 -->
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.5.14" href="#J.5.14">J.5.14 Extra arguments for signal handlers</a></h4>
<p><!--para 1 -->
Handlers for specific signals are called with extra arguments in addition to the signal
number (<a href="#7.14.1.1">7.14.1.1</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.5.15" href="#J.5.15">J.5.15 Additional stream types and file-opening modes</a></h4>
<p><!--para 1 -->
Additional mappings from files to streams are supported (<a href="#7.19.2">7.19.2</a>).
Additional file-opening modes may be specified by characters appended to the mode
argument of the fopen function (<a href="#7.19.5.3">7.19.5.3</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.5.16" href="#J.5.16">J.5.16 Defined file position indicator</a></h4>
<p><!--para 1 -->
The file position indicator is decremented by each successful call to the ungetc or
ungetwc function for a text stream, except if its value was zero before a call (<a href="#7.19.7.11">7.19.7.11</a>,
<a href="#7.24.3.10">7.24.3.10</a>).
+<p><small><a href="#Contents">Contents</a></small>
<h4><a name="J.5.17" href="#J.5.17">J.5.17 Math error reporting</a></h4>
<p><!--para 1 -->
Functions declared in <a href="#7.3"><complex.h></a> and <a href="#7.12"><math.h></a> raise SIGFPE to report errors
<a href="#7.12">7.12</a>).
<!--page 528 -->
+<p><small><a href="#Contents">Contents</a></small>
<h2><a name="Bibliography" href="#Bibliography">Bibliography</a></h2>
<ol>
<li> ''The C Reference Manual'' by Dennis M. Ritchie, a version of which was
<!--page 531 -->
</ol>
+<p><small><a href="#Contents">Contents</a></small>
<h2><a name="Index" href="#Index">Index</a></h2>
<pre>
[^ x ^], <a href="#3.18">3.18</a> , (comma punctuator), <a href="#6.5.2">6.5.2</a>, <a href="#6.7">6.7</a>, <a href="#6.7.2.1">6.7.2.1</a>, <a href="#6.7.2.2">6.7.2.2</a>,
wctrans_t type, <a href="#7.25.1">7.25.1</a>, <a href="#7.25.3.2.2">7.25.3.2.2</a>
wctype function, <a href="#7.25.2.2.1">7.25.2.2.1</a>, <a href="#7.25.2.2.2">7.25.2.2.2</a>
</pre>
+<p><small><a href="#Contents">Contents</a></small>
</body></html>