* intrinsic.texi (Transfer): Improve documentation.

From-SVN: r124234
This commit is contained in:
Brooks Moses 2007-04-27 20:15:11 +00:00 committed by Brooks Moses
parent 67948fd24a
commit e1535fe0c5
2 changed files with 28 additions and 6 deletions

View File

@ -1,3 +1,7 @@
2007-04-27 Brooks Moses <brooks.moses@codesourcery.com>
* intrinsic.texi (Transfer): Improve documentation.
2007-04-27 Brooks Moses <brooks.moses@codesourcery.com> 2007-04-27 Brooks Moses <brooks.moses@codesourcery.com>
* gfortran.texi (Option Index): Add @samp as needed. * gfortran.texi (Option Index): Add @samp as needed.

View File

@ -9527,10 +9527,12 @@ See @code{HUGE} for an example.
@table @asis @table @asis
@item @emph{Description}: @item @emph{Description}:
Interprets the bit pattern of @var{SOURCE} as a variable of the Interprets the bitwise representation of @var{SOURCE} in memory as if it
same type and type parameters as @var{MOLD}. is the representation of a variable or array of the same type and type
parameters as @var{MOLD}.
This is also known as @emph{casting} one type to another. This is approximately equivalent to the C concept of @emph{casting} one
type to another.
@item @emph{Standard}: @item @emph{Standard}:
F95 and later F95 and later
@ -9545,13 +9547,29 @@ Transformational function
@multitable @columnfractions .15 .70 @multitable @columnfractions .15 .70
@item @var{SOURCE} @tab Shall be a scalar or an array of any type. @item @var{SOURCE} @tab Shall be a scalar or an array of any type.
@item @var{MOLD} @tab Shall be a scalar or an array of any type. @item @var{MOLD} @tab Shall be a scalar or an array of any type.
@item @var{SIZE} @tab (Optional) shall be a scalar and of type @item @var{SIZE} @tab (Optional) shall be a scalar of type
@code{INTEGER}. @code{INTEGER}.
@end multitable @end multitable
@item @emph{Return value}: @item @emph{Return value}:
The result has the same type as @var{MOLD} with the bit level The result has the same type as @var{MOLD}, with the bit level
representation of @var{SOURCE}. representation of @var{SOURCE}. If @var{SIZE} is present, the result is
a one-dimensional array of length @var{SIZE}. If @var{SIZE} is absent
but @var{MOLD} is an array (of any size or shape), the result is a one-
dimensional array of the minimum length needed to contain the entirety
of the bitwise representation of @var{SOURCE}. If @var{SIZE} is absent
and @var{MOLD} is a scalar, the result is a scalar.
If the bitwise representation of the result is longer than that of
@var{SOURCE}, then the leading bits of the result correspond to those of
@var{SOURCE} and any trailing bits are filled arbitrarily.
When the resulting bit representation does not correspond to a valid
representation of a variable of the same type as @var{MOLD}, the results
are undefined, and subsequent operations on the result cannot be
guaranteed to produce sensible behavior. For example, it is possible to
create @code{LOGICAL} variables for which @code{@var{VAR}} and
@code{.NOT.@var{VAR}} both appear to be true.
@item @emph{Example}: @item @emph{Example}:
@smallexample @smallexample