freebsd-dev/contrib/gcc/f/intdoc.texi
2003-07-11 03:40:53 +00:00

10932 lines
246 KiB
Plaintext

@c This file is automatically derived from intdoc.c, intdoc.in,
@c ansify.c, intrin.def, and intrin.h. Edit those files instead.
@menu
@ifset familyF2U
* Abort Intrinsic:: Abort the program.
@end ifset
@ifset familyF77
* Abs Intrinsic:: Absolute value.
@end ifset
@ifset familyF2U
* Access Intrinsic:: Check file accessibility.
@end ifset
@ifset familyASC
* AChar Intrinsic:: ASCII character from code.
@end ifset
@ifset familyF77
* ACos Intrinsic:: Arc cosine.
@end ifset
@ifset familyVXT
* ACosD Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF90
* AdjustL Intrinsic:: (Reserved for future use.)
* AdjustR Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* AImag Intrinsic:: Convert/extract imaginary part of complex.
@end ifset
@ifset familyVXT
* AIMax0 Intrinsic:: (Reserved for future use.)
* AIMin0 Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* AInt Intrinsic:: Truncate to whole number.
@end ifset
@ifset familyVXT
* AJMax0 Intrinsic:: (Reserved for future use.)
* AJMin0 Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF2U
* Alarm Intrinsic:: Execute a routine after a given delay.
@end ifset
@ifset familyF90
* All Intrinsic:: (Reserved for future use.)
* Allocated Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* ALog Intrinsic:: Natural logarithm (archaic).
* ALog10 Intrinsic:: Common logarithm (archaic).
* AMax0 Intrinsic:: Maximum value (archaic).
* AMax1 Intrinsic:: Maximum value (archaic).
* AMin0 Intrinsic:: Minimum value (archaic).
* AMin1 Intrinsic:: Minimum value (archaic).
* AMod Intrinsic:: Remainder (archaic).
@end ifset
@ifset familyF2C
* And Intrinsic:: Boolean AND.
@end ifset
@ifset familyF77
* ANInt Intrinsic:: Round to nearest whole number.
@end ifset
@ifset familyF90
* Any Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* ASin Intrinsic:: Arc sine.
@end ifset
@ifset familyVXT
* ASinD Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF90
* Associated Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* ATan Intrinsic:: Arc tangent.
* ATan2 Intrinsic:: Arc tangent.
@end ifset
@ifset familyVXT
* ATan2D Intrinsic:: (Reserved for future use.)
* ATanD Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF2U
* BesJ0 Intrinsic:: Bessel function.
* BesJ1 Intrinsic:: Bessel function.
* BesJN Intrinsic:: Bessel function.
* BesY0 Intrinsic:: Bessel function.
* BesY1 Intrinsic:: Bessel function.
* BesYN Intrinsic:: Bessel function.
@end ifset
@ifset familyVXT
* BITest Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF90
* Bit_Size Intrinsic:: Number of bits in argument's type.
@end ifset
@ifset familyVXT
* BJTest Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyMIL
* BTest Intrinsic:: Test bit.
@end ifset
@ifset familyF77
* CAbs Intrinsic:: Absolute value (archaic).
* CCos Intrinsic:: Cosine (archaic).
@end ifset
@ifset familyFVZ
* CDAbs Intrinsic:: Absolute value (archaic).
* CDCos Intrinsic:: Cosine (archaic).
* CDExp Intrinsic:: Exponential (archaic).
* CDLog Intrinsic:: Natural logarithm (archaic).
* CDSin Intrinsic:: Sine (archaic).
* CDSqRt Intrinsic:: Square root (archaic).
@end ifset
@ifset familyF90
* Ceiling Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* CExp Intrinsic:: Exponential (archaic).
* Char Intrinsic:: Character from code.
@end ifset
@ifset familyF2U
* ChDir Intrinsic (subroutine):: Change directory.
@end ifset
@ifset familyBADU77
* ChDir Intrinsic (function):: Change directory.
@end ifset
@ifset familyF2U
* ChMod Intrinsic (subroutine):: Change file modes.
@end ifset
@ifset familyBADU77
* ChMod Intrinsic (function):: Change file modes.
@end ifset
@ifset familyF77
* CLog Intrinsic:: Natural logarithm (archaic).
* Cmplx Intrinsic:: Construct @code{COMPLEX(KIND=1)} value.
@end ifset
@ifset familyGNU
* Complex Intrinsic:: Build complex value from real and
imaginary parts.
@end ifset
@ifset familyF77
* Conjg Intrinsic:: Complex conjugate.
* Cos Intrinsic:: Cosine.
@end ifset
@ifset familyVXT
* CosD Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* CosH Intrinsic:: Hyperbolic cosine.
@end ifset
@ifset familyF90
* Count Intrinsic:: (Reserved for future use.)
* CPU_Time Intrinsic:: Get current CPU time.
* CShift Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* CSin Intrinsic:: Sine (archaic).
* CSqRt Intrinsic:: Square root (archaic).
@end ifset
@ifset familyF2U
* CTime Intrinsic (subroutine):: Convert time to Day Mon dd hh:mm:ss yyyy.
* CTime Intrinsic (function):: Convert time to Day Mon dd hh:mm:ss yyyy.
@end ifset
@ifset familyF77
* DAbs Intrinsic:: Absolute value (archaic).
* DACos Intrinsic:: Arc cosine (archaic).
@end ifset
@ifset familyVXT
* DACosD Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* DASin Intrinsic:: Arc sine (archaic).
@end ifset
@ifset familyVXT
* DASinD Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* DATan Intrinsic:: Arc tangent (archaic).
* DATan2 Intrinsic:: Arc tangent (archaic).
@end ifset
@ifset familyVXT
* DATan2D Intrinsic:: (Reserved for future use.)
* DATanD Intrinsic:: (Reserved for future use.)
* Date Intrinsic:: Get current date as dd-Mon-yy.
@end ifset
@ifset familyF90
* Date_and_Time Intrinsic:: Get the current date and time.
@end ifset
@ifset familyF2U
* DbesJ0 Intrinsic:: Bessel function (archaic).
* DbesJ1 Intrinsic:: Bessel function (archaic).
* DbesJN Intrinsic:: Bessel function (archaic).
* DbesY0 Intrinsic:: Bessel function (archaic).
* DbesY1 Intrinsic:: Bessel function (archaic).
* DbesYN Intrinsic:: Bessel function (archaic).
@end ifset
@ifset familyF77
* Dble Intrinsic:: Convert to double precision.
@end ifset
@ifset familyVXT
* DbleQ Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyFVZ
* DCmplx Intrinsic:: Construct @code{COMPLEX(KIND=2)} value.
* DConjg Intrinsic:: Complex conjugate (archaic).
@end ifset
@ifset familyF77
* DCos Intrinsic:: Cosine (archaic).
@end ifset
@ifset familyVXT
* DCosD Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* DCosH Intrinsic:: Hyperbolic cosine (archaic).
* DDiM Intrinsic:: Difference magnitude (archaic).
@end ifset
@ifset familyF2U
* DErF Intrinsic:: Error function (archaic).
* DErFC Intrinsic:: Complementary error function (archaic).
@end ifset
@ifset familyF77
* DExp Intrinsic:: Exponential (archaic).
@end ifset
@ifset familyFVZ
* DFloat Intrinsic:: Conversion (archaic).
@end ifset
@ifset familyVXT
* DFlotI Intrinsic:: (Reserved for future use.)
* DFlotJ Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF90
* Digits Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* DiM Intrinsic:: Difference magnitude (non-negative subtract).
@end ifset
@ifset familyFVZ
* DImag Intrinsic:: Convert/extract imaginary part of complex (archaic).
@end ifset
@ifset familyF77
* DInt Intrinsic:: Truncate to whole number (archaic).
* DLog Intrinsic:: Natural logarithm (archaic).
* DLog10 Intrinsic:: Common logarithm (archaic).
* DMax1 Intrinsic:: Maximum value (archaic).
* DMin1 Intrinsic:: Minimum value (archaic).
* DMod Intrinsic:: Remainder (archaic).
* DNInt Intrinsic:: Round to nearest whole number (archaic).
@end ifset
@ifset familyF90
* Dot_Product Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* DProd Intrinsic:: Double-precision product.
@end ifset
@ifset familyVXT
* DReal Intrinsic:: Convert value to type @code{REAL(KIND=2)}.
@end ifset
@ifset familyF77
* DSign Intrinsic:: Apply sign to magnitude (archaic).
* DSin Intrinsic:: Sine (archaic).
@end ifset
@ifset familyVXT
* DSinD Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* DSinH Intrinsic:: Hyperbolic sine (archaic).
* DSqRt Intrinsic:: Square root (archaic).
* DTan Intrinsic:: Tangent (archaic).
@end ifset
@ifset familyVXT
* DTanD Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* DTanH Intrinsic:: Hyperbolic tangent (archaic).
@end ifset
@ifset familyF2U
* DTime Intrinsic (subroutine):: Get elapsed time since last time.
@end ifset
@ifset familyBADU77
* DTime Intrinsic (function):: Get elapsed time since last time.
@end ifset
@ifset familyF90
* EOShift Intrinsic:: (Reserved for future use.)
* Epsilon Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF2U
* ErF Intrinsic:: Error function.
* ErFC Intrinsic:: Complementary error function.
* ETime Intrinsic (subroutine):: Get elapsed time for process.
* ETime Intrinsic (function):: Get elapsed time for process.
* Exit Intrinsic:: Terminate the program.
@end ifset
@ifset familyF77
* Exp Intrinsic:: Exponential.
@end ifset
@ifset familyF90
* Exponent Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF2U
* FDate Intrinsic (subroutine):: Get current time as Day Mon dd hh:mm:ss yyyy.
* FDate Intrinsic (function):: Get current time as Day Mon dd hh:mm:ss yyyy.
* FGet Intrinsic (subroutine):: Read a character from unit 5 stream-wise.
@end ifset
@ifset familyBADU77
* FGet Intrinsic (function):: Read a character from unit 5 stream-wise.
@end ifset
@ifset familyF2U
* FGetC Intrinsic (subroutine):: Read a character stream-wise.
@end ifset
@ifset familyBADU77
* FGetC Intrinsic (function):: Read a character stream-wise.
@end ifset
@ifset familyF77
* Float Intrinsic:: Conversion (archaic).
@end ifset
@ifset familyVXT
* FloatI Intrinsic:: (Reserved for future use.)
* FloatJ Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF90
* Floor Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF2U
* Flush Intrinsic:: Flush buffered output.
* FNum Intrinsic:: Get file descriptor from Fortran unit number.
* FPut Intrinsic (subroutine):: Write a character to unit 6 stream-wise.
@end ifset
@ifset familyBADU77
* FPut Intrinsic (function):: Write a character to unit 6 stream-wise.
@end ifset
@ifset familyF2U
* FPutC Intrinsic (subroutine):: Write a character stream-wise.
@end ifset
@ifset familyBADU77
* FPutC Intrinsic (function):: Write a character stream-wise.
@end ifset
@ifset familyF90
* Fraction Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF2U
* FSeek Intrinsic:: Position file (low-level).
* FStat Intrinsic (subroutine):: Get file information.
* FStat Intrinsic (function):: Get file information.
* FTell Intrinsic (subroutine):: Get file position (low-level).
* FTell Intrinsic (function):: Get file position (low-level).
* GError Intrinsic:: Get error message for last error.
* GetArg Intrinsic:: Obtain command-line argument.
* GetCWD Intrinsic (subroutine):: Get current working directory.
* GetCWD Intrinsic (function):: Get current working directory.
* GetEnv Intrinsic:: Get environment variable.
* GetGId Intrinsic:: Get process group id.
* GetLog Intrinsic:: Get login name.
* GetPId Intrinsic:: Get process id.
* GetUId Intrinsic:: Get process user id.
* GMTime Intrinsic:: Convert time to GMT time info.
* HostNm Intrinsic (subroutine):: Get host name.
* HostNm Intrinsic (function):: Get host name.
@end ifset
@ifset familyF90
* Huge Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* IAbs Intrinsic:: Absolute value (archaic).
@end ifset
@ifset familyASC
* IAChar Intrinsic:: ASCII code for character.
@end ifset
@ifset familyMIL
* IAnd Intrinsic:: Boolean AND.
@end ifset
@ifset familyF2U
* IArgC Intrinsic:: Obtain count of command-line arguments.
@end ifset
@ifset familyMIL
* IBClr Intrinsic:: Clear a bit.
* IBits Intrinsic:: Extract a bit subfield of a variable.
* IBSet Intrinsic:: Set a bit.
@end ifset
@ifset familyF77
* IChar Intrinsic:: Code for character.
@end ifset
@ifset familyF2U
* IDate Intrinsic (UNIX):: Get local time info.
@end ifset
@ifset familyVXT
* IDate Intrinsic (VXT):: Get local time info (VAX/VMS).
@end ifset
@ifset familyF77
* IDiM Intrinsic:: Difference magnitude (archaic).
* IDInt Intrinsic:: Convert to @code{INTEGER} value truncated
to whole number (archaic).
* IDNInt Intrinsic:: Convert to @code{INTEGER} value rounded
to nearest whole number (archaic).
@end ifset
@ifset familyMIL
* IEOr Intrinsic:: Boolean XOR.
@end ifset
@ifset familyF2U
* IErrNo Intrinsic:: Get error number for last error.
@end ifset
@ifset familyF77
* IFix Intrinsic:: Conversion (archaic).
@end ifset
@ifset familyVXT
* IIAbs Intrinsic:: (Reserved for future use.)
* IIAnd Intrinsic:: (Reserved for future use.)
* IIBClr Intrinsic:: (Reserved for future use.)
* IIBits Intrinsic:: (Reserved for future use.)
* IIBSet Intrinsic:: (Reserved for future use.)
* IIDiM Intrinsic:: (Reserved for future use.)
* IIDInt Intrinsic:: (Reserved for future use.)
* IIDNnt Intrinsic:: (Reserved for future use.)
* IIEOr Intrinsic:: (Reserved for future use.)
* IIFix Intrinsic:: (Reserved for future use.)
* IInt Intrinsic:: (Reserved for future use.)
* IIOr Intrinsic:: (Reserved for future use.)
* IIQint Intrinsic:: (Reserved for future use.)
* IIQNnt Intrinsic:: (Reserved for future use.)
* IIShftC Intrinsic:: (Reserved for future use.)
* IISign Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF2C
* Imag Intrinsic:: Extract imaginary part of complex.
@end ifset
@ifset familyGNU
* ImagPart Intrinsic:: Extract imaginary part of complex.
@end ifset
@ifset familyVXT
* IMax0 Intrinsic:: (Reserved for future use.)
* IMax1 Intrinsic:: (Reserved for future use.)
* IMin0 Intrinsic:: (Reserved for future use.)
* IMin1 Intrinsic:: (Reserved for future use.)
* IMod Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* Index Intrinsic:: Locate a CHARACTER substring.
@end ifset
@ifset familyVXT
* INInt Intrinsic:: (Reserved for future use.)
* INot Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* Int Intrinsic:: Convert to @code{INTEGER} value truncated
to whole number.
@end ifset
@ifset familyGNU
* Int2 Intrinsic:: Convert to @code{INTEGER(KIND=6)} value
truncated to whole number.
* Int8 Intrinsic:: Convert to @code{INTEGER(KIND=2)} value
truncated to whole number.
@end ifset
@ifset familyMIL
* IOr Intrinsic:: Boolean OR.
@end ifset
@ifset familyF2U
* IRand Intrinsic:: Random number.
* IsaTty Intrinsic:: Is unit connected to a terminal?
@end ifset
@ifset familyMIL
* IShft Intrinsic:: Logical bit shift.
* IShftC Intrinsic:: Circular bit shift.
@end ifset
@ifset familyF77
* ISign Intrinsic:: Apply sign to magnitude (archaic).
@end ifset
@ifset familyF2U
* ITime Intrinsic:: Get local time of day.
@end ifset
@ifset familyVXT
* IZExt Intrinsic:: (Reserved for future use.)
* JIAbs Intrinsic:: (Reserved for future use.)
* JIAnd Intrinsic:: (Reserved for future use.)
* JIBClr Intrinsic:: (Reserved for future use.)
* JIBits Intrinsic:: (Reserved for future use.)
* JIBSet Intrinsic:: (Reserved for future use.)
* JIDiM Intrinsic:: (Reserved for future use.)
* JIDInt Intrinsic:: (Reserved for future use.)
* JIDNnt Intrinsic:: (Reserved for future use.)
* JIEOr Intrinsic:: (Reserved for future use.)
* JIFix Intrinsic:: (Reserved for future use.)
* JInt Intrinsic:: (Reserved for future use.)
* JIOr Intrinsic:: (Reserved for future use.)
* JIQint Intrinsic:: (Reserved for future use.)
* JIQNnt Intrinsic:: (Reserved for future use.)
* JIShft Intrinsic:: (Reserved for future use.)
* JIShftC Intrinsic:: (Reserved for future use.)
* JISign Intrinsic:: (Reserved for future use.)
* JMax0 Intrinsic:: (Reserved for future use.)
* JMax1 Intrinsic:: (Reserved for future use.)
* JMin0 Intrinsic:: (Reserved for future use.)
* JMin1 Intrinsic:: (Reserved for future use.)
* JMod Intrinsic:: (Reserved for future use.)
* JNInt Intrinsic:: (Reserved for future use.)
* JNot Intrinsic:: (Reserved for future use.)
* JZExt Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF2U
* Kill Intrinsic (subroutine):: Signal a process.
@end ifset
@ifset familyBADU77
* Kill Intrinsic (function):: Signal a process.
@end ifset
@ifset familyF90
* Kind Intrinsic:: (Reserved for future use.)
* LBound Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* Len Intrinsic:: Length of character entity.
@end ifset
@ifset familyF90
* Len_Trim Intrinsic:: Get last non-blank character in string.
@end ifset
@ifset familyF77
* LGe Intrinsic:: Lexically greater than or equal.
* LGt Intrinsic:: Lexically greater than.
@end ifset
@ifset familyF2U
* Link Intrinsic (subroutine):: Make hard link in file system.
@end ifset
@ifset familyBADU77
* Link Intrinsic (function):: Make hard link in file system.
@end ifset
@ifset familyF77
* LLe Intrinsic:: Lexically less than or equal.
* LLt Intrinsic:: Lexically less than.
@end ifset
@ifset familyF2U
* LnBlnk Intrinsic:: Get last non-blank character in string.
* Loc Intrinsic:: Address of entity in core.
@end ifset
@ifset familyF77
* Log Intrinsic:: Natural logarithm.
* Log10 Intrinsic:: Common logarithm.
@end ifset
@ifset familyF90
* Logical Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF2U
* Long Intrinsic:: Conversion to @code{INTEGER(KIND=1)} (archaic).
@end ifset
@ifset familyF2C
* LShift Intrinsic:: Left-shift bits.
@end ifset
@ifset familyF2U
* LStat Intrinsic (subroutine):: Get file information.
* LStat Intrinsic (function):: Get file information.
* LTime Intrinsic:: Convert time to local time info.
@end ifset
@ifset familyF90
* MatMul Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* Max Intrinsic:: Maximum value.
* Max0 Intrinsic:: Maximum value (archaic).
* Max1 Intrinsic:: Maximum value (archaic).
@end ifset
@ifset familyF90
* MaxExponent Intrinsic:: (Reserved for future use.)
* MaxLoc Intrinsic:: (Reserved for future use.)
* MaxVal Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF2U
* MClock Intrinsic:: Get number of clock ticks for process.
* MClock8 Intrinsic:: Get number of clock ticks for process.
@end ifset
@ifset familyF90
* Merge Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* Min Intrinsic:: Minimum value.
* Min0 Intrinsic:: Minimum value (archaic).
* Min1 Intrinsic:: Minimum value (archaic).
@end ifset
@ifset familyF90
* MinExponent Intrinsic:: (Reserved for future use.)
* MinLoc Intrinsic:: (Reserved for future use.)
* MinVal Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* Mod Intrinsic:: Remainder.
@end ifset
@ifset familyF90
* Modulo Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyMIL
* MvBits Intrinsic:: Moving a bit field.
@end ifset
@ifset familyF90
* Nearest Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* NInt Intrinsic:: Convert to @code{INTEGER} value rounded
to nearest whole number.
@end ifset
@ifset familyMIL
* Not Intrinsic:: Boolean NOT.
@end ifset
@ifset familyF2C
* Or Intrinsic:: Boolean OR.
@end ifset
@ifset familyF90
* Pack Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF2U
* PError Intrinsic:: Print error message for last error.
@end ifset
@ifset familyF90
* Precision Intrinsic:: (Reserved for future use.)
* Present Intrinsic:: (Reserved for future use.)
* Product Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyVXT
* QAbs Intrinsic:: (Reserved for future use.)
* QACos Intrinsic:: (Reserved for future use.)
* QACosD Intrinsic:: (Reserved for future use.)
* QASin Intrinsic:: (Reserved for future use.)
* QASinD Intrinsic:: (Reserved for future use.)
* QATan Intrinsic:: (Reserved for future use.)
* QATan2 Intrinsic:: (Reserved for future use.)
* QATan2D Intrinsic:: (Reserved for future use.)
* QATanD Intrinsic:: (Reserved for future use.)
* QCos Intrinsic:: (Reserved for future use.)
* QCosD Intrinsic:: (Reserved for future use.)
* QCosH Intrinsic:: (Reserved for future use.)
* QDiM Intrinsic:: (Reserved for future use.)
* QExp Intrinsic:: (Reserved for future use.)
* QExt Intrinsic:: (Reserved for future use.)
* QExtD Intrinsic:: (Reserved for future use.)
* QFloat Intrinsic:: (Reserved for future use.)
* QInt Intrinsic:: (Reserved for future use.)
* QLog Intrinsic:: (Reserved for future use.)
* QLog10 Intrinsic:: (Reserved for future use.)
* QMax1 Intrinsic:: (Reserved for future use.)
* QMin1 Intrinsic:: (Reserved for future use.)
* QMod Intrinsic:: (Reserved for future use.)
* QNInt Intrinsic:: (Reserved for future use.)
* QSin Intrinsic:: (Reserved for future use.)
* QSinD Intrinsic:: (Reserved for future use.)
* QSinH Intrinsic:: (Reserved for future use.)
* QSqRt Intrinsic:: (Reserved for future use.)
* QTan Intrinsic:: (Reserved for future use.)
* QTanD Intrinsic:: (Reserved for future use.)
* QTanH Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF90
* Radix Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF2U
* Rand Intrinsic:: Random number.
@end ifset
@ifset familyF90
* Random_Number Intrinsic:: (Reserved for future use.)
* Random_Seed Intrinsic:: (Reserved for future use.)
* Range Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* Real Intrinsic:: Convert value to type @code{REAL(KIND=1)}.
@end ifset
@ifset familyGNU
* RealPart Intrinsic:: Extract real part of complex.
@end ifset
@ifset familyF2U
* Rename Intrinsic (subroutine):: Rename file.
@end ifset
@ifset familyBADU77
* Rename Intrinsic (function):: Rename file.
@end ifset
@ifset familyF90
* Repeat Intrinsic:: (Reserved for future use.)
* Reshape Intrinsic:: (Reserved for future use.)
* RRSpacing Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF2C
* RShift Intrinsic:: Right-shift bits.
@end ifset
@ifset familyF90
* Scale Intrinsic:: (Reserved for future use.)
* Scan Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyVXT
* Secnds Intrinsic:: Get local time offset since midnight.
@end ifset
@ifset familyF2U
* Second Intrinsic (function):: Get CPU time for process in seconds.
* Second Intrinsic (subroutine):: Get CPU time for process
in seconds.
@end ifset
@ifset familyF90
* Selected_Int_Kind Intrinsic:: (Reserved for future use.)
* Selected_Real_Kind Intrinsic:: (Reserved for future use.)
* Set_Exponent Intrinsic:: (Reserved for future use.)
* Shape Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF2U
* Short Intrinsic:: Convert to @code{INTEGER(KIND=6)} value
truncated to whole number.
@end ifset
@ifset familyF77
* Sign Intrinsic:: Apply sign to magnitude.
@end ifset
@ifset familyF2U
* Signal Intrinsic (subroutine):: Muck with signal handling.
@end ifset
@ifset familyBADU77
* Signal Intrinsic (function):: Muck with signal handling.
@end ifset
@ifset familyF77
* Sin Intrinsic:: Sine.
@end ifset
@ifset familyVXT
* SinD Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* SinH Intrinsic:: Hyperbolic sine.
@end ifset
@ifset familyF2U
* Sleep Intrinsic:: Sleep for a specified time.
@end ifset
@ifset familyF77
* Sngl Intrinsic:: Convert (archaic).
@end ifset
@ifset familyVXT
* SnglQ Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF90
* Spacing Intrinsic:: (Reserved for future use.)
* Spread Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* SqRt Intrinsic:: Square root.
@end ifset
@ifset familyF2U
* SRand Intrinsic:: Random seed.
* Stat Intrinsic (subroutine):: Get file information.
* Stat Intrinsic (function):: Get file information.
@end ifset
@ifset familyF90
* Sum Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF2U
* SymLnk Intrinsic (subroutine):: Make symbolic link in file system.
@end ifset
@ifset familyBADU77
* SymLnk Intrinsic (function):: Make symbolic link in file system.
@end ifset
@ifset familyF2U
* System Intrinsic (subroutine):: Invoke shell (system) command.
@end ifset
@ifset familyBADU77
* System Intrinsic (function):: Invoke shell (system) command.
@end ifset
@ifset familyF90
* System_Clock Intrinsic:: Get current system clock value.
@end ifset
@ifset familyF77
* Tan Intrinsic:: Tangent.
@end ifset
@ifset familyVXT
* TanD Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF77
* TanH Intrinsic:: Hyperbolic tangent.
@end ifset
@ifset familyF2U
* Time Intrinsic (UNIX):: Get current time as time value.
@end ifset
@ifset familyVXT
* Time Intrinsic (VXT):: Get the time as a character value.
@end ifset
@ifset familyF2U
* Time8 Intrinsic:: Get current time as time value.
@end ifset
@ifset familyF90
* Tiny Intrinsic:: (Reserved for future use.)
* Transfer Intrinsic:: (Reserved for future use.)
* Transpose Intrinsic:: (Reserved for future use.)
* Trim Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF2U
* TtyNam Intrinsic (subroutine):: Get name of terminal device for unit.
* TtyNam Intrinsic (function):: Get name of terminal device for unit.
@end ifset
@ifset familyF90
* UBound Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF2U
* UMask Intrinsic (subroutine):: Set file creation permissions mask.
@end ifset
@ifset familyBADU77
* UMask Intrinsic (function):: Set file creation permissions mask.
@end ifset
@ifset familyF2U
* Unlink Intrinsic (subroutine):: Unlink file.
@end ifset
@ifset familyBADU77
* Unlink Intrinsic (function):: Unlink file.
@end ifset
@ifset familyF90
* Unpack Intrinsic:: (Reserved for future use.)
* Verify Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF2C
* XOr Intrinsic:: Boolean XOR.
* ZAbs Intrinsic:: Absolute value (archaic).
* ZCos Intrinsic:: Cosine (archaic).
* ZExp Intrinsic:: Exponential (archaic).
@end ifset
@ifset familyVXT
* ZExt Intrinsic:: (Reserved for future use.)
@end ifset
@ifset familyF2C
* ZLog Intrinsic:: Natural logarithm (archaic).
* ZSin Intrinsic:: Sine (archaic).
* ZSqRt Intrinsic:: Square root (archaic).
@end ifset
@end menu
@ifset familyF2U
@node Abort Intrinsic
@subsubsection Abort Intrinsic
@cindex Abort intrinsic
@cindex intrinsics, Abort
@noindent
@example
CALL Abort()
@end example
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Prints a message and potentially causes a core dump via @code{abort(3)}.
@end ifset
@ifset familyF77
@node Abs Intrinsic
@subsubsection Abs Intrinsic
@cindex Abs intrinsic
@cindex intrinsics, Abs
@noindent
@example
Abs(@var{A})
@end example
@noindent
Abs: @code{INTEGER} or @code{REAL} function.
The exact type depends on that of argument @var{A}---if @var{A} is
@code{COMPLEX}, this function's type is @code{REAL}
with the same @samp{KIND=} value as the type of @var{A}.
Otherwise, this function's type is the same as that of @var{A}.
@noindent
@var{A}: @code{INTEGER}, @code{REAL}, or @code{COMPLEX}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns the absolute value of @var{A}.
If @var{A} is type @code{COMPLEX}, the absolute
value is computed as:
@example
SQRT(REALPART(@var{A})**2+IMAGPART(@var{A})**2)
@end example
@noindent
Otherwise, it is computed by negating @var{A} if
it is negative, or returning @var{A}.
@xref{Sign Intrinsic}, for how to explicitly
compute the positive or negative form of the absolute
value of an expression.
@end ifset
@ifset familyF2U
@node Access Intrinsic
@subsubsection Access Intrinsic
@cindex Access intrinsic
@cindex intrinsics, Access
@noindent
@example
Access(@var{Name}, @var{Mode})
@end example
@noindent
Access: @code{INTEGER(KIND=1)} function.
@noindent
@var{Name}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{Mode}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Checks file @var{Name} for accessibility in the mode specified by @var{Mode} and
returns 0 if the file is accessible in that mode, otherwise an error
code if the file is inaccessible or @var{Mode} is invalid.
See @code{access(2)}.
A null character (@samp{CHAR(0)}) marks the end of
the name in @var{Name}---otherwise,
trailing blanks in @var{Name} are ignored.
@var{Mode} may be a concatenation of any of the following characters:
@table @samp
@item r
Read permission
@item w
Write permission
@item x
Execute permission
@item @kbd{SPC}
Existence
@end table
@end ifset
@ifset familyASC
@node AChar Intrinsic
@subsubsection AChar Intrinsic
@cindex AChar intrinsic
@cindex intrinsics, AChar
@noindent
@example
AChar(@var{I})
@end example
@noindent
AChar: @code{CHARACTER*1} function.
@noindent
@var{I}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}, @code{f90}.
@noindent
Description:
Returns the ASCII character corresponding to the
code specified by @var{I}.
@xref{IAChar Intrinsic}, for the inverse of this function.
@xref{Char Intrinsic}, for the function corresponding
to the system's native character set.
@end ifset
@ifset familyF77
@node ACos Intrinsic
@subsubsection ACos Intrinsic
@cindex ACos intrinsic
@cindex intrinsics, ACos
@noindent
@example
ACos(@var{X})
@end example
@noindent
ACos: @code{REAL} function, the @samp{KIND=} value of the type being that of argument @var{X}.
@noindent
@var{X}: @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns the arc-cosine (inverse cosine) of @var{X}
in radians.
@xref{Cos Intrinsic}, for the inverse of this function.
@end ifset
@ifset familyVXT
@node ACosD Intrinsic
@subsubsection ACosD Intrinsic
@cindex ACosD intrinsic
@cindex intrinsics, ACosD
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL ACosD} to use this name for an
external procedure.
@end ifset
@ifset familyF90
@node AdjustL Intrinsic
@subsubsection AdjustL Intrinsic
@cindex AdjustL intrinsic
@cindex intrinsics, AdjustL
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL AdjustL} to use this name for an
external procedure.
@node AdjustR Intrinsic
@subsubsection AdjustR Intrinsic
@cindex AdjustR intrinsic
@cindex intrinsics, AdjustR
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL AdjustR} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node AImag Intrinsic
@subsubsection AImag Intrinsic
@cindex AImag intrinsic
@cindex intrinsics, AImag
@noindent
@example
AImag(@var{Z})
@end example
@noindent
AImag: @code{REAL} function.
This intrinsic is valid when argument @var{Z} is
@code{COMPLEX(KIND=1)}.
When @var{Z} is any other @code{COMPLEX} type,
this intrinsic is valid only when used as the argument to
@code{REAL()}, as explained below.
@noindent
@var{Z}: @code{COMPLEX}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns the (possibly converted) imaginary part of @var{Z}.
Use of @code{AIMAG()} with an argument of a type
other than @code{COMPLEX(KIND=1)} is restricted to the following case:
@example
REAL(AIMAG(Z))
@end example
@noindent
This expression converts the imaginary part of Z to
@code{REAL(KIND=1)}.
@xref{REAL() and AIMAG() of Complex}, for more information.
@end ifset
@ifset familyVXT
@node AIMax0 Intrinsic
@subsubsection AIMax0 Intrinsic
@cindex AIMax0 intrinsic
@cindex intrinsics, AIMax0
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL AIMax0} to use this name for an
external procedure.
@node AIMin0 Intrinsic
@subsubsection AIMin0 Intrinsic
@cindex AIMin0 intrinsic
@cindex intrinsics, AIMin0
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL AIMin0} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node AInt Intrinsic
@subsubsection AInt Intrinsic
@cindex AInt intrinsic
@cindex intrinsics, AInt
@noindent
@example
AInt(@var{A})
@end example
@noindent
AInt: @code{REAL} function, the @samp{KIND=} value of the type being that of argument @var{A}.
@noindent
@var{A}: @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns @var{A} with the fractional portion of its
magnitude truncated and its sign preserved.
(Also called ``truncation towards zero''.)
@xref{ANInt Intrinsic}, for how to round to nearest
whole number.
@xref{Int Intrinsic}, for how to truncate and then convert
number to @code{INTEGER}.
@end ifset
@ifset familyVXT
@node AJMax0 Intrinsic
@subsubsection AJMax0 Intrinsic
@cindex AJMax0 intrinsic
@cindex intrinsics, AJMax0
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL AJMax0} to use this name for an
external procedure.
@node AJMin0 Intrinsic
@subsubsection AJMin0 Intrinsic
@cindex AJMin0 intrinsic
@cindex intrinsics, AJMin0
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL AJMin0} to use this name for an
external procedure.
@end ifset
@ifset familyF2U
@node Alarm Intrinsic
@subsubsection Alarm Intrinsic
@cindex Alarm intrinsic
@cindex intrinsics, Alarm
@noindent
@example
CALL Alarm(@var{Seconds}, @var{Handler}, @var{Status})
@end example
@noindent
@var{Seconds}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Handler}: Signal handler (@code{INTEGER FUNCTION} or @code{SUBROUTINE})
or dummy/global @code{INTEGER(KIND=1)} scalar.
@noindent
@var{Status}: @code{INTEGER(KIND=1)}; OPTIONAL; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Causes external subroutine @var{Handler} to be executed after a delay of
@var{Seconds} seconds by using @code{alarm(1)} to set up a signal and
@code{signal(2)} to catch it.
If @var{Status} is supplied, it will be
returned with the number of seconds remaining until any previously
scheduled alarm was due to be delivered, or zero if there was no
previously scheduled alarm.
@xref{Signal Intrinsic (subroutine)}.
@end ifset
@ifset familyF90
@node All Intrinsic
@subsubsection All Intrinsic
@cindex All intrinsic
@cindex intrinsics, All
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL All} to use this name for an
external procedure.
@node Allocated Intrinsic
@subsubsection Allocated Intrinsic
@cindex Allocated intrinsic
@cindex intrinsics, Allocated
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Allocated} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node ALog Intrinsic
@subsubsection ALog Intrinsic
@cindex ALog intrinsic
@cindex intrinsics, ALog
@noindent
@example
ALog(@var{X})
@end example
@noindent
ALog: @code{REAL(KIND=1)} function.
@noindent
@var{X}: @code{REAL(KIND=1)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{LOG()} that is specific
to one type for @var{X}.
@xref{Log Intrinsic}.
@node ALog10 Intrinsic
@subsubsection ALog10 Intrinsic
@cindex ALog10 intrinsic
@cindex intrinsics, ALog10
@noindent
@example
ALog10(@var{X})
@end example
@noindent
ALog10: @code{REAL(KIND=1)} function.
@noindent
@var{X}: @code{REAL(KIND=1)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{LOG10()} that is specific
to one type for @var{X}.
@xref{Log10 Intrinsic}.
@node AMax0 Intrinsic
@subsubsection AMax0 Intrinsic
@cindex AMax0 intrinsic
@cindex intrinsics, AMax0
@noindent
@example
AMax0(@var{A}-1, @var{A}-2, @dots{}, @var{A}-n)
@end example
@noindent
AMax0: @code{REAL(KIND=1)} function.
@noindent
@var{A}: @code{INTEGER(KIND=1)}; at least two such arguments must be provided; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{MAX()} that is specific
to one type for @var{A} and a different return type.
@xref{Max Intrinsic}.
@node AMax1 Intrinsic
@subsubsection AMax1 Intrinsic
@cindex AMax1 intrinsic
@cindex intrinsics, AMax1
@noindent
@example
AMax1(@var{A}-1, @var{A}-2, @dots{}, @var{A}-n)
@end example
@noindent
AMax1: @code{REAL(KIND=1)} function.
@noindent
@var{A}: @code{REAL(KIND=1)}; at least two such arguments must be provided; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{MAX()} that is specific
to one type for @var{A}.
@xref{Max Intrinsic}.
@node AMin0 Intrinsic
@subsubsection AMin0 Intrinsic
@cindex AMin0 intrinsic
@cindex intrinsics, AMin0
@noindent
@example
AMin0(@var{A}-1, @var{A}-2, @dots{}, @var{A}-n)
@end example
@noindent
AMin0: @code{REAL(KIND=1)} function.
@noindent
@var{A}: @code{INTEGER(KIND=1)}; at least two such arguments must be provided; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{MIN()} that is specific
to one type for @var{A} and a different return type.
@xref{Min Intrinsic}.
@node AMin1 Intrinsic
@subsubsection AMin1 Intrinsic
@cindex AMin1 intrinsic
@cindex intrinsics, AMin1
@noindent
@example
AMin1(@var{A}-1, @var{A}-2, @dots{}, @var{A}-n)
@end example
@noindent
AMin1: @code{REAL(KIND=1)} function.
@noindent
@var{A}: @code{REAL(KIND=1)}; at least two such arguments must be provided; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{MIN()} that is specific
to one type for @var{A}.
@xref{Min Intrinsic}.
@node AMod Intrinsic
@subsubsection AMod Intrinsic
@cindex AMod intrinsic
@cindex intrinsics, AMod
@noindent
@example
AMod(@var{A}, @var{P})
@end example
@noindent
AMod: @code{REAL(KIND=1)} function.
@noindent
@var{A}: @code{REAL(KIND=1)}; scalar; INTENT(IN).
@noindent
@var{P}: @code{REAL(KIND=1)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{MOD()} that is specific
to one type for @var{A}.
@xref{Mod Intrinsic}.
@end ifset
@ifset familyF2C
@node And Intrinsic
@subsubsection And Intrinsic
@cindex And intrinsic
@cindex intrinsics, And
@noindent
@example
And(@var{I}, @var{J})
@end example
@noindent
And: @code{INTEGER} or @code{LOGICAL} function, the exact type being the result of cross-promoting the
types of all the arguments.
@noindent
@var{I}: @code{INTEGER} or @code{LOGICAL}; scalar; INTENT(IN).
@noindent
@var{J}: @code{INTEGER} or @code{LOGICAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}.
@noindent
Description:
Returns value resulting from boolean AND of
pair of bits in each of @var{I} and @var{J}.
@end ifset
@ifset familyF77
@node ANInt Intrinsic
@subsubsection ANInt Intrinsic
@cindex ANInt intrinsic
@cindex intrinsics, ANInt
@noindent
@example
ANInt(@var{A})
@end example
@noindent
ANInt: @code{REAL} function, the @samp{KIND=} value of the type being that of argument @var{A}.
@noindent
@var{A}: @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns @var{A} with the fractional portion of its
magnitude eliminated by rounding to the nearest whole
number and with its sign preserved.
A fractional portion exactly equal to
@samp{.5} is rounded to the whole number that
is larger in magnitude.
(Also called ``Fortran round''.)
@xref{AInt Intrinsic}, for how to truncate to
whole number.
@xref{NInt Intrinsic}, for how to round and then convert
number to @code{INTEGER}.
@end ifset
@ifset familyF90
@node Any Intrinsic
@subsubsection Any Intrinsic
@cindex Any intrinsic
@cindex intrinsics, Any
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Any} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node ASin Intrinsic
@subsubsection ASin Intrinsic
@cindex ASin intrinsic
@cindex intrinsics, ASin
@noindent
@example
ASin(@var{X})
@end example
@noindent
ASin: @code{REAL} function, the @samp{KIND=} value of the type being that of argument @var{X}.
@noindent
@var{X}: @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns the arc-sine (inverse sine) of @var{X}
in radians.
@xref{Sin Intrinsic}, for the inverse of this function.
@end ifset
@ifset familyVXT
@node ASinD Intrinsic
@subsubsection ASinD Intrinsic
@cindex ASinD intrinsic
@cindex intrinsics, ASinD
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL ASinD} to use this name for an
external procedure.
@end ifset
@ifset familyF90
@node Associated Intrinsic
@subsubsection Associated Intrinsic
@cindex Associated intrinsic
@cindex intrinsics, Associated
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Associated} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node ATan Intrinsic
@subsubsection ATan Intrinsic
@cindex ATan intrinsic
@cindex intrinsics, ATan
@noindent
@example
ATan(@var{X})
@end example
@noindent
ATan: @code{REAL} function, the @samp{KIND=} value of the type being that of argument @var{X}.
@noindent
@var{X}: @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns the arc-tangent (inverse tangent) of @var{X}
in radians.
@xref{Tan Intrinsic}, for the inverse of this function.
@node ATan2 Intrinsic
@subsubsection ATan2 Intrinsic
@cindex ATan2 intrinsic
@cindex intrinsics, ATan2
@noindent
@example
ATan2(@var{Y}, @var{X})
@end example
@noindent
ATan2: @code{REAL} function, the exact type being the result of cross-promoting the
types of all the arguments.
@noindent
@var{Y}: @code{REAL}; scalar; INTENT(IN).
@noindent
@var{X}: @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns the arc-tangent (inverse tangent) of the complex
number (@var{Y}, @var{X}) in radians.
@xref{Tan Intrinsic}, for the inverse of this function.
@end ifset
@ifset familyVXT
@node ATan2D Intrinsic
@subsubsection ATan2D Intrinsic
@cindex ATan2D intrinsic
@cindex intrinsics, ATan2D
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL ATan2D} to use this name for an
external procedure.
@node ATanD Intrinsic
@subsubsection ATanD Intrinsic
@cindex ATanD intrinsic
@cindex intrinsics, ATanD
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL ATanD} to use this name for an
external procedure.
@end ifset
@ifset familyF2U
@node BesJ0 Intrinsic
@subsubsection BesJ0 Intrinsic
@cindex BesJ0 intrinsic
@cindex intrinsics, BesJ0
@noindent
@example
BesJ0(@var{X})
@end example
@noindent
BesJ0: @code{REAL} function, the @samp{KIND=} value of the type being that of argument @var{X}.
@noindent
@var{X}: @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Calculates the Bessel function of the first kind of order 0 of @var{X}.
See @code{bessel(3m)}, on whose implementation the function depends.
@node BesJ1 Intrinsic
@subsubsection BesJ1 Intrinsic
@cindex BesJ1 intrinsic
@cindex intrinsics, BesJ1
@noindent
@example
BesJ1(@var{X})
@end example
@noindent
BesJ1: @code{REAL} function, the @samp{KIND=} value of the type being that of argument @var{X}.
@noindent
@var{X}: @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Calculates the Bessel function of the first kind of order 1 of @var{X}.
See @code{bessel(3m)}, on whose implementation the function depends.
@node BesJN Intrinsic
@subsubsection BesJN Intrinsic
@cindex BesJN intrinsic
@cindex intrinsics, BesJN
@noindent
@example
BesJN(@var{N}, @var{X})
@end example
@noindent
BesJN: @code{REAL} function, the @samp{KIND=} value of the type being that of argument @var{X}.
@noindent
@var{N}: @code{INTEGER} not wider than the default kind; scalar; INTENT(IN).
@noindent
@var{X}: @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Calculates the Bessel function of the first kind of order @var{N} of @var{X}.
See @code{bessel(3m)}, on whose implementation the function depends.
@node BesY0 Intrinsic
@subsubsection BesY0 Intrinsic
@cindex BesY0 intrinsic
@cindex intrinsics, BesY0
@noindent
@example
BesY0(@var{X})
@end example
@noindent
BesY0: @code{REAL} function, the @samp{KIND=} value of the type being that of argument @var{X}.
@noindent
@var{X}: @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Calculates the Bessel function of the second kind of order 0 of @var{X}.
See @code{bessel(3m)}, on whose implementation the function depends.
@node BesY1 Intrinsic
@subsubsection BesY1 Intrinsic
@cindex BesY1 intrinsic
@cindex intrinsics, BesY1
@noindent
@example
BesY1(@var{X})
@end example
@noindent
BesY1: @code{REAL} function, the @samp{KIND=} value of the type being that of argument @var{X}.
@noindent
@var{X}: @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Calculates the Bessel function of the second kind of order 1 of @var{X}.
See @code{bessel(3m)}, on whose implementation the function depends.
@node BesYN Intrinsic
@subsubsection BesYN Intrinsic
@cindex BesYN intrinsic
@cindex intrinsics, BesYN
@noindent
@example
BesYN(@var{N}, @var{X})
@end example
@noindent
BesYN: @code{REAL} function, the @samp{KIND=} value of the type being that of argument @var{X}.
@noindent
@var{N}: @code{INTEGER} not wider than the default kind; scalar; INTENT(IN).
@noindent
@var{X}: @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Calculates the Bessel function of the second kind of order @var{N} of @var{X}.
See @code{bessel(3m)}, on whose implementation the function depends.
@end ifset
@ifset familyVXT
@node BITest Intrinsic
@subsubsection BITest Intrinsic
@cindex BITest intrinsic
@cindex intrinsics, BITest
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL BITest} to use this name for an
external procedure.
@end ifset
@ifset familyF90
@node Bit_Size Intrinsic
@subsubsection Bit_Size Intrinsic
@cindex Bit_Size intrinsic
@cindex intrinsics, Bit_Size
@noindent
@example
Bit_Size(@var{I})
@end example
@noindent
Bit_Size: @code{INTEGER} function, the @samp{KIND=} value of the type being that of argument @var{I}.
@noindent
@var{I}: @code{INTEGER}; scalar.
@noindent
Intrinsic groups: @code{f90}.
@noindent
Description:
Returns the number of bits (integer precision plus sign bit)
represented by the type for @var{I}.
@xref{BTest Intrinsic}, for how to test the value of a
bit in a variable or array.
@xref{IBSet Intrinsic}, for how to set a bit in a variable to 1.
@xref{IBClr Intrinsic}, for how to set a bit in a variable to 0.
@end ifset
@ifset familyVXT
@node BJTest Intrinsic
@subsubsection BJTest Intrinsic
@cindex BJTest intrinsic
@cindex intrinsics, BJTest
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL BJTest} to use this name for an
external procedure.
@end ifset
@ifset familyMIL
@node BTest Intrinsic
@subsubsection BTest Intrinsic
@cindex BTest intrinsic
@cindex intrinsics, BTest
@noindent
@example
BTest(@var{I}, @var{Pos})
@end example
@noindent
BTest: @code{LOGICAL(KIND=1)} function.
@noindent
@var{I}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Pos}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{mil}, @code{f90}, @code{vxt}.
@noindent
Description:
Returns @code{.TRUE.} if bit @var{Pos} in @var{I} is
1, @code{.FALSE.} otherwise.
(Bit 0 is the low-order (rightmost) bit, adding the value
@ifinfo
2**0,
@end ifinfo
@iftex
@tex
$2^0$,
@end tex
@end iftex
or 1,
to the number if set to 1;
bit 1 is the next-higher-order bit, adding
@ifinfo
2**1,
@end ifinfo
@iftex
@tex
$2^1$,
@end tex
@end iftex
or 2;
bit 2 adds
@ifinfo
2**2,
@end ifinfo
@iftex
@tex
$2^2$,
@end tex
@end iftex
or 4; and so on.)
@xref{Bit_Size Intrinsic}, for how to obtain the number of bits
in a type.
The leftmost bit of @var{I} is @samp{BIT_SIZE(@var{I}-1)}.
@end ifset
@ifset familyF77
@node CAbs Intrinsic
@subsubsection CAbs Intrinsic
@cindex CAbs intrinsic
@cindex intrinsics, CAbs
@noindent
@example
CAbs(@var{A})
@end example
@noindent
CAbs: @code{REAL(KIND=1)} function.
@noindent
@var{A}: @code{COMPLEX(KIND=1)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{ABS()} that is specific
to one type for @var{A}.
@xref{Abs Intrinsic}.
@node CCos Intrinsic
@subsubsection CCos Intrinsic
@cindex CCos intrinsic
@cindex intrinsics, CCos
@noindent
@example
CCos(@var{X})
@end example
@noindent
CCos: @code{COMPLEX(KIND=1)} function.
@noindent
@var{X}: @code{COMPLEX(KIND=1)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{COS()} that is specific
to one type for @var{X}.
@xref{Cos Intrinsic}.
@end ifset
@ifset familyFVZ
@node CDAbs Intrinsic
@subsubsection CDAbs Intrinsic
@cindex CDAbs intrinsic
@cindex intrinsics, CDAbs
@noindent
@example
CDAbs(@var{A})
@end example
@noindent
CDAbs: @code{REAL(KIND=2)} function.
@noindent
@var{A}: @code{COMPLEX(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}, @code{vxt}.
@noindent
Description:
Archaic form of @code{ABS()} that is specific
to one type for @var{A}.
@xref{Abs Intrinsic}.
@node CDCos Intrinsic
@subsubsection CDCos Intrinsic
@cindex CDCos intrinsic
@cindex intrinsics, CDCos
@noindent
@example
CDCos(@var{X})
@end example
@noindent
CDCos: @code{COMPLEX(KIND=2)} function.
@noindent
@var{X}: @code{COMPLEX(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}, @code{vxt}.
@noindent
Description:
Archaic form of @code{COS()} that is specific
to one type for @var{X}.
@xref{Cos Intrinsic}.
@node CDExp Intrinsic
@subsubsection CDExp Intrinsic
@cindex CDExp intrinsic
@cindex intrinsics, CDExp
@noindent
@example
CDExp(@var{X})
@end example
@noindent
CDExp: @code{COMPLEX(KIND=2)} function.
@noindent
@var{X}: @code{COMPLEX(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}, @code{vxt}.
@noindent
Description:
Archaic form of @code{EXP()} that is specific
to one type for @var{X}.
@xref{Exp Intrinsic}.
@node CDLog Intrinsic
@subsubsection CDLog Intrinsic
@cindex CDLog intrinsic
@cindex intrinsics, CDLog
@noindent
@example
CDLog(@var{X})
@end example
@noindent
CDLog: @code{COMPLEX(KIND=2)} function.
@noindent
@var{X}: @code{COMPLEX(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}, @code{vxt}.
@noindent
Description:
Archaic form of @code{LOG()} that is specific
to one type for @var{X}.
@xref{Log Intrinsic}.
@node CDSin Intrinsic
@subsubsection CDSin Intrinsic
@cindex CDSin intrinsic
@cindex intrinsics, CDSin
@noindent
@example
CDSin(@var{X})
@end example
@noindent
CDSin: @code{COMPLEX(KIND=2)} function.
@noindent
@var{X}: @code{COMPLEX(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}, @code{vxt}.
@noindent
Description:
Archaic form of @code{SIN()} that is specific
to one type for @var{X}.
@xref{Sin Intrinsic}.
@node CDSqRt Intrinsic
@subsubsection CDSqRt Intrinsic
@cindex CDSqRt intrinsic
@cindex intrinsics, CDSqRt
@noindent
@example
CDSqRt(@var{X})
@end example
@noindent
CDSqRt: @code{COMPLEX(KIND=2)} function.
@noindent
@var{X}: @code{COMPLEX(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}, @code{vxt}.
@noindent
Description:
Archaic form of @code{SQRT()} that is specific
to one type for @var{X}.
@xref{SqRt Intrinsic}.
@end ifset
@ifset familyF90
@node Ceiling Intrinsic
@subsubsection Ceiling Intrinsic
@cindex Ceiling intrinsic
@cindex intrinsics, Ceiling
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Ceiling} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node CExp Intrinsic
@subsubsection CExp Intrinsic
@cindex CExp intrinsic
@cindex intrinsics, CExp
@noindent
@example
CExp(@var{X})
@end example
@noindent
CExp: @code{COMPLEX(KIND=1)} function.
@noindent
@var{X}: @code{COMPLEX(KIND=1)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{EXP()} that is specific
to one type for @var{X}.
@xref{Exp Intrinsic}.
@node Char Intrinsic
@subsubsection Char Intrinsic
@cindex Char intrinsic
@cindex intrinsics, Char
@noindent
@example
Char(@var{I})
@end example
@noindent
Char: @code{CHARACTER*1} function.
@noindent
@var{I}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns the character corresponding to the
code specified by @var{I}, using the system's
native character set.
Because the system's native character set is used,
the correspondence between character and their codes
is not necessarily the same between GNU Fortran
implementations.
Note that no intrinsic exists to convert a numerical
value to a printable character string.
For example, there is no intrinsic that, given
an @code{INTEGER} or @code{REAL} argument with the
value @samp{154}, returns the @code{CHARACTER}
result @samp{'154'}.
Instead, you can use internal-file I/O to do this kind
of conversion.
For example:
@smallexample
INTEGER VALUE
CHARACTER*10 STRING
VALUE = 154
WRITE (STRING, '(I10)'), VALUE
PRINT *, STRING
END
@end smallexample
The above program, when run, prints:
@smallexample
154
@end smallexample
@xref{IChar Intrinsic}, for the inverse of the @code{CHAR} function.
@xref{AChar Intrinsic}, for the function corresponding
to the ASCII character set.
@end ifset
@ifset familyF2U
@node ChDir Intrinsic (subroutine)
@subsubsection ChDir Intrinsic (subroutine)
@cindex ChDir intrinsic
@cindex intrinsics, ChDir
@noindent
@example
CALL ChDir(@var{Dir}, @var{Status})
@end example
@noindent
@var{Dir}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{Status}: @code{INTEGER(KIND=1)}; OPTIONAL; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Sets the current working directory to be @var{Dir}.
If the @var{Status} argument is supplied, it contains 0
on success or a nonzero error code otherwise upon return.
See @code{chdir(3)}.
@emph{Caution:} Using this routine during I/O to a unit connected with a
non-absolute file name can cause subsequent I/O on such a unit to fail
because the I/O library might reopen files by name.
Some non-GNU implementations of Fortran provide this intrinsic as
only a function, not as a subroutine, or do not support the
(optional) @var{Status} argument.
For information on other intrinsics with the same name:
@xref{ChDir Intrinsic (function)}.
@end ifset
@ifset familyBADU77
@node ChDir Intrinsic (function)
@subsubsection ChDir Intrinsic (function)
@cindex ChDir intrinsic
@cindex intrinsics, ChDir
@noindent
@example
ChDir(@var{Dir})
@end example
@noindent
ChDir: @code{INTEGER(KIND=1)} function.
@noindent
@var{Dir}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{badu77}.
@noindent
Description:
Sets the current working directory to be @var{Dir}.
Returns 0 on success or a nonzero error code.
See @code{chdir(3)}.
@emph{Caution:} Using this routine during I/O to a unit connected with a
non-absolute file name can cause subsequent I/O on such a unit to fail
because the I/O library might reopen files by name.
Due to the side effects performed by this intrinsic, the function
form is not recommended.
For information on other intrinsics with the same name:
@xref{ChDir Intrinsic (subroutine)}.
@end ifset
@ifset familyF2U
@node ChMod Intrinsic (subroutine)
@subsubsection ChMod Intrinsic (subroutine)
@cindex ChMod intrinsic
@cindex intrinsics, ChMod
@noindent
@example
CALL ChMod(@var{Name}, @var{Mode}, @var{Status})
@end example
@noindent
@var{Name}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{Mode}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{Status}: @code{INTEGER(KIND=1)}; OPTIONAL; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Changes the access mode of file @var{Name} according to the
specification @var{Mode}, which is given in the format of
@code{chmod(1)}.
A null character (@samp{CHAR(0)}) marks the end of
the name in @var{Name}---otherwise,
trailing blanks in @var{Name} are ignored.
Currently, @var{Name} must not contain the single quote
character.
If the @var{Status} argument is supplied, it contains
0 on success or a nonzero error code upon return.
Note that this currently works
by actually invoking @code{/bin/chmod} (or the @code{chmod} found when
the library was configured) and so might fail in some circumstances and
will, anyway, be slow.
Some non-GNU implementations of Fortran provide this intrinsic as
only a function, not as a subroutine, or do not support the
(optional) @var{Status} argument.
For information on other intrinsics with the same name:
@xref{ChMod Intrinsic (function)}.
@end ifset
@ifset familyBADU77
@node ChMod Intrinsic (function)
@subsubsection ChMod Intrinsic (function)
@cindex ChMod intrinsic
@cindex intrinsics, ChMod
@noindent
@example
ChMod(@var{Name}, @var{Mode})
@end example
@noindent
ChMod: @code{INTEGER(KIND=1)} function.
@noindent
@var{Name}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{Mode}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{badu77}.
@noindent
Description:
Changes the access mode of file @var{Name} according to the
specification @var{Mode}, which is given in the format of
@code{chmod(1)}.
A null character (@samp{CHAR(0)}) marks the end of
the name in @var{Name}---otherwise,
trailing blanks in @var{Name} are ignored.
Currently, @var{Name} must not contain the single quote
character.
Returns 0 on success or a nonzero error code otherwise.
Note that this currently works
by actually invoking @code{/bin/chmod} (or the @code{chmod} found when
the library was configured) and so might fail in some circumstances and
will, anyway, be slow.
Due to the side effects performed by this intrinsic, the function
form is not recommended.
For information on other intrinsics with the same name:
@xref{ChMod Intrinsic (subroutine)}.
@end ifset
@ifset familyF77
@node CLog Intrinsic
@subsubsection CLog Intrinsic
@cindex CLog intrinsic
@cindex intrinsics, CLog
@noindent
@example
CLog(@var{X})
@end example
@noindent
CLog: @code{COMPLEX(KIND=1)} function.
@noindent
@var{X}: @code{COMPLEX(KIND=1)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{LOG()} that is specific
to one type for @var{X}.
@xref{Log Intrinsic}.
@node Cmplx Intrinsic
@subsubsection Cmplx Intrinsic
@cindex Cmplx intrinsic
@cindex intrinsics, Cmplx
@noindent
@example
Cmplx(@var{X}, @var{Y})
@end example
@noindent
Cmplx: @code{COMPLEX(KIND=1)} function.
@noindent
@var{X}: @code{INTEGER}, @code{REAL}, or @code{COMPLEX}; scalar; INTENT(IN).
@noindent
@var{Y}: @code{INTEGER} or @code{REAL}; OPTIONAL (must be omitted if @var{X} is @code{COMPLEX}); scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
If @var{X} is not type @code{COMPLEX},
constructs a value of type @code{COMPLEX(KIND=1)} from the
real and imaginary values specified by @var{X} and
@var{Y}, respectively.
If @var{Y} is omitted, @samp{0.} is assumed.
If @var{X} is type @code{COMPLEX},
converts it to type @code{COMPLEX(KIND=1)}.
@xref{Complex Intrinsic}, for information on easily constructing
a @code{COMPLEX} value of arbitrary precision from @code{REAL}
arguments.
@end ifset
@ifset familyGNU
@node Complex Intrinsic
@subsubsection Complex Intrinsic
@cindex Complex intrinsic
@cindex intrinsics, Complex
@noindent
@example
Complex(@var{Real}, @var{Imag})
@end example
@noindent
Complex: @code{COMPLEX} function, the exact type being the result of cross-promoting the
types of all the arguments.
@noindent
@var{Real}: @code{INTEGER} or @code{REAL}; scalar; INTENT(IN).
@noindent
@var{Imag}: @code{INTEGER} or @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{gnu}.
@noindent
Description:
Returns a @code{COMPLEX} value that has @samp{Real} and @samp{Imag} as its
real and imaginary parts, respectively.
If @var{Real} and @var{Imag} are the same type, and that type is not
@code{INTEGER}, no data conversion is performed, and the type of
the resulting value has the same kind value as the types
of @var{Real} and @var{Imag}.
If @var{Real} and @var{Imag} are not the same type, the usual type-promotion
rules are applied to both, converting either or both to the
appropriate @code{REAL} type.
The type of the resulting value has the same kind value as the
type to which both @var{Real} and @var{Imag} were converted, in this case.
If @var{Real} and @var{Imag} are both @code{INTEGER}, they are both converted
to @code{REAL(KIND=1)}, and the result of the @code{COMPLEX()}
invocation is type @code{COMPLEX(KIND=1)}.
@emph{Note:} The way to do this in standard Fortran 90
is too hairy to describe here, but it is important to
note that @samp{CMPLX(D1,D2)} returns a @code{COMPLEX(KIND=1)}
result even if @samp{D1} and @samp{D2} are type @code{REAL(KIND=2)}.
Hence the availability of @code{COMPLEX()} in GNU Fortran.
@end ifset
@ifset familyF77
@node Conjg Intrinsic
@subsubsection Conjg Intrinsic
@cindex Conjg intrinsic
@cindex intrinsics, Conjg
@noindent
@example
Conjg(@var{Z})
@end example
@noindent
Conjg: @code{COMPLEX} function, the @samp{KIND=} value of the type being that of argument @var{Z}.
@noindent
@var{Z}: @code{COMPLEX}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns the complex conjugate:
@example
COMPLEX(REALPART(@var{Z}), -IMAGPART(@var{Z}))
@end example
@node Cos Intrinsic
@subsubsection Cos Intrinsic
@cindex Cos intrinsic
@cindex intrinsics, Cos
@noindent
@example
Cos(@var{X})
@end example
@noindent
Cos: @code{REAL} or @code{COMPLEX} function, the exact type being that of argument @var{X}.
@noindent
@var{X}: @code{REAL} or @code{COMPLEX}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns the cosine of @var{X}, an angle measured
in radians.
@xref{ACos Intrinsic}, for the inverse of this function.
@end ifset
@ifset familyVXT
@node CosD Intrinsic
@subsubsection CosD Intrinsic
@cindex CosD intrinsic
@cindex intrinsics, CosD
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL CosD} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node CosH Intrinsic
@subsubsection CosH Intrinsic
@cindex CosH intrinsic
@cindex intrinsics, CosH
@noindent
@example
CosH(@var{X})
@end example
@noindent
CosH: @code{REAL} function, the @samp{KIND=} value of the type being that of argument @var{X}.
@noindent
@var{X}: @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns the hyperbolic cosine of @var{X}.
@end ifset
@ifset familyF90
@node Count Intrinsic
@subsubsection Count Intrinsic
@cindex Count intrinsic
@cindex intrinsics, Count
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Count} to use this name for an
external procedure.
@node CPU_Time Intrinsic
@subsubsection CPU_Time Intrinsic
@cindex CPU_Time intrinsic
@cindex intrinsics, CPU_Time
@noindent
@example
CALL CPU_Time(@var{Seconds})
@end example
@noindent
@var{Seconds}: @code{REAL}; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{f90}.
@noindent
Description:
Returns in @var{Seconds} the current value of the system time.
This implementation of the Fortran 95 intrinsic is just an alias for
@code{second} @xref{Second Intrinsic (subroutine)}.
@cindex wraparound, timings
@cindex limits, timings
On some systems, the underlying timings are represented
using types with sufficiently small limits that overflows
(wraparounds) are possible, such as 32-bit types.
Therefore, the values returned by this intrinsic
might be, or become, negative,
or numerically less than previous values,
during a single run of the compiled program.
@node CShift Intrinsic
@subsubsection CShift Intrinsic
@cindex CShift intrinsic
@cindex intrinsics, CShift
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL CShift} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node CSin Intrinsic
@subsubsection CSin Intrinsic
@cindex CSin intrinsic
@cindex intrinsics, CSin
@noindent
@example
CSin(@var{X})
@end example
@noindent
CSin: @code{COMPLEX(KIND=1)} function.
@noindent
@var{X}: @code{COMPLEX(KIND=1)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{SIN()} that is specific
to one type for @var{X}.
@xref{Sin Intrinsic}.
@node CSqRt Intrinsic
@subsubsection CSqRt Intrinsic
@cindex CSqRt intrinsic
@cindex intrinsics, CSqRt
@noindent
@example
CSqRt(@var{X})
@end example
@noindent
CSqRt: @code{COMPLEX(KIND=1)} function.
@noindent
@var{X}: @code{COMPLEX(KIND=1)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{SQRT()} that is specific
to one type for @var{X}.
@xref{SqRt Intrinsic}.
@end ifset
@ifset familyF2U
@node CTime Intrinsic (subroutine)
@subsubsection CTime Intrinsic (subroutine)
@cindex CTime intrinsic
@cindex intrinsics, CTime
@noindent
@example
CALL CTime(@var{STime}, @var{Result})
@end example
@noindent
@var{STime}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Result}: @code{CHARACTER}; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Converts @var{STime}, a system time value, such as returned by
@code{TIME8()}, to a string of the form @samp{Sat Aug 19 18:13:14 1995},
and returns that string in @var{Result}.
@xref{Time8 Intrinsic}.
Some non-GNU implementations of Fortran provide this intrinsic as
only a function, not as a subroutine.
For information on other intrinsics with the same name:
@xref{CTime Intrinsic (function)}.
@node CTime Intrinsic (function)
@subsubsection CTime Intrinsic (function)
@cindex CTime intrinsic
@cindex intrinsics, CTime
@noindent
@example
CTime(@var{STime})
@end example
@noindent
CTime: @code{CHARACTER*(*)} function.
@noindent
@var{STime}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Converts @var{STime}, a system time value, such as returned by
@code{TIME8()}, to a string of the form @samp{Sat Aug 19 18:13:14 1995},
and returns that string as the function value.
@xref{Time8 Intrinsic}.
For information on other intrinsics with the same name:
@xref{CTime Intrinsic (subroutine)}.
@end ifset
@ifset familyF77
@node DAbs Intrinsic
@subsubsection DAbs Intrinsic
@cindex DAbs intrinsic
@cindex intrinsics, DAbs
@noindent
@example
DAbs(@var{A})
@end example
@noindent
DAbs: @code{REAL(KIND=2)} function.
@noindent
@var{A}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{ABS()} that is specific
to one type for @var{A}.
@xref{Abs Intrinsic}.
@node DACos Intrinsic
@subsubsection DACos Intrinsic
@cindex DACos intrinsic
@cindex intrinsics, DACos
@noindent
@example
DACos(@var{X})
@end example
@noindent
DACos: @code{REAL(KIND=2)} function.
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{ACOS()} that is specific
to one type for @var{X}.
@xref{ACos Intrinsic}.
@end ifset
@ifset familyVXT
@node DACosD Intrinsic
@subsubsection DACosD Intrinsic
@cindex DACosD intrinsic
@cindex intrinsics, DACosD
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL DACosD} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node DASin Intrinsic
@subsubsection DASin Intrinsic
@cindex DASin intrinsic
@cindex intrinsics, DASin
@noindent
@example
DASin(@var{X})
@end example
@noindent
DASin: @code{REAL(KIND=2)} function.
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{ASIN()} that is specific
to one type for @var{X}.
@xref{ASin Intrinsic}.
@end ifset
@ifset familyVXT
@node DASinD Intrinsic
@subsubsection DASinD Intrinsic
@cindex DASinD intrinsic
@cindex intrinsics, DASinD
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL DASinD} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node DATan Intrinsic
@subsubsection DATan Intrinsic
@cindex DATan intrinsic
@cindex intrinsics, DATan
@noindent
@example
DATan(@var{X})
@end example
@noindent
DATan: @code{REAL(KIND=2)} function.
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{ATAN()} that is specific
to one type for @var{X}.
@xref{ATan Intrinsic}.
@node DATan2 Intrinsic
@subsubsection DATan2 Intrinsic
@cindex DATan2 intrinsic
@cindex intrinsics, DATan2
@noindent
@example
DATan2(@var{Y}, @var{X})
@end example
@noindent
DATan2: @code{REAL(KIND=2)} function.
@noindent
@var{Y}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{ATAN2()} that is specific
to one type for @var{Y} and @var{X}.
@xref{ATan2 Intrinsic}.
@end ifset
@ifset familyVXT
@node DATan2D Intrinsic
@subsubsection DATan2D Intrinsic
@cindex DATan2D intrinsic
@cindex intrinsics, DATan2D
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL DATan2D} to use this name for an
external procedure.
@node DATanD Intrinsic
@subsubsection DATanD Intrinsic
@cindex DATanD intrinsic
@cindex intrinsics, DATanD
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL DATanD} to use this name for an
external procedure.
@node Date Intrinsic
@subsubsection Date Intrinsic
@cindex Date intrinsic
@cindex intrinsics, Date
@noindent
@example
CALL Date(@var{Date})
@end example
@noindent
@var{Date}: @code{CHARACTER}; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{vxt}.
@noindent
Description:
Returns @var{Date} in the form @samp{@var{dd}-@var{mmm}-@var{yy}},
representing the numeric day of the month @var{dd}, a three-character
abbreviation of the month name @var{mmm} and the last two digits of
the year @var{yy}, e.g.@: @samp{25-Nov-96}.
@cindex Y2K compliance
@cindex Year 2000 compliance
This intrinsic is not recommended, due to the year 2000 approaching.
Therefore, programs making use of this intrinsic
might not be Year 2000 (Y2K) compliant.
@xref{CTime Intrinsic (subroutine)}, for information on obtaining more digits
for the current (or any) date.
@end ifset
@ifset familyF90
@node Date_and_Time Intrinsic
@subsubsection Date_and_Time Intrinsic
@cindex Date_and_Time intrinsic
@cindex intrinsics, Date_and_Time
@noindent
@example
CALL Date_and_Time(@var{Date}, @var{Time}, @var{Zone}, @var{Values})
@end example
@noindent
@var{Date}: @code{CHARACTER}; scalar; INTENT(OUT).
@noindent
@var{Time}: @code{CHARACTER}; OPTIONAL; scalar; INTENT(OUT).
@noindent
@var{Zone}: @code{CHARACTER}; OPTIONAL; scalar; INTENT(OUT).
@noindent
@var{Values}: @code{INTEGER(KIND=1)}; OPTIONAL; DIMENSION(8); INTENT(OUT).
@noindent
Intrinsic groups: @code{f90}.
@noindent
Description:
Returns:
@table @var
@item Date
The date in the form @var{ccyymmdd}: century, year, month and day;
@item Time
The time in the form @samp{@var{hhmmss.ss}}: hours, minutes, seconds
and milliseconds;
@item Zone
The difference between local time and UTC (GMT) in the form @var{Shhmm}:
sign, hours and minutes, e.g.@: @samp{-0500} (winter in New York);
@item Values
The year, month of the year, day of the month, time difference in
minutes from UTC, hour of the day, minutes of the hour, seconds
of the minute, and milliseconds
of the second in successive values of the array.
@end table
@cindex Y10K compliance
@cindex Year 10000 compliance
@cindex wraparound, Y10K
@cindex limits, Y10K
Programs making use of this intrinsic
might not be Year 10000 (Y10K) compliant.
For example, the date might appear,
to such programs, to wrap around
(change from a larger value to a smaller one)
as of the Year 10000.
On systems where a millisecond timer isn't available, the millisecond
value is returned as zero.
@end ifset
@ifset familyF2U
@node DbesJ0 Intrinsic
@subsubsection DbesJ0 Intrinsic
@cindex DbesJ0 intrinsic
@cindex intrinsics, DbesJ0
@noindent
@example
DbesJ0(@var{X})
@end example
@noindent
DbesJ0: @code{REAL(KIND=2)} function.
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Archaic form of @code{BESJ0()} that is specific
to one type for @var{X}.
@xref{BesJ0 Intrinsic}.
@node DbesJ1 Intrinsic
@subsubsection DbesJ1 Intrinsic
@cindex DbesJ1 intrinsic
@cindex intrinsics, DbesJ1
@noindent
@example
DbesJ1(@var{X})
@end example
@noindent
DbesJ1: @code{REAL(KIND=2)} function.
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Archaic form of @code{BESJ1()} that is specific
to one type for @var{X}.
@xref{BesJ1 Intrinsic}.
@node DbesJN Intrinsic
@subsubsection DbesJN Intrinsic
@cindex DbesJN intrinsic
@cindex intrinsics, DbesJN
@noindent
@example
DbesJN(@var{N}, @var{X})
@end example
@noindent
DbesJN: @code{REAL(KIND=2)} function.
@noindent
@var{N}: @code{INTEGER} not wider than the default kind; scalar; INTENT(IN).
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Archaic form of @code{BESJN()} that is specific
to one type for @var{X}.
@xref{BesJN Intrinsic}.
@node DbesY0 Intrinsic
@subsubsection DbesY0 Intrinsic
@cindex DbesY0 intrinsic
@cindex intrinsics, DbesY0
@noindent
@example
DbesY0(@var{X})
@end example
@noindent
DbesY0: @code{REAL(KIND=2)} function.
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Archaic form of @code{BESY0()} that is specific
to one type for @var{X}.
@xref{BesY0 Intrinsic}.
@node DbesY1 Intrinsic
@subsubsection DbesY1 Intrinsic
@cindex DbesY1 intrinsic
@cindex intrinsics, DbesY1
@noindent
@example
DbesY1(@var{X})
@end example
@noindent
DbesY1: @code{REAL(KIND=2)} function.
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Archaic form of @code{BESY1()} that is specific
to one type for @var{X}.
@xref{BesY1 Intrinsic}.
@node DbesYN Intrinsic
@subsubsection DbesYN Intrinsic
@cindex DbesYN intrinsic
@cindex intrinsics, DbesYN
@noindent
@example
DbesYN(@var{N}, @var{X})
@end example
@noindent
DbesYN: @code{REAL(KIND=2)} function.
@noindent
@var{N}: @code{INTEGER} not wider than the default kind; scalar; INTENT(IN).
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Archaic form of @code{BESYN()} that is specific
to one type for @var{X}.
@xref{BesYN Intrinsic}.
@end ifset
@ifset familyF77
@node Dble Intrinsic
@subsubsection Dble Intrinsic
@cindex Dble intrinsic
@cindex intrinsics, Dble
@noindent
@example
Dble(@var{A})
@end example
@noindent
Dble: @code{REAL(KIND=2)} function.
@noindent
@var{A}: @code{INTEGER}, @code{REAL}, or @code{COMPLEX}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns @var{A} converted to double precision
(@code{REAL(KIND=2)}).
If @var{A} is @code{COMPLEX}, the real part of
@var{A} is used for the conversion
and the imaginary part disregarded.
@xref{Sngl Intrinsic}, for the function that converts
to single precision.
@xref{Int Intrinsic}, for the function that converts
to @code{INTEGER}.
@xref{Complex Intrinsic}, for the function that converts
to @code{COMPLEX}.
@end ifset
@ifset familyVXT
@node DbleQ Intrinsic
@subsubsection DbleQ Intrinsic
@cindex DbleQ intrinsic
@cindex intrinsics, DbleQ
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL DbleQ} to use this name for an
external procedure.
@end ifset
@ifset familyFVZ
@node DCmplx Intrinsic
@subsubsection DCmplx Intrinsic
@cindex DCmplx intrinsic
@cindex intrinsics, DCmplx
@noindent
@example
DCmplx(@var{X}, @var{Y})
@end example
@noindent
DCmplx: @code{COMPLEX(KIND=2)} function.
@noindent
@var{X}: @code{INTEGER}, @code{REAL}, or @code{COMPLEX}; scalar; INTENT(IN).
@noindent
@var{Y}: @code{INTEGER} or @code{REAL}; OPTIONAL (must be omitted if @var{X} is @code{COMPLEX}); scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}, @code{vxt}.
@noindent
Description:
If @var{X} is not type @code{COMPLEX},
constructs a value of type @code{COMPLEX(KIND=2)} from the
real and imaginary values specified by @var{X} and
@var{Y}, respectively.
If @var{Y} is omitted, @samp{0D0} is assumed.
If @var{X} is type @code{COMPLEX},
converts it to type @code{COMPLEX(KIND=2)}.
Although this intrinsic is not standard Fortran,
it is a popular extension offered by many compilers
that support @code{DOUBLE COMPLEX}, since it offers
the easiest way to convert to @code{DOUBLE COMPLEX}
without using Fortran 90 features (such as the @samp{KIND=}
argument to the @code{CMPLX()} intrinsic).
(@samp{CMPLX(0D0, 0D0)} returns a single-precision
@code{COMPLEX} result, as required by standard FORTRAN 77.
That's why so many compilers provide @code{DCMPLX()}, since
@samp{DCMPLX(0D0, 0D0)} returns a @code{DOUBLE COMPLEX}
result.
Still, @code{DCMPLX()} converts even @code{REAL*16} arguments
to their @code{REAL*8} equivalents in most dialects of
Fortran, so neither it nor @code{CMPLX()} allow easy
construction of arbitrary-precision values without
potentially forcing a conversion involving extending or
reducing precision.
GNU Fortran provides such an intrinsic, called @code{COMPLEX()}.)
@xref{Complex Intrinsic}, for information on easily constructing
a @code{COMPLEX} value of arbitrary precision from @code{REAL}
arguments.
@node DConjg Intrinsic
@subsubsection DConjg Intrinsic
@cindex DConjg intrinsic
@cindex intrinsics, DConjg
@noindent
@example
DConjg(@var{Z})
@end example
@noindent
DConjg: @code{COMPLEX(KIND=2)} function.
@noindent
@var{Z}: @code{COMPLEX(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}, @code{vxt}.
@noindent
Description:
Archaic form of @code{CONJG()} that is specific
to one type for @var{Z}.
@xref{Conjg Intrinsic}.
@end ifset
@ifset familyF77
@node DCos Intrinsic
@subsubsection DCos Intrinsic
@cindex DCos intrinsic
@cindex intrinsics, DCos
@noindent
@example
DCos(@var{X})
@end example
@noindent
DCos: @code{REAL(KIND=2)} function.
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{COS()} that is specific
to one type for @var{X}.
@xref{Cos Intrinsic}.
@end ifset
@ifset familyVXT
@node DCosD Intrinsic
@subsubsection DCosD Intrinsic
@cindex DCosD intrinsic
@cindex intrinsics, DCosD
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL DCosD} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node DCosH Intrinsic
@subsubsection DCosH Intrinsic
@cindex DCosH intrinsic
@cindex intrinsics, DCosH
@noindent
@example
DCosH(@var{X})
@end example
@noindent
DCosH: @code{REAL(KIND=2)} function.
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{COSH()} that is specific
to one type for @var{X}.
@xref{CosH Intrinsic}.
@node DDiM Intrinsic
@subsubsection DDiM Intrinsic
@cindex DDiM intrinsic
@cindex intrinsics, DDiM
@noindent
@example
DDiM(@var{X}, @var{Y})
@end example
@noindent
DDiM: @code{REAL(KIND=2)} function.
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
@var{Y}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{DIM()} that is specific
to one type for @var{X} and @var{Y}.
@xref{DiM Intrinsic}.
@end ifset
@ifset familyF2U
@node DErF Intrinsic
@subsubsection DErF Intrinsic
@cindex DErF intrinsic
@cindex intrinsics, DErF
@noindent
@example
DErF(@var{X})
@end example
@noindent
DErF: @code{REAL(KIND=2)} function.
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Archaic form of @code{ERF()} that is specific
to one type for @var{X}.
@xref{ErF Intrinsic}.
@node DErFC Intrinsic
@subsubsection DErFC Intrinsic
@cindex DErFC intrinsic
@cindex intrinsics, DErFC
@noindent
@example
DErFC(@var{X})
@end example
@noindent
DErFC: @code{REAL(KIND=2)} function.
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Archaic form of @code{ERFC()} that is specific
to one type for @var{X}.
@xref{ErFC Intrinsic}.
@end ifset
@ifset familyF77
@node DExp Intrinsic
@subsubsection DExp Intrinsic
@cindex DExp intrinsic
@cindex intrinsics, DExp
@noindent
@example
DExp(@var{X})
@end example
@noindent
DExp: @code{REAL(KIND=2)} function.
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{EXP()} that is specific
to one type for @var{X}.
@xref{Exp Intrinsic}.
@end ifset
@ifset familyFVZ
@node DFloat Intrinsic
@subsubsection DFloat Intrinsic
@cindex DFloat intrinsic
@cindex intrinsics, DFloat
@noindent
@example
DFloat(@var{A})
@end example
@noindent
DFloat: @code{REAL(KIND=2)} function.
@noindent
@var{A}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}, @code{vxt}.
@noindent
Description:
Archaic form of @code{REAL()} that is specific
to one type for @var{A}.
@xref{Real Intrinsic}.
@end ifset
@ifset familyVXT
@node DFlotI Intrinsic
@subsubsection DFlotI Intrinsic
@cindex DFlotI intrinsic
@cindex intrinsics, DFlotI
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL DFlotI} to use this name for an
external procedure.
@node DFlotJ Intrinsic
@subsubsection DFlotJ Intrinsic
@cindex DFlotJ intrinsic
@cindex intrinsics, DFlotJ
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL DFlotJ} to use this name for an
external procedure.
@end ifset
@ifset familyF90
@node Digits Intrinsic
@subsubsection Digits Intrinsic
@cindex Digits intrinsic
@cindex intrinsics, Digits
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Digits} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node DiM Intrinsic
@subsubsection DiM Intrinsic
@cindex DiM intrinsic
@cindex intrinsics, DiM
@noindent
@example
DiM(@var{X}, @var{Y})
@end example
@noindent
DiM: @code{INTEGER} or @code{REAL} function, the exact type being the result of cross-promoting the
types of all the arguments.
@noindent
@var{X}: @code{INTEGER} or @code{REAL}; scalar; INTENT(IN).
@noindent
@var{Y}: @code{INTEGER} or @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns @samp{@var{X}-@var{Y}} if @var{X} is greater than
@var{Y}; otherwise returns zero.
@end ifset
@ifset familyFVZ
@node DImag Intrinsic
@subsubsection DImag Intrinsic
@cindex DImag intrinsic
@cindex intrinsics, DImag
@noindent
@example
DImag(@var{Z})
@end example
@noindent
DImag: @code{REAL(KIND=2)} function.
@noindent
@var{Z}: @code{COMPLEX(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}, @code{vxt}.
@noindent
Description:
Archaic form of @code{AIMAG()} that is specific
to one type for @var{Z}.
@xref{AImag Intrinsic}.
@end ifset
@ifset familyF77
@node DInt Intrinsic
@subsubsection DInt Intrinsic
@cindex DInt intrinsic
@cindex intrinsics, DInt
@noindent
@example
DInt(@var{A})
@end example
@noindent
DInt: @code{REAL(KIND=2)} function.
@noindent
@var{A}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{AINT()} that is specific
to one type for @var{A}.
@xref{AInt Intrinsic}.
@node DLog Intrinsic
@subsubsection DLog Intrinsic
@cindex DLog intrinsic
@cindex intrinsics, DLog
@noindent
@example
DLog(@var{X})
@end example
@noindent
DLog: @code{REAL(KIND=2)} function.
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{LOG()} that is specific
to one type for @var{X}.
@xref{Log Intrinsic}.
@node DLog10 Intrinsic
@subsubsection DLog10 Intrinsic
@cindex DLog10 intrinsic
@cindex intrinsics, DLog10
@noindent
@example
DLog10(@var{X})
@end example
@noindent
DLog10: @code{REAL(KIND=2)} function.
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{LOG10()} that is specific
to one type for @var{X}.
@xref{Log10 Intrinsic}.
@node DMax1 Intrinsic
@subsubsection DMax1 Intrinsic
@cindex DMax1 intrinsic
@cindex intrinsics, DMax1
@noindent
@example
DMax1(@var{A}-1, @var{A}-2, @dots{}, @var{A}-n)
@end example
@noindent
DMax1: @code{REAL(KIND=2)} function.
@noindent
@var{A}: @code{REAL(KIND=2)}; at least two such arguments must be provided; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{MAX()} that is specific
to one type for @var{A}.
@xref{Max Intrinsic}.
@node DMin1 Intrinsic
@subsubsection DMin1 Intrinsic
@cindex DMin1 intrinsic
@cindex intrinsics, DMin1
@noindent
@example
DMin1(@var{A}-1, @var{A}-2, @dots{}, @var{A}-n)
@end example
@noindent
DMin1: @code{REAL(KIND=2)} function.
@noindent
@var{A}: @code{REAL(KIND=2)}; at least two such arguments must be provided; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{MIN()} that is specific
to one type for @var{A}.
@xref{Min Intrinsic}.
@node DMod Intrinsic
@subsubsection DMod Intrinsic
@cindex DMod intrinsic
@cindex intrinsics, DMod
@noindent
@example
DMod(@var{A}, @var{P})
@end example
@noindent
DMod: @code{REAL(KIND=2)} function.
@noindent
@var{A}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
@var{P}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{MOD()} that is specific
to one type for @var{A}.
@xref{Mod Intrinsic}.
@node DNInt Intrinsic
@subsubsection DNInt Intrinsic
@cindex DNInt intrinsic
@cindex intrinsics, DNInt
@noindent
@example
DNInt(@var{A})
@end example
@noindent
DNInt: @code{REAL(KIND=2)} function.
@noindent
@var{A}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{ANINT()} that is specific
to one type for @var{A}.
@xref{ANInt Intrinsic}.
@end ifset
@ifset familyF90
@node Dot_Product Intrinsic
@subsubsection Dot_Product Intrinsic
@cindex Dot_Product intrinsic
@cindex intrinsics, Dot_Product
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Dot_Product} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node DProd Intrinsic
@subsubsection DProd Intrinsic
@cindex DProd intrinsic
@cindex intrinsics, DProd
@noindent
@example
DProd(@var{X}, @var{Y})
@end example
@noindent
DProd: @code{REAL(KIND=2)} function.
@noindent
@var{X}: @code{REAL(KIND=1)}; scalar; INTENT(IN).
@noindent
@var{Y}: @code{REAL(KIND=1)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns @samp{DBLE(@var{X})*DBLE(@var{Y})}.
@end ifset
@ifset familyVXT
@node DReal Intrinsic
@subsubsection DReal Intrinsic
@cindex DReal intrinsic
@cindex intrinsics, DReal
@noindent
@example
DReal(@var{A})
@end example
@noindent
DReal: @code{REAL(KIND=2)} function.
@noindent
@var{A}: @code{INTEGER}, @code{REAL}, or @code{COMPLEX}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{vxt}.
@noindent
Description:
Converts @var{A} to @code{REAL(KIND=2)}.
If @var{A} is type @code{COMPLEX}, its real part
is converted (if necessary) to @code{REAL(KIND=2)},
and its imaginary part is disregarded.
Although this intrinsic is not standard Fortran,
it is a popular extension offered by many compilers
that support @code{DOUBLE COMPLEX}, since it offers
the easiest way to extract the real part of a @code{DOUBLE COMPLEX}
value without using the Fortran 90 @code{REAL()} intrinsic
in a way that produces a return value inconsistent with
the way many FORTRAN 77 compilers handle @code{REAL()} of
a @code{DOUBLE COMPLEX} value.
@xref{RealPart Intrinsic}, for information on a GNU Fortran
intrinsic that avoids these areas of confusion.
@xref{Dble Intrinsic}, for information on the standard FORTRAN 77
replacement for @code{DREAL()}.
@xref{REAL() and AIMAG() of Complex}, for more information on
this issue.
@end ifset
@ifset familyF77
@node DSign Intrinsic
@subsubsection DSign Intrinsic
@cindex DSign intrinsic
@cindex intrinsics, DSign
@noindent
@example
DSign(@var{A}, @var{B})
@end example
@noindent
DSign: @code{REAL(KIND=2)} function.
@noindent
@var{A}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
@var{B}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{SIGN()} that is specific
to one type for @var{A} and @var{B}.
@xref{Sign Intrinsic}.
@node DSin Intrinsic
@subsubsection DSin Intrinsic
@cindex DSin intrinsic
@cindex intrinsics, DSin
@noindent
@example
DSin(@var{X})
@end example
@noindent
DSin: @code{REAL(KIND=2)} function.
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{SIN()} that is specific
to one type for @var{X}.
@xref{Sin Intrinsic}.
@end ifset
@ifset familyVXT
@node DSinD Intrinsic
@subsubsection DSinD Intrinsic
@cindex DSinD intrinsic
@cindex intrinsics, DSinD
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL DSinD} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node DSinH Intrinsic
@subsubsection DSinH Intrinsic
@cindex DSinH intrinsic
@cindex intrinsics, DSinH
@noindent
@example
DSinH(@var{X})
@end example
@noindent
DSinH: @code{REAL(KIND=2)} function.
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{SINH()} that is specific
to one type for @var{X}.
@xref{SinH Intrinsic}.
@node DSqRt Intrinsic
@subsubsection DSqRt Intrinsic
@cindex DSqRt intrinsic
@cindex intrinsics, DSqRt
@noindent
@example
DSqRt(@var{X})
@end example
@noindent
DSqRt: @code{REAL(KIND=2)} function.
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{SQRT()} that is specific
to one type for @var{X}.
@xref{SqRt Intrinsic}.
@node DTan Intrinsic
@subsubsection DTan Intrinsic
@cindex DTan intrinsic
@cindex intrinsics, DTan
@noindent
@example
DTan(@var{X})
@end example
@noindent
DTan: @code{REAL(KIND=2)} function.
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{TAN()} that is specific
to one type for @var{X}.
@xref{Tan Intrinsic}.
@end ifset
@ifset familyVXT
@node DTanD Intrinsic
@subsubsection DTanD Intrinsic
@cindex DTanD intrinsic
@cindex intrinsics, DTanD
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL DTanD} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node DTanH Intrinsic
@subsubsection DTanH Intrinsic
@cindex DTanH intrinsic
@cindex intrinsics, DTanH
@noindent
@example
DTanH(@var{X})
@end example
@noindent
DTanH: @code{REAL(KIND=2)} function.
@noindent
@var{X}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{TANH()} that is specific
to one type for @var{X}.
@xref{TanH Intrinsic}.
@end ifset
@ifset familyF2U
@node DTime Intrinsic (subroutine)
@subsubsection DTime Intrinsic (subroutine)
@cindex DTime intrinsic
@cindex intrinsics, DTime
@noindent
@example
CALL DTime(@var{TArray}, @var{Result})
@end example
@noindent
@var{TArray}: @code{REAL(KIND=1)}; DIMENSION(2); INTENT(OUT).
@noindent
@var{Result}: @code{REAL(KIND=1)}; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Initially, return the number of seconds of runtime
since the start of the process's execution
in @var{Result},
and the user and system components of this in @samp{@var{TArray}(1)}
and @samp{@var{TArray}(2)} respectively.
The value of @var{Result} is equal to @samp{@var{TArray}(1) + @var{TArray}(2)}.
Subsequent invocations of @samp{DTIME()} set values based on accumulations
since the previous invocation.
@cindex wraparound, timings
@cindex limits, timings
On some systems, the underlying timings are represented
using types with sufficiently small limits that overflows
(wraparounds) are possible, such as 32-bit types.
Therefore, the values returned by this intrinsic
might be, or become, negative,
or numerically less than previous values,
during a single run of the compiled program.
Some non-GNU implementations of Fortran provide this intrinsic as
only a function, not as a subroutine.
For information on other intrinsics with the same name:
@xref{DTime Intrinsic (function)}.
@end ifset
@ifset familyBADU77
@node DTime Intrinsic (function)
@subsubsection DTime Intrinsic (function)
@cindex DTime intrinsic
@cindex intrinsics, DTime
@noindent
@example
DTime(@var{TArray})
@end example
@noindent
DTime: @code{REAL(KIND=1)} function.
@noindent
@var{TArray}: @code{REAL(KIND=1)}; DIMENSION(2); INTENT(OUT).
@noindent
Intrinsic groups: @code{badu77}.
@noindent
Description:
Initially, return the number of seconds of runtime
since the start of the process's execution
as the function value,
and the user and system components of this in @samp{@var{TArray}(1)}
and @samp{@var{TArray}(2)} respectively.
The functions' value is equal to @samp{@var{TArray}(1) + @var{TArray}(2)}.
Subsequent invocations of @samp{DTIME()} return values accumulated since the
previous invocation.
@cindex wraparound, timings
@cindex limits, timings
On some systems, the underlying timings are represented
using types with sufficiently small limits that overflows
(wraparounds) are possible, such as 32-bit types.
Therefore, the values returned by this intrinsic
might be, or become, negative,
or numerically less than previous values,
during a single run of the compiled program.
Due to the side effects performed by this intrinsic, the function
form is not recommended.
For information on other intrinsics with the same name:
@xref{DTime Intrinsic (subroutine)}.
@end ifset
@ifset familyF90
@node EOShift Intrinsic
@subsubsection EOShift Intrinsic
@cindex EOShift intrinsic
@cindex intrinsics, EOShift
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL EOShift} to use this name for an
external procedure.
@node Epsilon Intrinsic
@subsubsection Epsilon Intrinsic
@cindex Epsilon intrinsic
@cindex intrinsics, Epsilon
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Epsilon} to use this name for an
external procedure.
@end ifset
@ifset familyF2U
@node ErF Intrinsic
@subsubsection ErF Intrinsic
@cindex ErF intrinsic
@cindex intrinsics, ErF
@noindent
@example
ErF(@var{X})
@end example
@noindent
ErF: @code{REAL} function, the @samp{KIND=} value of the type being that of argument @var{X}.
@noindent
@var{X}: @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns the error function of @var{X}.
See @code{erf(3m)}, which provides the implementation.
@node ErFC Intrinsic
@subsubsection ErFC Intrinsic
@cindex ErFC intrinsic
@cindex intrinsics, ErFC
@noindent
@example
ErFC(@var{X})
@end example
@noindent
ErFC: @code{REAL} function, the @samp{KIND=} value of the type being that of argument @var{X}.
@noindent
@var{X}: @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns the complementary error function of @var{X}:
@samp{ERFC(R) = 1 - ERF(R)} (except that the result might be more
accurate than explicitly evaluating that formulae would give).
See @code{erfc(3m)}, which provides the implementation.
@node ETime Intrinsic (subroutine)
@subsubsection ETime Intrinsic (subroutine)
@cindex ETime intrinsic
@cindex intrinsics, ETime
@noindent
@example
CALL ETime(@var{TArray}, @var{Result})
@end example
@noindent
@var{TArray}: @code{REAL(KIND=1)}; DIMENSION(2); INTENT(OUT).
@noindent
@var{Result}: @code{REAL(KIND=1)}; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Return the number of seconds of runtime
since the start of the process's execution
in @var{Result},
and the user and system components of this in @samp{@var{TArray}(1)}
and @samp{@var{TArray}(2)} respectively.
The value of @var{Result} is equal to @samp{@var{TArray}(1) + @var{TArray}(2)}.
@cindex wraparound, timings
@cindex limits, timings
On some systems, the underlying timings are represented
using types with sufficiently small limits that overflows
(wraparounds) are possible, such as 32-bit types.
Therefore, the values returned by this intrinsic
might be, or become, negative,
or numerically less than previous values,
during a single run of the compiled program.
Some non-GNU implementations of Fortran provide this intrinsic as
only a function, not as a subroutine.
For information on other intrinsics with the same name:
@xref{ETime Intrinsic (function)}.
@node ETime Intrinsic (function)
@subsubsection ETime Intrinsic (function)
@cindex ETime intrinsic
@cindex intrinsics, ETime
@noindent
@example
ETime(@var{TArray})
@end example
@noindent
ETime: @code{REAL(KIND=1)} function.
@noindent
@var{TArray}: @code{REAL(KIND=1)}; DIMENSION(2); INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Return the number of seconds of runtime
since the start of the process's execution
as the function value,
and the user and system components of this in @samp{@var{TArray}(1)}
and @samp{@var{TArray}(2)} respectively.
The functions' value is equal to @samp{@var{TArray}(1) + @var{TArray}(2)}.
@cindex wraparound, timings
@cindex limits, timings
On some systems, the underlying timings are represented
using types with sufficiently small limits that overflows
(wraparounds) are possible, such as 32-bit types.
Therefore, the values returned by this intrinsic
might be, or become, negative,
or numerically less than previous values,
during a single run of the compiled program.
For information on other intrinsics with the same name:
@xref{ETime Intrinsic (subroutine)}.
@node Exit Intrinsic
@subsubsection Exit Intrinsic
@cindex Exit intrinsic
@cindex intrinsics, Exit
@noindent
@example
CALL Exit(@var{Status})
@end example
@noindent
@var{Status}: @code{INTEGER} not wider than the default kind; OPTIONAL; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Exit the program with status @var{Status} after closing open Fortran
I/O units and otherwise behaving as @code{exit(2)}.
If @var{Status} is omitted the canonical `success' value
will be returned to the system.
@end ifset
@ifset familyF77
@node Exp Intrinsic
@subsubsection Exp Intrinsic
@cindex Exp intrinsic
@cindex intrinsics, Exp
@noindent
@example
Exp(@var{X})
@end example
@noindent
Exp: @code{REAL} or @code{COMPLEX} function, the exact type being that of argument @var{X}.
@noindent
@var{X}: @code{REAL} or @code{COMPLEX}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns @samp{@var{e}**@var{X}}, where
@var{e} is approximately 2.7182818.
@xref{Log Intrinsic}, for the inverse of this function.
@end ifset
@ifset familyF90
@node Exponent Intrinsic
@subsubsection Exponent Intrinsic
@cindex Exponent intrinsic
@cindex intrinsics, Exponent
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Exponent} to use this name for an
external procedure.
@end ifset
@ifset familyF2U
@node FDate Intrinsic (subroutine)
@subsubsection FDate Intrinsic (subroutine)
@cindex FDate intrinsic
@cindex intrinsics, FDate
@noindent
@example
CALL FDate(@var{Date})
@end example
@noindent
@var{Date}: @code{CHARACTER}; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns the current date (using the same format as @code{CTIME()})
in @var{Date}.
Equivalent to:
@example
CALL CTIME(@var{Date}, TIME8())
@end example
@cindex Y10K compliance
@cindex Year 10000 compliance
@cindex wraparound, Y10K
@cindex limits, Y10K
Programs making use of this intrinsic
might not be Year 10000 (Y10K) compliant.
For example, the date might appear,
to such programs, to wrap around
(change from a larger value to a smaller one)
as of the Year 10000.
@xref{CTime Intrinsic (subroutine)}.
Some non-GNU implementations of Fortran provide this intrinsic as
only a function, not as a subroutine.
For information on other intrinsics with the same name:
@xref{FDate Intrinsic (function)}.
@node FDate Intrinsic (function)
@subsubsection FDate Intrinsic (function)
@cindex FDate intrinsic
@cindex intrinsics, FDate
@noindent
@example
FDate()
@end example
@noindent
FDate: @code{CHARACTER*(*)} function.
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns the current date (using the same format as @code{CTIME()}).
Equivalent to:
@example
CTIME(TIME8())
@end example
@cindex Y10K compliance
@cindex Year 10000 compliance
@cindex wraparound, Y10K
@cindex limits, Y10K
Programs making use of this intrinsic
might not be Year 10000 (Y10K) compliant.
For example, the date might appear,
to such programs, to wrap around
(change from a larger value to a smaller one)
as of the Year 10000.
@xref{CTime Intrinsic (function)}.
For information on other intrinsics with the same name:
@xref{FDate Intrinsic (subroutine)}.
@node FGet Intrinsic (subroutine)
@subsubsection FGet Intrinsic (subroutine)
@cindex FGet intrinsic
@cindex intrinsics, FGet
@noindent
@example
CALL FGet(@var{C}, @var{Status})
@end example
@noindent
@var{C}: @code{CHARACTER}; scalar; INTENT(OUT).
@noindent
@var{Status}: @code{INTEGER(KIND=1)}; OPTIONAL; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Reads a single character into @var{C} in stream mode from unit 5
(by-passing normal formatted output) using @code{getc(3)}.
Returns in
@var{Status} 0 on success, @minus{}1 on end-of-file, and the error code
from @code{ferror(3)} otherwise.
Stream I/O should not be mixed with normal record-oriented (formatted or
unformatted) I/O on the same unit; the results are unpredictable.
For information on other intrinsics with the same name:
@xref{FGet Intrinsic (function)}.
@end ifset
@ifset familyBADU77
@node FGet Intrinsic (function)
@subsubsection FGet Intrinsic (function)
@cindex FGet intrinsic
@cindex intrinsics, FGet
@noindent
@example
FGet(@var{C})
@end example
@noindent
FGet: @code{INTEGER(KIND=1)} function.
@noindent
@var{C}: @code{CHARACTER}; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{badu77}.
@noindent
Description:
Reads a single character into @var{C} in stream mode from unit 5
(by-passing normal formatted input) using @code{getc(3)}.
Returns 0 on
success, @minus{}1 on end-of-file, and the error code from
@code{ferror(3)} otherwise.
Stream I/O should not be mixed with normal record-oriented (formatted or
unformatted) I/O on the same unit; the results are unpredictable.
For information on other intrinsics with the same name:
@xref{FGet Intrinsic (subroutine)}.
@end ifset
@ifset familyF2U
@node FGetC Intrinsic (subroutine)
@subsubsection FGetC Intrinsic (subroutine)
@cindex FGetC intrinsic
@cindex intrinsics, FGetC
@noindent
@example
CALL FGetC(@var{Unit}, @var{C}, @var{Status})
@end example
@noindent
@var{Unit}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{C}: @code{CHARACTER}; scalar; INTENT(OUT).
@noindent
@var{Status}: @code{INTEGER(KIND=1)}; OPTIONAL; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Reads a single character into @var{C} in stream mode from unit @var{Unit}
(by-passing normal formatted output) using @code{getc(3)}.
Returns in
@var{Status} 0 on success, @minus{}1 on end-of-file, and the error code from
@code{ferror(3)} otherwise.
Stream I/O should not be mixed with normal record-oriented (formatted or
unformatted) I/O on the same unit; the results are unpredictable.
For information on other intrinsics with the same name:
@xref{FGetC Intrinsic (function)}.
@end ifset
@ifset familyBADU77
@node FGetC Intrinsic (function)
@subsubsection FGetC Intrinsic (function)
@cindex FGetC intrinsic
@cindex intrinsics, FGetC
@noindent
@example
FGetC(@var{Unit}, @var{C})
@end example
@noindent
FGetC: @code{INTEGER(KIND=1)} function.
@noindent
@var{Unit}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{C}: @code{CHARACTER}; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{badu77}.
@noindent
Description:
Reads a single character into @var{C} in stream mode from unit @var{Unit}
(by-passing normal formatted output) using @code{getc(3)}.
Returns 0 on
success, @minus{}1 on end-of-file, and the error code from
@code{ferror(3)} otherwise.
Stream I/O should not be mixed with normal record-oriented (formatted or
unformatted) I/O on the same unit; the results are unpredictable.
For information on other intrinsics with the same name:
@xref{FGetC Intrinsic (subroutine)}.
@end ifset
@ifset familyF77
@node Float Intrinsic
@subsubsection Float Intrinsic
@cindex Float intrinsic
@cindex intrinsics, Float
@noindent
@example
Float(@var{A})
@end example
@noindent
Float: @code{REAL(KIND=1)} function.
@noindent
@var{A}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{REAL()} that is specific
to one type for @var{A}.
@xref{Real Intrinsic}.
@end ifset
@ifset familyVXT
@node FloatI Intrinsic
@subsubsection FloatI Intrinsic
@cindex FloatI intrinsic
@cindex intrinsics, FloatI
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL FloatI} to use this name for an
external procedure.
@node FloatJ Intrinsic
@subsubsection FloatJ Intrinsic
@cindex FloatJ intrinsic
@cindex intrinsics, FloatJ
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL FloatJ} to use this name for an
external procedure.
@end ifset
@ifset familyF90
@node Floor Intrinsic
@subsubsection Floor Intrinsic
@cindex Floor intrinsic
@cindex intrinsics, Floor
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Floor} to use this name for an
external procedure.
@end ifset
@ifset familyF2U
@node Flush Intrinsic
@subsubsection Flush Intrinsic
@cindex Flush intrinsic
@cindex intrinsics, Flush
@noindent
@example
CALL Flush(@var{Unit})
@end example
@noindent
@var{Unit}: @code{INTEGER}; OPTIONAL; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Flushes Fortran unit(s) currently open for output.
Without the optional argument, all such units are flushed,
otherwise just the unit specified by @var{Unit}.
Some non-GNU implementations of Fortran provide this intrinsic
as a library procedure that might or might not support the
(optional) @var{Unit} argument.
@node FNum Intrinsic
@subsubsection FNum Intrinsic
@cindex FNum intrinsic
@cindex intrinsics, FNum
@noindent
@example
FNum(@var{Unit})
@end example
@noindent
FNum: @code{INTEGER(KIND=1)} function.
@noindent
@var{Unit}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns the Unix file descriptor number corresponding to the open
Fortran I/O unit @var{Unit}.
This could be passed to an interface to C I/O routines.
@node FPut Intrinsic (subroutine)
@subsubsection FPut Intrinsic (subroutine)
@cindex FPut intrinsic
@cindex intrinsics, FPut
@noindent
@example
CALL FPut(@var{C}, @var{Status})
@end example
@noindent
@var{C}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{Status}: @code{INTEGER(KIND=1)}; OPTIONAL; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Writes the single character @var{C} in stream mode to unit 6
(by-passing normal formatted output) using @code{putc(3)}.
Returns in
@var{Status} 0 on success, the error code from @code{ferror(3)} otherwise.
Stream I/O should not be mixed with normal record-oriented (formatted or
unformatted) I/O on the same unit; the results are unpredictable.
For information on other intrinsics with the same name:
@xref{FPut Intrinsic (function)}.
@end ifset
@ifset familyBADU77
@node FPut Intrinsic (function)
@subsubsection FPut Intrinsic (function)
@cindex FPut intrinsic
@cindex intrinsics, FPut
@noindent
@example
FPut(@var{C})
@end example
@noindent
FPut: @code{INTEGER(KIND=1)} function.
@noindent
@var{C}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{badu77}.
@noindent
Description:
Writes the single character @var{C} in stream mode to unit 6
(by-passing normal formatted output) using @code{getc(3)}.
Returns 0 on
success, the error code from @code{ferror(3)} otherwise.
Stream I/O should not be mixed with normal record-oriented (formatted or
unformatted) I/O on the same unit; the results are unpredictable.
For information on other intrinsics with the same name:
@xref{FPut Intrinsic (subroutine)}.
@end ifset
@ifset familyF2U
@node FPutC Intrinsic (subroutine)
@subsubsection FPutC Intrinsic (subroutine)
@cindex FPutC intrinsic
@cindex intrinsics, FPutC
@noindent
@example
CALL FPutC(@var{Unit}, @var{C}, @var{Status})
@end example
@noindent
@var{Unit}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{C}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{Status}: @code{INTEGER(KIND=1)}; OPTIONAL; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Writes the single character @var{Unit} in stream mode to unit 6
(by-passing normal formatted output) using @code{putc(3)}.
Returns in
@var{C} 0 on success, the error code from @code{ferror(3)} otherwise.
Stream I/O should not be mixed with normal record-oriented (formatted or
unformatted) I/O on the same unit; the results are unpredictable.
For information on other intrinsics with the same name:
@xref{FPutC Intrinsic (function)}.
@end ifset
@ifset familyBADU77
@node FPutC Intrinsic (function)
@subsubsection FPutC Intrinsic (function)
@cindex FPutC intrinsic
@cindex intrinsics, FPutC
@noindent
@example
FPutC(@var{Unit}, @var{C})
@end example
@noindent
FPutC: @code{INTEGER(KIND=1)} function.
@noindent
@var{Unit}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{C}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{badu77}.
@noindent
Description:
Writes the single character @var{C} in stream mode to unit @var{Unit}
(by-passing normal formatted output) using @code{putc(3)}.
Returns 0 on
success, the error code from @code{ferror(3)} otherwise.
Stream I/O should not be mixed with normal record-oriented (formatted or
unformatted) I/O on the same unit; the results are unpredictable.
For information on other intrinsics with the same name:
@xref{FPutC Intrinsic (subroutine)}.
@end ifset
@ifset familyF90
@node Fraction Intrinsic
@subsubsection Fraction Intrinsic
@cindex Fraction intrinsic
@cindex intrinsics, Fraction
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Fraction} to use this name for an
external procedure.
@end ifset
@ifset familyF2U
@node FSeek Intrinsic
@subsubsection FSeek Intrinsic
@cindex FSeek intrinsic
@cindex intrinsics, FSeek
@noindent
@example
CALL FSeek(@var{Unit}, @var{Offset}, @var{Whence}, @var{ErrLab})
@end example
@noindent
@var{Unit}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Offset}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Whence}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{ErrLab}: @samp{*@var{label}}, where @var{label} is the label
of an executable statement; OPTIONAL.
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Attempts to move Fortran unit @var{Unit} to the specified
@var{Offset}: absolute offset if @var{Whence}=0; relative to the
current offset if @var{Whence}=1; relative to the end of the file if
@var{Whence}=2.
It branches to label @var{ErrLab} if @var{Unit} is
not open or if the call otherwise fails.
@node FStat Intrinsic (subroutine)
@subsubsection FStat Intrinsic (subroutine)
@cindex FStat intrinsic
@cindex intrinsics, FStat
@noindent
@example
CALL FStat(@var{Unit}, @var{SArray}, @var{Status})
@end example
@noindent
@var{Unit}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{SArray}: @code{INTEGER(KIND=1)}; DIMENSION(13); INTENT(OUT).
@noindent
@var{Status}: @code{INTEGER(KIND=1)}; OPTIONAL; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Obtains data about the file open on Fortran I/O unit @var{Unit} and
places them in the array @var{SArray}.
The values in this array are
extracted from the @code{stat} structure as returned by
@code{fstat(2)} q.v., as follows:
@enumerate
@item
Device ID
@item
Inode number
@item
File mode
@item
Number of links
@item
Owner's uid
@item
Owner's gid
@item
ID of device containing directory entry for file
(0 if not available)
@item
File size (bytes)
@item
Last access time
@item
Last modification time
@item
Last file status change time
@item
Preferred I/O block size (-1 if not available)
@item
Number of blocks allocated (-1 if not available)
@end enumerate
Not all these elements are relevant on all systems.
If an element is not relevant, it is returned as 0.
If the @var{Status} argument is supplied, it contains
0 on success or a nonzero error code upon return.
Some non-GNU implementations of Fortran provide this intrinsic as
only a function, not as a subroutine, or do not support the
(optional) @var{Status} argument.
For information on other intrinsics with the same name:
@xref{FStat Intrinsic (function)}.
@node FStat Intrinsic (function)
@subsubsection FStat Intrinsic (function)
@cindex FStat intrinsic
@cindex intrinsics, FStat
@noindent
@example
FStat(@var{Unit}, @var{SArray})
@end example
@noindent
FStat: @code{INTEGER(KIND=1)} function.
@noindent
@var{Unit}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{SArray}: @code{INTEGER(KIND=1)}; DIMENSION(13); INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Obtains data about the file open on Fortran I/O unit @var{Unit} and
places them in the array @var{SArray}.
The values in this array are
extracted from the @code{stat} structure as returned by
@code{fstat(2)} q.v., as follows:
@enumerate
@item
Device ID
@item
Inode number
@item
File mode
@item
Number of links
@item
Owner's uid
@item
Owner's gid
@item
ID of device containing directory entry for file
(0 if not available)
@item
File size (bytes)
@item
Last access time
@item
Last modification time
@item
Last file status change time
@item
Preferred I/O block size (-1 if not available)
@item
Number of blocks allocated (-1 if not available)
@end enumerate
Not all these elements are relevant on all systems.
If an element is not relevant, it is returned as 0.
Returns 0 on success or a nonzero error code.
For information on other intrinsics with the same name:
@xref{FStat Intrinsic (subroutine)}.
@node FTell Intrinsic (subroutine)
@subsubsection FTell Intrinsic (subroutine)
@cindex FTell intrinsic
@cindex intrinsics, FTell
@noindent
@example
CALL FTell(@var{Unit}, @var{Offset})
@end example
@noindent
@var{Unit}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Offset}: @code{INTEGER(KIND=1)}; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Sets @var{Offset} to the current offset of Fortran unit @var{Unit}
(or to @minus{}1 if @var{Unit} is not open).
Some non-GNU implementations of Fortran provide this intrinsic as
only a function, not as a subroutine.
For information on other intrinsics with the same name:
@xref{FTell Intrinsic (function)}.
@node FTell Intrinsic (function)
@subsubsection FTell Intrinsic (function)
@cindex FTell intrinsic
@cindex intrinsics, FTell
@noindent
@example
FTell(@var{Unit})
@end example
@noindent
FTell: @code{INTEGER(KIND=1)} function.
@noindent
@var{Unit}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns the current offset of Fortran unit @var{Unit}
(or @minus{}1 if @var{Unit} is not open).
For information on other intrinsics with the same name:
@xref{FTell Intrinsic (subroutine)}.
@node GError Intrinsic
@subsubsection GError Intrinsic
@cindex GError intrinsic
@cindex intrinsics, GError
@noindent
@example
CALL GError(@var{Message})
@end example
@noindent
@var{Message}: @code{CHARACTER}; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns the system error message corresponding to the last system
error (C @code{errno}).
@node GetArg Intrinsic
@subsubsection GetArg Intrinsic
@cindex GetArg intrinsic
@cindex intrinsics, GetArg
@noindent
@example
CALL GetArg(@var{Pos}, @var{Value})
@end example
@noindent
@var{Pos}: @code{INTEGER} not wider than the default kind; scalar; INTENT(IN).
@noindent
@var{Value}: @code{CHARACTER}; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Sets @var{Value} to the @var{Pos}-th command-line argument (or to all
blanks if there are fewer than @var{Value} command-line arguments);
@code{CALL GETARG(0, @var{value})} sets @var{value} to the name of the
program (on systems that support this feature).
@xref{IArgC Intrinsic}, for information on how to get the number
of arguments.
@node GetCWD Intrinsic (subroutine)
@subsubsection GetCWD Intrinsic (subroutine)
@cindex GetCWD intrinsic
@cindex intrinsics, GetCWD
@noindent
@example
CALL GetCWD(@var{Name}, @var{Status})
@end example
@noindent
@var{Name}: @code{CHARACTER}; scalar; INTENT(OUT).
@noindent
@var{Status}: @code{INTEGER(KIND=1)}; OPTIONAL; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Places the current working directory in @var{Name}.
If the @var{Status} argument is supplied, it contains 0
success or a nonzero error code upon return
(@code{ENOSYS} if the system does not provide @code{getcwd(3)}
or @code{getwd(3)}).
Some non-GNU implementations of Fortran provide this intrinsic as
only a function, not as a subroutine, or do not support the
(optional) @var{Status} argument.
For information on other intrinsics with the same name:
@xref{GetCWD Intrinsic (function)}.
@node GetCWD Intrinsic (function)
@subsubsection GetCWD Intrinsic (function)
@cindex GetCWD intrinsic
@cindex intrinsics, GetCWD
@noindent
@example
GetCWD(@var{Name})
@end example
@noindent
GetCWD: @code{INTEGER(KIND=1)} function.
@noindent
@var{Name}: @code{CHARACTER}; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Places the current working directory in @var{Name}.
Returns 0 on
success, otherwise a nonzero error code
(@code{ENOSYS} if the system does not provide @code{getcwd(3)}
or @code{getwd(3)}).
For information on other intrinsics with the same name:
@xref{GetCWD Intrinsic (subroutine)}.
@node GetEnv Intrinsic
@subsubsection GetEnv Intrinsic
@cindex GetEnv intrinsic
@cindex intrinsics, GetEnv
@noindent
@example
CALL GetEnv(@var{Name}, @var{Value})
@end example
@noindent
@var{Name}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{Value}: @code{CHARACTER}; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Sets @var{Value} to the value of environment variable given by the
value of @var{Name} (@code{$name} in shell terms) or to blanks if
@code{$name} has not been set.
A null character (@samp{CHAR(0)}) marks the end of
the name in @var{Name}---otherwise,
trailing blanks in @var{Name} are ignored.
@node GetGId Intrinsic
@subsubsection GetGId Intrinsic
@cindex GetGId intrinsic
@cindex intrinsics, GetGId
@noindent
@example
GetGId()
@end example
@noindent
GetGId: @code{INTEGER(KIND=1)} function.
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns the group id for the current process.
@node GetLog Intrinsic
@subsubsection GetLog Intrinsic
@cindex GetLog intrinsic
@cindex intrinsics, GetLog
@noindent
@example
CALL GetLog(@var{Login})
@end example
@noindent
@var{Login}: @code{CHARACTER}; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns the login name for the process in @var{Login}.
@emph{Caution:} On some systems, the @code{getlogin(3)}
function, which this intrinsic calls at run time,
is either not implemented or returns a null pointer.
In the latter case, this intrinsic returns blanks
in @var{Login}.
@node GetPId Intrinsic
@subsubsection GetPId Intrinsic
@cindex GetPId intrinsic
@cindex intrinsics, GetPId
@noindent
@example
GetPId()
@end example
@noindent
GetPId: @code{INTEGER(KIND=1)} function.
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns the process id for the current process.
@node GetUId Intrinsic
@subsubsection GetUId Intrinsic
@cindex GetUId intrinsic
@cindex intrinsics, GetUId
@noindent
@example
GetUId()
@end example
@noindent
GetUId: @code{INTEGER(KIND=1)} function.
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns the user id for the current process.
@node GMTime Intrinsic
@subsubsection GMTime Intrinsic
@cindex GMTime intrinsic
@cindex intrinsics, GMTime
@noindent
@example
CALL GMTime(@var{STime}, @var{TArray})
@end example
@noindent
@var{STime}: @code{INTEGER(KIND=1)}; scalar; INTENT(IN).
@noindent
@var{TArray}: @code{INTEGER(KIND=1)}; DIMENSION(9); INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Given a system time value @var{STime}, fills @var{TArray} with values
extracted from it appropriate to the GMT time zone using
@code{gmtime(3)}.
The array elements are as follows:
@enumerate
@item
Seconds after the minute, range 0--59 or 0--61 to allow for leap
seconds
@item
Minutes after the hour, range 0--59
@item
Hours past midnight, range 0--23
@item
Day of month, range 0--31
@item
Number of months since January, range 0--12
@item
Years since 1900
@item
Number of days since Sunday, range 0--6
@item
Days since January 1
@item
Daylight savings indicator: positive if daylight savings is in effect,
zero if not, and negative if the information isn't available.
@end enumerate
@node HostNm Intrinsic (subroutine)
@subsubsection HostNm Intrinsic (subroutine)
@cindex HostNm intrinsic
@cindex intrinsics, HostNm
@noindent
@example
CALL HostNm(@var{Name}, @var{Status})
@end example
@noindent
@var{Name}: @code{CHARACTER}; scalar; INTENT(OUT).
@noindent
@var{Status}: @code{INTEGER(KIND=1)}; OPTIONAL; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Fills @var{Name} with the system's host name returned by
@code{gethostname(2)}.
If the @var{Status} argument is supplied, it contains
0 on success or a nonzero error code upon return
(@code{ENOSYS} if the system does not provide @code{gethostname(2)}).
Some non-GNU implementations of Fortran provide this intrinsic as
only a function, not as a subroutine, or do not support the
(optional) @var{Status} argument.
On some systems (specifically SCO) it might be necessary to link the
``socket'' library if you call this routine.
Typically this means adding @samp{-lg2c -lsocket -lm}
to the @code{g77} command line when linking the program.
For information on other intrinsics with the same name:
@xref{HostNm Intrinsic (function)}.
@node HostNm Intrinsic (function)
@subsubsection HostNm Intrinsic (function)
@cindex HostNm intrinsic
@cindex intrinsics, HostNm
@noindent
@example
HostNm(@var{Name})
@end example
@noindent
HostNm: @code{INTEGER(KIND=1)} function.
@noindent
@var{Name}: @code{CHARACTER}; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Fills @var{Name} with the system's host name returned by
@code{gethostname(2)}, returning 0 on success or a nonzero error code
(@code{ENOSYS} if the system does not provide @code{gethostname(2)}).
On some systems (specifically SCO) it might be necessary to link the
``socket'' library if you call this routine.
Typically this means adding @samp{-lg2c -lsocket -lm}
to the @code{g77} command line when linking the program.
For information on other intrinsics with the same name:
@xref{HostNm Intrinsic (subroutine)}.
@end ifset
@ifset familyF90
@node Huge Intrinsic
@subsubsection Huge Intrinsic
@cindex Huge intrinsic
@cindex intrinsics, Huge
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Huge} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node IAbs Intrinsic
@subsubsection IAbs Intrinsic
@cindex IAbs intrinsic
@cindex intrinsics, IAbs
@noindent
@example
IAbs(@var{A})
@end example
@noindent
IAbs: @code{INTEGER(KIND=1)} function.
@noindent
@var{A}: @code{INTEGER(KIND=1)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{ABS()} that is specific
to one type for @var{A}.
@xref{Abs Intrinsic}.
@end ifset
@ifset familyASC
@node IAChar Intrinsic
@subsubsection IAChar Intrinsic
@cindex IAChar intrinsic
@cindex intrinsics, IAChar
@noindent
@example
IAChar(@var{C})
@end example
@noindent
IAChar: @code{INTEGER(KIND=1)} function.
@noindent
@var{C}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}, @code{f90}.
@noindent
Description:
Returns the code for the ASCII character in the
first character position of @var{C}.
@xref{AChar Intrinsic}, for the inverse of this function.
@xref{IChar Intrinsic}, for the function corresponding
to the system's native character set.
@end ifset
@ifset familyMIL
@node IAnd Intrinsic
@subsubsection IAnd Intrinsic
@cindex IAnd intrinsic
@cindex intrinsics, IAnd
@noindent
@example
IAnd(@var{I}, @var{J})
@end example
@noindent
IAnd: @code{INTEGER} function, the exact type being the result of cross-promoting the
types of all the arguments.
@noindent
@var{I}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{J}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{mil}, @code{f90}, @code{vxt}.
@noindent
Description:
Returns value resulting from boolean AND of
pair of bits in each of @var{I} and @var{J}.
@end ifset
@ifset familyF2U
@node IArgC Intrinsic
@subsubsection IArgC Intrinsic
@cindex IArgC intrinsic
@cindex intrinsics, IArgC
@noindent
@example
IArgC()
@end example
@noindent
IArgC: @code{INTEGER(KIND=1)} function.
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns the number of command-line arguments.
This count does not include the specification of the program
name itself.
@end ifset
@ifset familyMIL
@node IBClr Intrinsic
@subsubsection IBClr Intrinsic
@cindex IBClr intrinsic
@cindex intrinsics, IBClr
@noindent
@example
IBClr(@var{I}, @var{Pos})
@end example
@noindent
IBClr: @code{INTEGER} function, the @samp{KIND=} value of the type being that of argument @var{I}.
@noindent
@var{I}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Pos}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{mil}, @code{f90}, @code{vxt}.
@noindent
Description:
Returns the value of @var{I} with bit @var{Pos} cleared (set to
zero).
@xref{BTest Intrinsic}, for information on bit positions.
@node IBits Intrinsic
@subsubsection IBits Intrinsic
@cindex IBits intrinsic
@cindex intrinsics, IBits
@noindent
@example
IBits(@var{I}, @var{Pos}, @var{Len})
@end example
@noindent
IBits: @code{INTEGER} function, the @samp{KIND=} value of the type being that of argument @var{I}.
@noindent
@var{I}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Pos}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Len}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{mil}, @code{f90}, @code{vxt}.
@noindent
Description:
Extracts a subfield of length @var{Len} from @var{I}, starting from
bit position @var{Pos} and extending left for @var{Len} bits.
The result is right-justified and the remaining bits are zeroed.
The value
of @samp{@var{Pos}+@var{Len}} must be less than or equal to the value
@samp{BIT_SIZE(@var{I})}.
@xref{Bit_Size Intrinsic}.
@node IBSet Intrinsic
@subsubsection IBSet Intrinsic
@cindex IBSet intrinsic
@cindex intrinsics, IBSet
@noindent
@example
IBSet(@var{I}, @var{Pos})
@end example
@noindent
IBSet: @code{INTEGER} function, the @samp{KIND=} value of the type being that of argument @var{I}.
@noindent
@var{I}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Pos}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{mil}, @code{f90}, @code{vxt}.
@noindent
Description:
Returns the value of @var{I} with bit @var{Pos} set (to one).
@xref{BTest Intrinsic}, for information on bit positions.
@end ifset
@ifset familyF77
@node IChar Intrinsic
@subsubsection IChar Intrinsic
@cindex IChar intrinsic
@cindex intrinsics, IChar
@noindent
@example
IChar(@var{C})
@end example
@noindent
IChar: @code{INTEGER(KIND=1)} function.
@noindent
@var{C}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns the code for the character in the
first character position of @var{C}.
Because the system's native character set is used,
the correspondence between character and their codes
is not necessarily the same between GNU Fortran
implementations.
Note that no intrinsic exists to convert a printable
character string to a numerical value.
For example, there is no intrinsic that, given
the @code{CHARACTER} value @samp{'154'}, returns an
@code{INTEGER} or @code{REAL} value with the value @samp{154}.
Instead, you can use internal-file I/O to do this kind
of conversion.
For example:
@smallexample
INTEGER VALUE
CHARACTER*10 STRING
STRING = '154'
READ (STRING, '(I10)'), VALUE
PRINT *, VALUE
END
@end smallexample
The above program, when run, prints:
@smallexample
154
@end smallexample
@xref{Char Intrinsic}, for the inverse of the @code{ICHAR} function.
@xref{IAChar Intrinsic}, for the function corresponding
to the ASCII character set.
@end ifset
@ifset familyF2U
@node IDate Intrinsic (UNIX)
@subsubsection IDate Intrinsic (UNIX)
@cindex IDate intrinsic
@cindex intrinsics, IDate
@noindent
@example
CALL IDate(@var{TArray})
@end example
@noindent
@var{TArray}: @code{INTEGER(KIND=1)}; DIMENSION(3); INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Fills @var{TArray} with the numerical values at the current local time.
The day (in the range 1--31), month (in the range 1--12),
and year appear in elements 1, 2, and 3 of @var{TArray}, respectively.
The year has four significant digits.
@cindex Y10K compliance
@cindex Year 10000 compliance
@cindex wraparound, Y10K
@cindex limits, Y10K
Programs making use of this intrinsic
might not be Year 10000 (Y10K) compliant.
For example, the date might appear,
to such programs, to wrap around
(change from a larger value to a smaller one)
as of the Year 10000.
For information on other intrinsics with the same name:
@xref{IDate Intrinsic (VXT)}.
@end ifset
@ifset familyVXT
@node IDate Intrinsic (VXT)
@subsubsection IDate Intrinsic (VXT)
@cindex IDate intrinsic
@cindex intrinsics, IDate
@noindent
@example
CALL IDate(@var{M}, @var{D}, @var{Y})
@end example
@noindent
@var{M}: @code{INTEGER(KIND=1)}; scalar; INTENT(OUT).
@noindent
@var{D}: @code{INTEGER(KIND=1)}; scalar; INTENT(OUT).
@noindent
@var{Y}: @code{INTEGER(KIND=1)}; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{vxt}.
@noindent
Description:
Returns the numerical values of the current local time.
The month (in the range 1--12) is returned in @var{M},
the day (in the range 1--31) in @var{D},
and the year in @var{Y} (in the range 0--99).
@cindex Y2K compliance
@cindex Year 2000 compliance
@cindex wraparound, Y2K
@cindex limits, Y2K
This intrinsic is not recommended, due to the fact that
its return value for year wraps around century boundaries
(change from a larger value to a smaller one).
Therefore, programs making use of this intrinsic, for
instance, might not be Year 2000 (Y2K) compliant.
For example, the date might appear,
to such programs, to wrap around
as of the Year 2000.
@xref{IDate Intrinsic (UNIX)}, for information on obtaining more digits
for the current date.
For information on other intrinsics with the same name:
@xref{IDate Intrinsic (UNIX)}.
@end ifset
@ifset familyF77
@node IDiM Intrinsic
@subsubsection IDiM Intrinsic
@cindex IDiM intrinsic
@cindex intrinsics, IDiM
@noindent
@example
IDiM(@var{X}, @var{Y})
@end example
@noindent
IDiM: @code{INTEGER(KIND=1)} function.
@noindent
@var{X}: @code{INTEGER(KIND=1)}; scalar; INTENT(IN).
@noindent
@var{Y}: @code{INTEGER(KIND=1)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{DIM()} that is specific
to one type for @var{X} and @var{Y}.
@xref{DiM Intrinsic}.
@node IDInt Intrinsic
@subsubsection IDInt Intrinsic
@cindex IDInt intrinsic
@cindex intrinsics, IDInt
@noindent
@example
IDInt(@var{A})
@end example
@noindent
IDInt: @code{INTEGER(KIND=1)} function.
@noindent
@var{A}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{INT()} that is specific
to one type for @var{A}.
@xref{Int Intrinsic}.
@node IDNInt Intrinsic
@subsubsection IDNInt Intrinsic
@cindex IDNInt intrinsic
@cindex intrinsics, IDNInt
@noindent
@example
IDNInt(@var{A})
@end example
@noindent
IDNInt: @code{INTEGER(KIND=1)} function.
@noindent
@var{A}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{NINT()} that is specific
to one type for @var{A}.
@xref{NInt Intrinsic}.
@end ifset
@ifset familyMIL
@node IEOr Intrinsic
@subsubsection IEOr Intrinsic
@cindex IEOr intrinsic
@cindex intrinsics, IEOr
@noindent
@example
IEOr(@var{I}, @var{J})
@end example
@noindent
IEOr: @code{INTEGER} function, the exact type being the result of cross-promoting the
types of all the arguments.
@noindent
@var{I}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{J}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{mil}, @code{f90}, @code{vxt}.
@noindent
Description:
Returns value resulting from boolean exclusive-OR of
pair of bits in each of @var{I} and @var{J}.
@end ifset
@ifset familyF2U
@node IErrNo Intrinsic
@subsubsection IErrNo Intrinsic
@cindex IErrNo intrinsic
@cindex intrinsics, IErrNo
@noindent
@example
IErrNo()
@end example
@noindent
IErrNo: @code{INTEGER(KIND=1)} function.
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns the last system error number (corresponding to the C
@code{errno}).
@end ifset
@ifset familyF77
@node IFix Intrinsic
@subsubsection IFix Intrinsic
@cindex IFix intrinsic
@cindex intrinsics, IFix
@noindent
@example
IFix(@var{A})
@end example
@noindent
IFix: @code{INTEGER(KIND=1)} function.
@noindent
@var{A}: @code{REAL(KIND=1)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{INT()} that is specific
to one type for @var{A}.
@xref{Int Intrinsic}.
@end ifset
@ifset familyVXT
@node IIAbs Intrinsic
@subsubsection IIAbs Intrinsic
@cindex IIAbs intrinsic
@cindex intrinsics, IIAbs
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL IIAbs} to use this name for an
external procedure.
@node IIAnd Intrinsic
@subsubsection IIAnd Intrinsic
@cindex IIAnd intrinsic
@cindex intrinsics, IIAnd
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL IIAnd} to use this name for an
external procedure.
@node IIBClr Intrinsic
@subsubsection IIBClr Intrinsic
@cindex IIBClr intrinsic
@cindex intrinsics, IIBClr
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL IIBClr} to use this name for an
external procedure.
@node IIBits Intrinsic
@subsubsection IIBits Intrinsic
@cindex IIBits intrinsic
@cindex intrinsics, IIBits
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL IIBits} to use this name for an
external procedure.
@node IIBSet Intrinsic
@subsubsection IIBSet Intrinsic
@cindex IIBSet intrinsic
@cindex intrinsics, IIBSet
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL IIBSet} to use this name for an
external procedure.
@node IIDiM Intrinsic
@subsubsection IIDiM Intrinsic
@cindex IIDiM intrinsic
@cindex intrinsics, IIDiM
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL IIDiM} to use this name for an
external procedure.
@node IIDInt Intrinsic
@subsubsection IIDInt Intrinsic
@cindex IIDInt intrinsic
@cindex intrinsics, IIDInt
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL IIDInt} to use this name for an
external procedure.
@node IIDNnt Intrinsic
@subsubsection IIDNnt Intrinsic
@cindex IIDNnt intrinsic
@cindex intrinsics, IIDNnt
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL IIDNnt} to use this name for an
external procedure.
@node IIEOr Intrinsic
@subsubsection IIEOr Intrinsic
@cindex IIEOr intrinsic
@cindex intrinsics, IIEOr
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL IIEOr} to use this name for an
external procedure.
@node IIFix Intrinsic
@subsubsection IIFix Intrinsic
@cindex IIFix intrinsic
@cindex intrinsics, IIFix
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL IIFix} to use this name for an
external procedure.
@node IInt Intrinsic
@subsubsection IInt Intrinsic
@cindex IInt intrinsic
@cindex intrinsics, IInt
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL IInt} to use this name for an
external procedure.
@node IIOr Intrinsic
@subsubsection IIOr Intrinsic
@cindex IIOr intrinsic
@cindex intrinsics, IIOr
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL IIOr} to use this name for an
external procedure.
@node IIQint Intrinsic
@subsubsection IIQint Intrinsic
@cindex IIQint intrinsic
@cindex intrinsics, IIQint
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL IIQint} to use this name for an
external procedure.
@node IIQNnt Intrinsic
@subsubsection IIQNnt Intrinsic
@cindex IIQNnt intrinsic
@cindex intrinsics, IIQNnt
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL IIQNnt} to use this name for an
external procedure.
@node IIShftC Intrinsic
@subsubsection IIShftC Intrinsic
@cindex IIShftC intrinsic
@cindex intrinsics, IIShftC
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL IIShftC} to use this name for an
external procedure.
@node IISign Intrinsic
@subsubsection IISign Intrinsic
@cindex IISign intrinsic
@cindex intrinsics, IISign
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL IISign} to use this name for an
external procedure.
@end ifset
@ifset familyF2C
@node Imag Intrinsic
@subsubsection Imag Intrinsic
@cindex Imag intrinsic
@cindex intrinsics, Imag
@noindent
@example
Imag(@var{Z})
@end example
@noindent
Imag: @code{REAL} function, the @samp{KIND=} value of the type being that of argument @var{Z}.
@noindent
@var{Z}: @code{COMPLEX}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}.
@noindent
Description:
The imaginary part of @var{Z} is returned, without conversion.
@emph{Note:} The way to do this in standard Fortran 90
is @samp{AIMAG(@var{Z})}.
However, when, for example, @var{Z} is @code{DOUBLE COMPLEX},
@samp{AIMAG(@var{Z})} means something different for some compilers
that are not true Fortran 90 compilers but offer some
extensions standardized by Fortran 90 (such as the
@code{DOUBLE COMPLEX} type, also known as @code{COMPLEX(KIND=2)}).
The advantage of @code{IMAG()} is that, while not necessarily
more or less portable than @code{AIMAG()}, it is more likely to
cause a compiler that doesn't support it to produce a diagnostic
than generate incorrect code.
@xref{REAL() and AIMAG() of Complex}, for more information.
@end ifset
@ifset familyGNU
@node ImagPart Intrinsic
@subsubsection ImagPart Intrinsic
@cindex ImagPart intrinsic
@cindex intrinsics, ImagPart
@noindent
@example
ImagPart(@var{Z})
@end example
@noindent
ImagPart: @code{REAL} function, the @samp{KIND=} value of the type being that of argument @var{Z}.
@noindent
@var{Z}: @code{COMPLEX}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{gnu}.
@noindent
Description:
The imaginary part of @var{Z} is returned, without conversion.
@emph{Note:} The way to do this in standard Fortran 90
is @samp{AIMAG(@var{Z})}.
However, when, for example, @var{Z} is @code{DOUBLE COMPLEX},
@samp{AIMAG(@var{Z})} means something different for some compilers
that are not true Fortran 90 compilers but offer some
extensions standardized by Fortran 90 (such as the
@code{DOUBLE COMPLEX} type, also known as @code{COMPLEX(KIND=2)}).
The advantage of @code{IMAGPART()} is that, while not necessarily
more or less portable than @code{AIMAG()}, it is more likely to
cause a compiler that doesn't support it to produce a diagnostic
than generate incorrect code.
@xref{REAL() and AIMAG() of Complex}, for more information.
@end ifset
@ifset familyVXT
@node IMax0 Intrinsic
@subsubsection IMax0 Intrinsic
@cindex IMax0 intrinsic
@cindex intrinsics, IMax0
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL IMax0} to use this name for an
external procedure.
@node IMax1 Intrinsic
@subsubsection IMax1 Intrinsic
@cindex IMax1 intrinsic
@cindex intrinsics, IMax1
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL IMax1} to use this name for an
external procedure.
@node IMin0 Intrinsic
@subsubsection IMin0 Intrinsic
@cindex IMin0 intrinsic
@cindex intrinsics, IMin0
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL IMin0} to use this name for an
external procedure.
@node IMin1 Intrinsic
@subsubsection IMin1 Intrinsic
@cindex IMin1 intrinsic
@cindex intrinsics, IMin1
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL IMin1} to use this name for an
external procedure.
@node IMod Intrinsic
@subsubsection IMod Intrinsic
@cindex IMod intrinsic
@cindex intrinsics, IMod
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL IMod} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node Index Intrinsic
@subsubsection Index Intrinsic
@cindex Index intrinsic
@cindex intrinsics, Index
@noindent
@example
Index(@var{String}, @var{Substring})
@end example
@noindent
Index: @code{INTEGER(KIND=1)} function.
@noindent
@var{String}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{Substring}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns the position of the start of the first occurrence of string
@var{Substring} as a substring in @var{String}, counting from one.
If @var{Substring} doesn't occur in @var{String}, zero is returned.
@end ifset
@ifset familyVXT
@node INInt Intrinsic
@subsubsection INInt Intrinsic
@cindex INInt intrinsic
@cindex intrinsics, INInt
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL INInt} to use this name for an
external procedure.
@node INot Intrinsic
@subsubsection INot Intrinsic
@cindex INot intrinsic
@cindex intrinsics, INot
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL INot} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node Int Intrinsic
@subsubsection Int Intrinsic
@cindex Int intrinsic
@cindex intrinsics, Int
@noindent
@example
Int(@var{A})
@end example
@noindent
Int: @code{INTEGER(KIND=1)} function.
@noindent
@var{A}: @code{INTEGER}, @code{REAL}, or @code{COMPLEX}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns @var{A} with the fractional portion of its
magnitude truncated and its sign preserved, converted
to type @code{INTEGER(KIND=1)}.
If @var{A} is type @code{COMPLEX}, its real part is
truncated and converted, and its imaginary part is disregarded.
@xref{NInt Intrinsic}, for how to convert, rounded to nearest
whole number.
@xref{AInt Intrinsic}, for how to truncate to whole number
without converting.
@end ifset
@ifset familyGNU
@node Int2 Intrinsic
@subsubsection Int2 Intrinsic
@cindex Int2 intrinsic
@cindex intrinsics, Int2
@noindent
@example
Int2(@var{A})
@end example
@noindent
Int2: @code{INTEGER(KIND=6)} function.
@noindent
@var{A}: @code{INTEGER}, @code{REAL}, or @code{COMPLEX}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{gnu}.
@noindent
Description:
Returns @var{A} with the fractional portion of its
magnitude truncated and its sign preserved, converted
to type @code{INTEGER(KIND=6)}.
If @var{A} is type @code{COMPLEX}, its real part
is truncated and converted, and its imaginary part is disregarded.
@xref{Int Intrinsic}.
The precise meaning of this intrinsic might change
in a future version of the GNU Fortran language,
as more is learned about how it is used.
@node Int8 Intrinsic
@subsubsection Int8 Intrinsic
@cindex Int8 intrinsic
@cindex intrinsics, Int8
@noindent
@example
Int8(@var{A})
@end example
@noindent
Int8: @code{INTEGER(KIND=2)} function.
@noindent
@var{A}: @code{INTEGER}, @code{REAL}, or @code{COMPLEX}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{gnu}.
@noindent
Description:
Returns @var{A} with the fractional portion of its
magnitude truncated and its sign preserved, converted
to type @code{INTEGER(KIND=2)}.
If @var{A} is type @code{COMPLEX}, its real part
is truncated and converted, and its imaginary part is disregarded.
@xref{Int Intrinsic}.
The precise meaning of this intrinsic might change
in a future version of the GNU Fortran language,
as more is learned about how it is used.
@end ifset
@ifset familyMIL
@node IOr Intrinsic
@subsubsection IOr Intrinsic
@cindex IOr intrinsic
@cindex intrinsics, IOr
@noindent
@example
IOr(@var{I}, @var{J})
@end example
@noindent
IOr: @code{INTEGER} function, the exact type being the result of cross-promoting the
types of all the arguments.
@noindent
@var{I}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{J}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{mil}, @code{f90}, @code{vxt}.
@noindent
Description:
Returns value resulting from boolean OR of
pair of bits in each of @var{I} and @var{J}.
@end ifset
@ifset familyF2U
@node IRand Intrinsic
@subsubsection IRand Intrinsic
@cindex IRand intrinsic
@cindex intrinsics, IRand
@noindent
@example
IRand(@var{Flag})
@end example
@noindent
IRand: @code{INTEGER(KIND=1)} function.
@noindent
@var{Flag}: @code{INTEGER}; OPTIONAL; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns a uniform quasi-random number up to a system-dependent limit.
If @var{Flag} is 0, the next number in sequence is returned; if
@var{Flag} is 1, the generator is restarted by calling the UNIX function
@samp{srand(0)}; if @var{Flag} has any other value,
it is used as a new seed with @code{srand()}.
@xref{SRand Intrinsic}.
@emph{Note:} As typically implemented (by the routine of the same
name in the C library), this random number generator is a very poor
one, though the BSD and GNU libraries provide a much better
implementation than the `traditional' one.
On a different system you almost certainly want to use something better.
@node IsaTty Intrinsic
@subsubsection IsaTty Intrinsic
@cindex IsaTty intrinsic
@cindex intrinsics, IsaTty
@noindent
@example
IsaTty(@var{Unit})
@end example
@noindent
IsaTty: @code{LOGICAL(KIND=1)} function.
@noindent
@var{Unit}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns @code{.TRUE.} if and only if the Fortran I/O unit
specified by @var{Unit} is connected
to a terminal device.
See @code{isatty(3)}.
@end ifset
@ifset familyMIL
@node IShft Intrinsic
@subsubsection IShft Intrinsic
@cindex IShft intrinsic
@cindex intrinsics, IShft
@noindent
@example
IShft(@var{I}, @var{Shift})
@end example
@noindent
IShft: @code{INTEGER} function, the @samp{KIND=} value of the type being that of argument @var{I}.
@noindent
@var{I}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Shift}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{mil}, @code{f90}, @code{vxt}.
@noindent
Description:
All bits representing @var{I} are shifted @var{Shift} places.
@samp{@var{Shift}.GT.0} indicates a left shift, @samp{@var{Shift}.EQ.0}
indicates no shift and @samp{@var{Shift}.LT.0} indicates a right shift.
If the absolute value of the shift count is greater than
@samp{BIT_SIZE(@var{I})}, the result is undefined.
Bits shifted out from the left end or the right end are lost.
Zeros are shifted in from the opposite end.
@xref{IShftC Intrinsic}, for the circular-shift equivalent.
@node IShftC Intrinsic
@subsubsection IShftC Intrinsic
@cindex IShftC intrinsic
@cindex intrinsics, IShftC
@noindent
@example
IShftC(@var{I}, @var{Shift}, @var{Size})
@end example
@noindent
IShftC: @code{INTEGER} function, the @samp{KIND=} value of the type being that of argument @var{I}.
@noindent
@var{I}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Shift}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Size}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{mil}, @code{f90}, @code{vxt}.
@noindent
Description:
The rightmost @var{Size} bits of the argument @var{I}
are shifted circularly @var{Shift}
places, i.e.@: the bits shifted out of one end are shifted into
the opposite end.
No bits are lost.
The unshifted bits of the result are the same as
the unshifted bits of @var{I}.
The absolute value of the argument @var{Shift}
must be less than or equal to @var{Size}.
The value of @var{Size} must be greater than or equal to one and less than
or equal to @samp{BIT_SIZE(@var{I})}.
@xref{IShft Intrinsic}, for the logical shift equivalent.
@end ifset
@ifset familyF77
@node ISign Intrinsic
@subsubsection ISign Intrinsic
@cindex ISign intrinsic
@cindex intrinsics, ISign
@noindent
@example
ISign(@var{A}, @var{B})
@end example
@noindent
ISign: @code{INTEGER(KIND=1)} function.
@noindent
@var{A}: @code{INTEGER(KIND=1)}; scalar; INTENT(IN).
@noindent
@var{B}: @code{INTEGER(KIND=1)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{SIGN()} that is specific
to one type for @var{A} and @var{B}.
@xref{Sign Intrinsic}.
@end ifset
@ifset familyF2U
@node ITime Intrinsic
@subsubsection ITime Intrinsic
@cindex ITime intrinsic
@cindex intrinsics, ITime
@noindent
@example
CALL ITime(@var{TArray})
@end example
@noindent
@var{TArray}: @code{INTEGER(KIND=1)}; DIMENSION(3); INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns the current local time hour, minutes, and seconds in elements
1, 2, and 3 of @var{TArray}, respectively.
@end ifset
@ifset familyVXT
@node IZExt Intrinsic
@subsubsection IZExt Intrinsic
@cindex IZExt intrinsic
@cindex intrinsics, IZExt
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL IZExt} to use this name for an
external procedure.
@node JIAbs Intrinsic
@subsubsection JIAbs Intrinsic
@cindex JIAbs intrinsic
@cindex intrinsics, JIAbs
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JIAbs} to use this name for an
external procedure.
@node JIAnd Intrinsic
@subsubsection JIAnd Intrinsic
@cindex JIAnd intrinsic
@cindex intrinsics, JIAnd
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JIAnd} to use this name for an
external procedure.
@node JIBClr Intrinsic
@subsubsection JIBClr Intrinsic
@cindex JIBClr intrinsic
@cindex intrinsics, JIBClr
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JIBClr} to use this name for an
external procedure.
@node JIBits Intrinsic
@subsubsection JIBits Intrinsic
@cindex JIBits intrinsic
@cindex intrinsics, JIBits
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JIBits} to use this name for an
external procedure.
@node JIBSet Intrinsic
@subsubsection JIBSet Intrinsic
@cindex JIBSet intrinsic
@cindex intrinsics, JIBSet
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JIBSet} to use this name for an
external procedure.
@node JIDiM Intrinsic
@subsubsection JIDiM Intrinsic
@cindex JIDiM intrinsic
@cindex intrinsics, JIDiM
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JIDiM} to use this name for an
external procedure.
@node JIDInt Intrinsic
@subsubsection JIDInt Intrinsic
@cindex JIDInt intrinsic
@cindex intrinsics, JIDInt
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JIDInt} to use this name for an
external procedure.
@node JIDNnt Intrinsic
@subsubsection JIDNnt Intrinsic
@cindex JIDNnt intrinsic
@cindex intrinsics, JIDNnt
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JIDNnt} to use this name for an
external procedure.
@node JIEOr Intrinsic
@subsubsection JIEOr Intrinsic
@cindex JIEOr intrinsic
@cindex intrinsics, JIEOr
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JIEOr} to use this name for an
external procedure.
@node JIFix Intrinsic
@subsubsection JIFix Intrinsic
@cindex JIFix intrinsic
@cindex intrinsics, JIFix
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JIFix} to use this name for an
external procedure.
@node JInt Intrinsic
@subsubsection JInt Intrinsic
@cindex JInt intrinsic
@cindex intrinsics, JInt
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JInt} to use this name for an
external procedure.
@node JIOr Intrinsic
@subsubsection JIOr Intrinsic
@cindex JIOr intrinsic
@cindex intrinsics, JIOr
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JIOr} to use this name for an
external procedure.
@node JIQint Intrinsic
@subsubsection JIQint Intrinsic
@cindex JIQint intrinsic
@cindex intrinsics, JIQint
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JIQint} to use this name for an
external procedure.
@node JIQNnt Intrinsic
@subsubsection JIQNnt Intrinsic
@cindex JIQNnt intrinsic
@cindex intrinsics, JIQNnt
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JIQNnt} to use this name for an
external procedure.
@node JIShft Intrinsic
@subsubsection JIShft Intrinsic
@cindex JIShft intrinsic
@cindex intrinsics, JIShft
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JIShft} to use this name for an
external procedure.
@node JIShftC Intrinsic
@subsubsection JIShftC Intrinsic
@cindex JIShftC intrinsic
@cindex intrinsics, JIShftC
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JIShftC} to use this name for an
external procedure.
@node JISign Intrinsic
@subsubsection JISign Intrinsic
@cindex JISign intrinsic
@cindex intrinsics, JISign
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JISign} to use this name for an
external procedure.
@node JMax0 Intrinsic
@subsubsection JMax0 Intrinsic
@cindex JMax0 intrinsic
@cindex intrinsics, JMax0
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JMax0} to use this name for an
external procedure.
@node JMax1 Intrinsic
@subsubsection JMax1 Intrinsic
@cindex JMax1 intrinsic
@cindex intrinsics, JMax1
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JMax1} to use this name for an
external procedure.
@node JMin0 Intrinsic
@subsubsection JMin0 Intrinsic
@cindex JMin0 intrinsic
@cindex intrinsics, JMin0
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JMin0} to use this name for an
external procedure.
@node JMin1 Intrinsic
@subsubsection JMin1 Intrinsic
@cindex JMin1 intrinsic
@cindex intrinsics, JMin1
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JMin1} to use this name for an
external procedure.
@node JMod Intrinsic
@subsubsection JMod Intrinsic
@cindex JMod intrinsic
@cindex intrinsics, JMod
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JMod} to use this name for an
external procedure.
@node JNInt Intrinsic
@subsubsection JNInt Intrinsic
@cindex JNInt intrinsic
@cindex intrinsics, JNInt
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JNInt} to use this name for an
external procedure.
@node JNot Intrinsic
@subsubsection JNot Intrinsic
@cindex JNot intrinsic
@cindex intrinsics, JNot
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JNot} to use this name for an
external procedure.
@node JZExt Intrinsic
@subsubsection JZExt Intrinsic
@cindex JZExt intrinsic
@cindex intrinsics, JZExt
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL JZExt} to use this name for an
external procedure.
@end ifset
@ifset familyF2U
@node Kill Intrinsic (subroutine)
@subsubsection Kill Intrinsic (subroutine)
@cindex Kill intrinsic
@cindex intrinsics, Kill
@noindent
@example
CALL Kill(@var{Pid}, @var{Signal}, @var{Status})
@end example
@noindent
@var{Pid}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Signal}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Status}: @code{INTEGER(KIND=1)}; OPTIONAL; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Sends the signal specified by @var{Signal} to the process @var{Pid}.
If the @var{Status} argument is supplied, it contains
0 on success or a nonzero error code upon return.
See @code{kill(2)}.
Some non-GNU implementations of Fortran provide this intrinsic as
only a function, not as a subroutine, or do not support the
(optional) @var{Status} argument.
For information on other intrinsics with the same name:
@xref{Kill Intrinsic (function)}.
@end ifset
@ifset familyBADU77
@node Kill Intrinsic (function)
@subsubsection Kill Intrinsic (function)
@cindex Kill intrinsic
@cindex intrinsics, Kill
@noindent
@example
Kill(@var{Pid}, @var{Signal})
@end example
@noindent
Kill: @code{INTEGER(KIND=1)} function.
@noindent
@var{Pid}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Signal}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{badu77}.
@noindent
Description:
Sends the signal specified by @var{Signal} to the process @var{Pid}.
Returns 0 on success or a nonzero error code.
See @code{kill(2)}.
Due to the side effects performed by this intrinsic, the function
form is not recommended.
For information on other intrinsics with the same name:
@xref{Kill Intrinsic (subroutine)}.
@end ifset
@ifset familyF90
@node Kind Intrinsic
@subsubsection Kind Intrinsic
@cindex Kind intrinsic
@cindex intrinsics, Kind
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Kind} to use this name for an
external procedure.
@node LBound Intrinsic
@subsubsection LBound Intrinsic
@cindex LBound intrinsic
@cindex intrinsics, LBound
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL LBound} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node Len Intrinsic
@subsubsection Len Intrinsic
@cindex Len intrinsic
@cindex intrinsics, Len
@noindent
@example
Len(@var{String})
@end example
@noindent
Len: @code{INTEGER(KIND=1)} function.
@noindent
@var{String}: @code{CHARACTER}; scalar.
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns the length of @var{String}.
If @var{String} is an array, the length of an element
of @var{String} is returned.
Note that @var{String} need not be defined when this
intrinsic is invoked, since only the length, not
the content, of @var{String} is needed.
@xref{Bit_Size Intrinsic}, for the function that determines
the size of its argument in bits.
@end ifset
@ifset familyF90
@node Len_Trim Intrinsic
@subsubsection Len_Trim Intrinsic
@cindex Len_Trim intrinsic
@cindex intrinsics, Len_Trim
@noindent
@example
Len_Trim(@var{String})
@end example
@noindent
Len_Trim: @code{INTEGER(KIND=1)} function.
@noindent
@var{String}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f90}.
@noindent
Description:
Returns the index of the last non-blank character in @var{String}.
@code{LNBLNK} and @code{LEN_TRIM} are equivalent.
@end ifset
@ifset familyF77
@node LGe Intrinsic
@subsubsection LGe Intrinsic
@cindex LGe intrinsic
@cindex intrinsics, LGe
@noindent
@example
LGe(@var{String_A}, @var{String_B})
@end example
@noindent
LGe: @code{LOGICAL(KIND=1)} function.
@noindent
@var{String_A}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{String_B}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns @samp{.TRUE.} if @samp{@var{String_A}.GE.@var{String_B}},
@samp{.FALSE.} otherwise.
@var{String_A} and @var{String_B} are interpreted as containing
ASCII character codes.
If either value contains a character not in the ASCII
character set, the result is processor dependent.
If the @var{String_A} and @var{String_B} are not the same length,
the shorter is compared as if spaces were appended to
it to form a value that has the same length as the longer.
The lexical comparison intrinsics @code{LGe}, @code{LGt},
@code{LLe}, and @code{LLt} differ from the corresponding
intrinsic operators @code{.GE.}, @code{.GT.},
@code{.LE.}, @code{.LT.}.
Because the ASCII collating sequence is assumed,
the following expressions always return @samp{.TRUE.}:
@smallexample
LGE ('0', ' ')
LGE ('A', '0')
LGE ('a', 'A')
@end smallexample
The following related expressions do @emph{not} always
return @samp{.TRUE.}, as they are not necessarily evaluated
assuming the arguments use ASCII encoding:
@smallexample
'0' .GE. ' '
'A' .GE. '0'
'a' .GE. 'A'
@end smallexample
The same difference exists
between @code{LGt} and @code{.GT.};
between @code{LLe} and @code{.LE.}; and
between @code{LLt} and @code{.LT.}.
@node LGt Intrinsic
@subsubsection LGt Intrinsic
@cindex LGt intrinsic
@cindex intrinsics, LGt
@noindent
@example
LGt(@var{String_A}, @var{String_B})
@end example
@noindent
LGt: @code{LOGICAL(KIND=1)} function.
@noindent
@var{String_A}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{String_B}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns @samp{.TRUE.} if @samp{@var{String_A}.GT.@var{String_B}},
@samp{.FALSE.} otherwise.
@var{String_A} and @var{String_B} are interpreted as containing
ASCII character codes.
If either value contains a character not in the ASCII
character set, the result is processor dependent.
If the @var{String_A} and @var{String_B} are not the same length,
the shorter is compared as if spaces were appended to
it to form a value that has the same length as the longer.
@xref{LGe Intrinsic}, for information on the distinction
between the @code{LGT} intrinsic and the @code{.GT.}
operator.
@end ifset
@ifset familyF2U
@node Link Intrinsic (subroutine)
@subsubsection Link Intrinsic (subroutine)
@cindex Link intrinsic
@cindex intrinsics, Link
@noindent
@example
CALL Link(@var{Path1}, @var{Path2}, @var{Status})
@end example
@noindent
@var{Path1}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{Path2}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{Status}: @code{INTEGER(KIND=1)}; OPTIONAL; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Makes a (hard) link from file @var{Path1} to @var{Path2}.
A null character (@samp{CHAR(0)}) marks the end of
the names in @var{Path1} and @var{Path2}---otherwise,
trailing blanks in @var{Path1} and @var{Path2} are ignored.
If the @var{Status} argument is supplied, it contains
0 on success or a nonzero error code upon return.
See @code{link(2)}.
Some non-GNU implementations of Fortran provide this intrinsic as
only a function, not as a subroutine, or do not support the
(optional) @var{Status} argument.
For information on other intrinsics with the same name:
@xref{Link Intrinsic (function)}.
@end ifset
@ifset familyBADU77
@node Link Intrinsic (function)
@subsubsection Link Intrinsic (function)
@cindex Link intrinsic
@cindex intrinsics, Link
@noindent
@example
Link(@var{Path1}, @var{Path2})
@end example
@noindent
Link: @code{INTEGER(KIND=1)} function.
@noindent
@var{Path1}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{Path2}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{badu77}.
@noindent
Description:
Makes a (hard) link from file @var{Path1} to @var{Path2}.
A null character (@samp{CHAR(0)}) marks the end of
the names in @var{Path1} and @var{Path2}---otherwise,
trailing blanks in @var{Path1} and @var{Path2} are ignored.
Returns 0 on success or a nonzero error code.
See @code{link(2)}.
Due to the side effects performed by this intrinsic, the function
form is not recommended.
For information on other intrinsics with the same name:
@xref{Link Intrinsic (subroutine)}.
@end ifset
@ifset familyF77
@node LLe Intrinsic
@subsubsection LLe Intrinsic
@cindex LLe intrinsic
@cindex intrinsics, LLe
@noindent
@example
LLe(@var{String_A}, @var{String_B})
@end example
@noindent
LLe: @code{LOGICAL(KIND=1)} function.
@noindent
@var{String_A}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{String_B}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns @samp{.TRUE.} if @samp{@var{String_A}.LE.@var{String_B}},
@samp{.FALSE.} otherwise.
@var{String_A} and @var{String_B} are interpreted as containing
ASCII character codes.
If either value contains a character not in the ASCII
character set, the result is processor dependent.
If the @var{String_A} and @var{String_B} are not the same length,
the shorter is compared as if spaces were appended to
it to form a value that has the same length as the longer.
@xref{LGe Intrinsic}, for information on the distinction
between the @code{LLE} intrinsic and the @code{.LE.}
operator.
@node LLt Intrinsic
@subsubsection LLt Intrinsic
@cindex LLt intrinsic
@cindex intrinsics, LLt
@noindent
@example
LLt(@var{String_A}, @var{String_B})
@end example
@noindent
LLt: @code{LOGICAL(KIND=1)} function.
@noindent
@var{String_A}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{String_B}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns @samp{.TRUE.} if @samp{@var{String_A}.LT.@var{String_B}},
@samp{.FALSE.} otherwise.
@var{String_A} and @var{String_B} are interpreted as containing
ASCII character codes.
If either value contains a character not in the ASCII
character set, the result is processor dependent.
If the @var{String_A} and @var{String_B} are not the same length,
the shorter is compared as if spaces were appended to
it to form a value that has the same length as the longer.
@xref{LGe Intrinsic}, for information on the distinction
between the @code{LLT} intrinsic and the @code{.LT.}
operator.
@end ifset
@ifset familyF2U
@node LnBlnk Intrinsic
@subsubsection LnBlnk Intrinsic
@cindex LnBlnk intrinsic
@cindex intrinsics, LnBlnk
@noindent
@example
LnBlnk(@var{String})
@end example
@noindent
LnBlnk: @code{INTEGER(KIND=1)} function.
@noindent
@var{String}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns the index of the last non-blank character in @var{String}.
@code{LNBLNK} and @code{LEN_TRIM} are equivalent.
@node Loc Intrinsic
@subsubsection Loc Intrinsic
@cindex Loc intrinsic
@cindex intrinsics, Loc
@noindent
@example
Loc(@var{Entity})
@end example
@noindent
Loc: @code{INTEGER(KIND=7)} function.
@noindent
@var{Entity}: Any type; cannot be a constant or expression.
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
The @code{LOC()} intrinsic works the
same way as the @code{%LOC()} construct.
@xref{%LOC(),,The @code{%LOC()} Construct}, for
more information.
@end ifset
@ifset familyF77
@node Log Intrinsic
@subsubsection Log Intrinsic
@cindex Log intrinsic
@cindex intrinsics, Log
@noindent
@example
Log(@var{X})
@end example
@noindent
Log: @code{REAL} or @code{COMPLEX} function, the exact type being that of argument @var{X}.
@noindent
@var{X}: @code{REAL} or @code{COMPLEX}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns the natural logarithm of @var{X}, which must
be greater than zero or, if type @code{COMPLEX}, must not
be zero.
@xref{Exp Intrinsic}, for the inverse of this function.
@xref{Log10 Intrinsic}, for the `common' (base-10) logarithm function.
@node Log10 Intrinsic
@subsubsection Log10 Intrinsic
@cindex Log10 intrinsic
@cindex intrinsics, Log10
@noindent
@example
Log10(@var{X})
@end example
@noindent
Log10: @code{REAL} function, the @samp{KIND=} value of the type being that of argument @var{X}.
@noindent
@var{X}: @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns the common logarithm (base 10) of @var{X}, which must
be greater than zero.
The inverse of this function is @samp{10. ** LOG10(@var{X})}.
@xref{Log Intrinsic}, for the natural logarithm function.
@end ifset
@ifset familyF90
@node Logical Intrinsic
@subsubsection Logical Intrinsic
@cindex Logical intrinsic
@cindex intrinsics, Logical
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Logical} to use this name for an
external procedure.
@end ifset
@ifset familyF2U
@node Long Intrinsic
@subsubsection Long Intrinsic
@cindex Long intrinsic
@cindex intrinsics, Long
@noindent
@example
Long(@var{A})
@end example
@noindent
Long: @code{INTEGER(KIND=1)} function.
@noindent
@var{A}: @code{INTEGER(KIND=6)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Archaic form of @code{INT()} that is specific
to one type for @var{A}.
@xref{Int Intrinsic}.
The precise meaning of this intrinsic might change
in a future version of the GNU Fortran language,
as more is learned about how it is used.
@end ifset
@ifset familyF2C
@node LShift Intrinsic
@subsubsection LShift Intrinsic
@cindex LShift intrinsic
@cindex intrinsics, LShift
@noindent
@example
LShift(@var{I}, @var{Shift})
@end example
@noindent
LShift: @code{INTEGER} function, the @samp{KIND=} value of the type being that of argument @var{I}.
@noindent
@var{I}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Shift}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}.
@noindent
Description:
Returns @var{I} shifted to the left
@var{Shift} bits.
Although similar to the expression
@samp{@var{I}*(2**@var{Shift})}, there
are important differences.
For example, the sign of the result is
not necessarily the same as the sign of
@var{I}.
Currently this intrinsic is defined assuming
the underlying representation of @var{I}
is as a two's-complement integer.
It is unclear at this point whether that
definition will apply when a different
representation is involved.
@xref{LShift Intrinsic}, for the inverse of this function.
@xref{IShft Intrinsic}, for information
on a more widely available left-shifting
intrinsic that is also more precisely defined.
@end ifset
@ifset familyF2U
@node LStat Intrinsic (subroutine)
@subsubsection LStat Intrinsic (subroutine)
@cindex LStat intrinsic
@cindex intrinsics, LStat
@noindent
@example
CALL LStat(@var{File}, @var{SArray}, @var{Status})
@end example
@noindent
@var{File}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{SArray}: @code{INTEGER(KIND=1)}; DIMENSION(13); INTENT(OUT).
@noindent
@var{Status}: @code{INTEGER(KIND=1)}; OPTIONAL; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Obtains data about the given file @var{File} and places them in the array
@var{SArray}.
A null character (@samp{CHAR(0)}) marks the end of
the name in @var{File}---otherwise,
trailing blanks in @var{File} are ignored.
If @var{File} is a symbolic link it returns data on the
link itself, so the routine is available only on systems that support
symbolic links.
The values in this array are extracted from the
@code{stat} structure as returned by @code{fstat(2)} q.v., as follows:
@enumerate
@item
Device ID
@item
Inode number
@item
File mode
@item
Number of links
@item
Owner's uid
@item
Owner's gid
@item
ID of device containing directory entry for file
(0 if not available)
@item
File size (bytes)
@item
Last access time
@item
Last modification time
@item
Last file status change time
@item
Preferred I/O block size (-1 if not available)
@item
Number of blocks allocated (-1 if not available)
@end enumerate
Not all these elements are relevant on all systems.
If an element is not relevant, it is returned as 0.
If the @var{Status} argument is supplied, it contains
0 on success or a nonzero error code upon return
(@code{ENOSYS} if the system does not provide @code{lstat(2)}).
Some non-GNU implementations of Fortran provide this intrinsic as
only a function, not as a subroutine, or do not support the
(optional) @var{Status} argument.
For information on other intrinsics with the same name:
@xref{LStat Intrinsic (function)}.
@node LStat Intrinsic (function)
@subsubsection LStat Intrinsic (function)
@cindex LStat intrinsic
@cindex intrinsics, LStat
@noindent
@example
LStat(@var{File}, @var{SArray})
@end example
@noindent
LStat: @code{INTEGER(KIND=1)} function.
@noindent
@var{File}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{SArray}: @code{INTEGER(KIND=1)}; DIMENSION(13); INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Obtains data about the given file @var{File} and places them in the array
@var{SArray}.
A null character (@samp{CHAR(0)}) marks the end of
the name in @var{File}---otherwise,
trailing blanks in @var{File} are ignored.
If @var{File} is a symbolic link it returns data on the
link itself, so the routine is available only on systems that support
symbolic links.
The values in this array are extracted from the
@code{stat} structure as returned by @code{fstat(2)} q.v., as follows:
@enumerate
@item
Device ID
@item
Inode number
@item
File mode
@item
Number of links
@item
Owner's uid
@item
Owner's gid
@item
ID of device containing directory entry for file
(0 if not available)
@item
File size (bytes)
@item
Last access time
@item
Last modification time
@item
Last file status change time
@item
Preferred I/O block size (-1 if not available)
@item
Number of blocks allocated (-1 if not available)
@end enumerate
Not all these elements are relevant on all systems.
If an element is not relevant, it is returned as 0.
Returns 0 on success or a nonzero error code
(@code{ENOSYS} if the system does not provide @code{lstat(2)}).
For information on other intrinsics with the same name:
@xref{LStat Intrinsic (subroutine)}.
@node LTime Intrinsic
@subsubsection LTime Intrinsic
@cindex LTime intrinsic
@cindex intrinsics, LTime
@noindent
@example
CALL LTime(@var{STime}, @var{TArray})
@end example
@noindent
@var{STime}: @code{INTEGER(KIND=1)}; scalar; INTENT(IN).
@noindent
@var{TArray}: @code{INTEGER(KIND=1)}; DIMENSION(9); INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Given a system time value @var{STime}, fills @var{TArray} with values
extracted from it appropriate to the GMT time zone using
@code{localtime(3)}.
The array elements are as follows:
@enumerate
@item
Seconds after the minute, range 0--59 or 0--61 to allow for leap
seconds
@item
Minutes after the hour, range 0--59
@item
Hours past midnight, range 0--23
@item
Day of month, range 0--31
@item
Number of months since January, range 0--12
@item
Years since 1900
@item
Number of days since Sunday, range 0--6
@item
Days since January 1
@item
Daylight savings indicator: positive if daylight savings is in effect,
zero if not, and negative if the information isn't available.
@end enumerate
@end ifset
@ifset familyF90
@node MatMul Intrinsic
@subsubsection MatMul Intrinsic
@cindex MatMul intrinsic
@cindex intrinsics, MatMul
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL MatMul} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node Max Intrinsic
@subsubsection Max Intrinsic
@cindex Max intrinsic
@cindex intrinsics, Max
@noindent
@example
Max(@var{A}-1, @var{A}-2, @dots{}, @var{A}-n)
@end example
@noindent
Max: @code{INTEGER} or @code{REAL} function, the exact type being the result of cross-promoting the
types of all the arguments.
@noindent
@var{A}: @code{INTEGER} or @code{REAL}; at least two such arguments must be provided; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns the argument with the largest value.
@xref{Min Intrinsic}, for the opposite function.
@node Max0 Intrinsic
@subsubsection Max0 Intrinsic
@cindex Max0 intrinsic
@cindex intrinsics, Max0
@noindent
@example
Max0(@var{A}-1, @var{A}-2, @dots{}, @var{A}-n)
@end example
@noindent
Max0: @code{INTEGER(KIND=1)} function.
@noindent
@var{A}: @code{INTEGER(KIND=1)}; at least two such arguments must be provided; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{MAX()} that is specific
to one type for @var{A}.
@xref{Max Intrinsic}.
@node Max1 Intrinsic
@subsubsection Max1 Intrinsic
@cindex Max1 intrinsic
@cindex intrinsics, Max1
@noindent
@example
Max1(@var{A}-1, @var{A}-2, @dots{}, @var{A}-n)
@end example
@noindent
Max1: @code{INTEGER(KIND=1)} function.
@noindent
@var{A}: @code{REAL(KIND=1)}; at least two such arguments must be provided; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{MAX()} that is specific
to one type for @var{A} and a different return type.
@xref{Max Intrinsic}.
@end ifset
@ifset familyF90
@node MaxExponent Intrinsic
@subsubsection MaxExponent Intrinsic
@cindex MaxExponent intrinsic
@cindex intrinsics, MaxExponent
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL MaxExponent} to use this name for an
external procedure.
@node MaxLoc Intrinsic
@subsubsection MaxLoc Intrinsic
@cindex MaxLoc intrinsic
@cindex intrinsics, MaxLoc
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL MaxLoc} to use this name for an
external procedure.
@node MaxVal Intrinsic
@subsubsection MaxVal Intrinsic
@cindex MaxVal intrinsic
@cindex intrinsics, MaxVal
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL MaxVal} to use this name for an
external procedure.
@end ifset
@ifset familyF2U
@node MClock Intrinsic
@subsubsection MClock Intrinsic
@cindex MClock intrinsic
@cindex intrinsics, MClock
@noindent
@example
MClock()
@end example
@noindent
MClock: @code{INTEGER(KIND=1)} function.
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns the number of clock ticks since the start of the process.
Supported on systems with @code{clock(3)} (q.v.).
@cindex wraparound, timings
@cindex limits, timings
This intrinsic is not fully portable, such as to systems
with 32-bit @code{INTEGER} types but supporting times
wider than 32 bits.
Therefore, the values returned by this intrinsic
might be, or become, negative,
or numerically less than previous values,
during a single run of the compiled program.
@xref{MClock8 Intrinsic}, for information on a
similar intrinsic that might be portable to more
GNU Fortran implementations, though to fewer
Fortran compilers.
If the system does not support @code{clock(3)},
-1 is returned.
@node MClock8 Intrinsic
@subsubsection MClock8 Intrinsic
@cindex MClock8 intrinsic
@cindex intrinsics, MClock8
@noindent
@example
MClock8()
@end example
@noindent
MClock8: @code{INTEGER(KIND=2)} function.
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns the number of clock ticks since the start of the process.
Supported on systems with @code{clock(3)} (q.v.).
@cindex wraparound, timings
@cindex limits, timings
@emph{Warning:} this intrinsic does not increase the range
of the timing values over that returned by @code{clock(3)}.
On a system with a 32-bit @code{clock(3)},
@code{MCLOCK8} will return a 32-bit value,
even though converted to an @samp{INTEGER(KIND=2)} value.
That means overflows of the 32-bit value can still occur.
Therefore, the values returned by this intrinsic
might be, or become, negative,
or numerically less than previous values,
during a single run of the compiled program.
No Fortran implementations other than GNU Fortran are
known to support this intrinsic at the time of this
writing.
@xref{MClock Intrinsic}, for information on a
similar intrinsic that might be portable to more Fortran
compilers, though to fewer GNU Fortran implementations.
If the system does not support @code{clock(3)},
-1 is returned.
@end ifset
@ifset familyF90
@node Merge Intrinsic
@subsubsection Merge Intrinsic
@cindex Merge intrinsic
@cindex intrinsics, Merge
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Merge} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node Min Intrinsic
@subsubsection Min Intrinsic
@cindex Min intrinsic
@cindex intrinsics, Min
@noindent
@example
Min(@var{A}-1, @var{A}-2, @dots{}, @var{A}-n)
@end example
@noindent
Min: @code{INTEGER} or @code{REAL} function, the exact type being the result of cross-promoting the
types of all the arguments.
@noindent
@var{A}: @code{INTEGER} or @code{REAL}; at least two such arguments must be provided; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns the argument with the smallest value.
@xref{Max Intrinsic}, for the opposite function.
@node Min0 Intrinsic
@subsubsection Min0 Intrinsic
@cindex Min0 intrinsic
@cindex intrinsics, Min0
@noindent
@example
Min0(@var{A}-1, @var{A}-2, @dots{}, @var{A}-n)
@end example
@noindent
Min0: @code{INTEGER(KIND=1)} function.
@noindent
@var{A}: @code{INTEGER(KIND=1)}; at least two such arguments must be provided; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{MIN()} that is specific
to one type for @var{A}.
@xref{Min Intrinsic}.
@node Min1 Intrinsic
@subsubsection Min1 Intrinsic
@cindex Min1 intrinsic
@cindex intrinsics, Min1
@noindent
@example
Min1(@var{A}-1, @var{A}-2, @dots{}, @var{A}-n)
@end example
@noindent
Min1: @code{INTEGER(KIND=1)} function.
@noindent
@var{A}: @code{REAL(KIND=1)}; at least two such arguments must be provided; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{MIN()} that is specific
to one type for @var{A} and a different return type.
@xref{Min Intrinsic}.
@end ifset
@ifset familyF90
@node MinExponent Intrinsic
@subsubsection MinExponent Intrinsic
@cindex MinExponent intrinsic
@cindex intrinsics, MinExponent
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL MinExponent} to use this name for an
external procedure.
@node MinLoc Intrinsic
@subsubsection MinLoc Intrinsic
@cindex MinLoc intrinsic
@cindex intrinsics, MinLoc
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL MinLoc} to use this name for an
external procedure.
@node MinVal Intrinsic
@subsubsection MinVal Intrinsic
@cindex MinVal intrinsic
@cindex intrinsics, MinVal
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL MinVal} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node Mod Intrinsic
@subsubsection Mod Intrinsic
@cindex Mod intrinsic
@cindex intrinsics, Mod
@noindent
@example
Mod(@var{A}, @var{P})
@end example
@noindent
Mod: @code{INTEGER} or @code{REAL} function, the exact type being the result of cross-promoting the
types of all the arguments.
@noindent
@var{A}: @code{INTEGER} or @code{REAL}; scalar; INTENT(IN).
@noindent
@var{P}: @code{INTEGER} or @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns remainder calculated as:
@smallexample
@var{A} - (INT(@var{A} / @var{P}) * @var{P})
@end smallexample
@var{P} must not be zero.
@end ifset
@ifset familyF90
@node Modulo Intrinsic
@subsubsection Modulo Intrinsic
@cindex Modulo intrinsic
@cindex intrinsics, Modulo
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Modulo} to use this name for an
external procedure.
@end ifset
@ifset familyMIL
@node MvBits Intrinsic
@subsubsection MvBits Intrinsic
@cindex MvBits intrinsic
@cindex intrinsics, MvBits
@noindent
@example
CALL MvBits(@var{From}, @var{FromPos}, @var{Len}, @var{TO}, @var{ToPos})
@end example
@noindent
@var{From}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{FromPos}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Len}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{TO}: @code{INTEGER} with same @samp{KIND=} value as for @var{From}; scalar; INTENT(INOUT).
@noindent
@var{ToPos}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{mil}, @code{f90}, @code{vxt}.
@noindent
Description:
Moves @var{Len} bits from positions @var{FromPos} through
@samp{@var{FromPos}+@var{Len}-1} of @var{From} to positions @var{ToPos} through
@samp{@var{FromPos}+@var{Len}-1} of @var{TO}. The portion of argument
@var{TO} not affected by the movement of bits is unchanged. Arguments
@var{From} and @var{TO} are permitted to be the same numeric storage
unit. The values of @samp{@var{FromPos}+@var{Len}} and
@samp{@var{ToPos}+@var{Len}} must be less than or equal to
@samp{BIT_SIZE(@var{From})}.
@end ifset
@ifset familyF90
@node Nearest Intrinsic
@subsubsection Nearest Intrinsic
@cindex Nearest intrinsic
@cindex intrinsics, Nearest
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Nearest} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node NInt Intrinsic
@subsubsection NInt Intrinsic
@cindex NInt intrinsic
@cindex intrinsics, NInt
@noindent
@example
NInt(@var{A})
@end example
@noindent
NInt: @code{INTEGER(KIND=1)} function.
@noindent
@var{A}: @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns @var{A} with the fractional portion of its
magnitude eliminated by rounding to the nearest whole
number and with its sign preserved, converted
to type @code{INTEGER(KIND=1)}.
If @var{A} is type @code{COMPLEX}, its real part is
rounded and converted.
A fractional portion exactly equal to
@samp{.5} is rounded to the whole number that
is larger in magnitude.
(Also called ``Fortran round''.)
@xref{Int Intrinsic}, for how to convert, truncate to
whole number.
@xref{ANInt Intrinsic}, for how to round to nearest whole number
without converting.
@end ifset
@ifset familyMIL
@node Not Intrinsic
@subsubsection Not Intrinsic
@cindex Not intrinsic
@cindex intrinsics, Not
@noindent
@example
Not(@var{I})
@end example
@noindent
Not: @code{INTEGER} function, the @samp{KIND=} value of the type being that of argument @var{I}.
@noindent
@var{I}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{mil}, @code{f90}, @code{vxt}.
@noindent
Description:
Returns value resulting from boolean NOT of each bit
in @var{I}.
@end ifset
@ifset familyF2C
@node Or Intrinsic
@subsubsection Or Intrinsic
@cindex Or intrinsic
@cindex intrinsics, Or
@noindent
@example
Or(@var{I}, @var{J})
@end example
@noindent
Or: @code{INTEGER} or @code{LOGICAL} function, the exact type being the result of cross-promoting the
types of all the arguments.
@noindent
@var{I}: @code{INTEGER} or @code{LOGICAL}; scalar; INTENT(IN).
@noindent
@var{J}: @code{INTEGER} or @code{LOGICAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}.
@noindent
Description:
Returns value resulting from boolean OR of
pair of bits in each of @var{I} and @var{J}.
@end ifset
@ifset familyF90
@node Pack Intrinsic
@subsubsection Pack Intrinsic
@cindex Pack intrinsic
@cindex intrinsics, Pack
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Pack} to use this name for an
external procedure.
@end ifset
@ifset familyF2U
@node PError Intrinsic
@subsubsection PError Intrinsic
@cindex PError intrinsic
@cindex intrinsics, PError
@noindent
@example
CALL PError(@var{String})
@end example
@noindent
@var{String}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Prints (on the C @code{stderr} stream) a newline-terminated error
message corresponding to the last system error.
This is prefixed by @var{String}, a colon and a space.
See @code{perror(3)}.
@end ifset
@ifset familyF90
@node Precision Intrinsic
@subsubsection Precision Intrinsic
@cindex Precision intrinsic
@cindex intrinsics, Precision
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Precision} to use this name for an
external procedure.
@node Present Intrinsic
@subsubsection Present Intrinsic
@cindex Present intrinsic
@cindex intrinsics, Present
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Present} to use this name for an
external procedure.
@node Product Intrinsic
@subsubsection Product Intrinsic
@cindex Product intrinsic
@cindex intrinsics, Product
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Product} to use this name for an
external procedure.
@end ifset
@ifset familyVXT
@node QAbs Intrinsic
@subsubsection QAbs Intrinsic
@cindex QAbs intrinsic
@cindex intrinsics, QAbs
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QAbs} to use this name for an
external procedure.
@node QACos Intrinsic
@subsubsection QACos Intrinsic
@cindex QACos intrinsic
@cindex intrinsics, QACos
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QACos} to use this name for an
external procedure.
@node QACosD Intrinsic
@subsubsection QACosD Intrinsic
@cindex QACosD intrinsic
@cindex intrinsics, QACosD
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QACosD} to use this name for an
external procedure.
@node QASin Intrinsic
@subsubsection QASin Intrinsic
@cindex QASin intrinsic
@cindex intrinsics, QASin
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QASin} to use this name for an
external procedure.
@node QASinD Intrinsic
@subsubsection QASinD Intrinsic
@cindex QASinD intrinsic
@cindex intrinsics, QASinD
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QASinD} to use this name for an
external procedure.
@node QATan Intrinsic
@subsubsection QATan Intrinsic
@cindex QATan intrinsic
@cindex intrinsics, QATan
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QATan} to use this name for an
external procedure.
@node QATan2 Intrinsic
@subsubsection QATan2 Intrinsic
@cindex QATan2 intrinsic
@cindex intrinsics, QATan2
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QATan2} to use this name for an
external procedure.
@node QATan2D Intrinsic
@subsubsection QATan2D Intrinsic
@cindex QATan2D intrinsic
@cindex intrinsics, QATan2D
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QATan2D} to use this name for an
external procedure.
@node QATanD Intrinsic
@subsubsection QATanD Intrinsic
@cindex QATanD intrinsic
@cindex intrinsics, QATanD
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QATanD} to use this name for an
external procedure.
@node QCos Intrinsic
@subsubsection QCos Intrinsic
@cindex QCos intrinsic
@cindex intrinsics, QCos
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QCos} to use this name for an
external procedure.
@node QCosD Intrinsic
@subsubsection QCosD Intrinsic
@cindex QCosD intrinsic
@cindex intrinsics, QCosD
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QCosD} to use this name for an
external procedure.
@node QCosH Intrinsic
@subsubsection QCosH Intrinsic
@cindex QCosH intrinsic
@cindex intrinsics, QCosH
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QCosH} to use this name for an
external procedure.
@node QDiM Intrinsic
@subsubsection QDiM Intrinsic
@cindex QDiM intrinsic
@cindex intrinsics, QDiM
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QDiM} to use this name for an
external procedure.
@node QExp Intrinsic
@subsubsection QExp Intrinsic
@cindex QExp intrinsic
@cindex intrinsics, QExp
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QExp} to use this name for an
external procedure.
@node QExt Intrinsic
@subsubsection QExt Intrinsic
@cindex QExt intrinsic
@cindex intrinsics, QExt
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QExt} to use this name for an
external procedure.
@node QExtD Intrinsic
@subsubsection QExtD Intrinsic
@cindex QExtD intrinsic
@cindex intrinsics, QExtD
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QExtD} to use this name for an
external procedure.
@node QFloat Intrinsic
@subsubsection QFloat Intrinsic
@cindex QFloat intrinsic
@cindex intrinsics, QFloat
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QFloat} to use this name for an
external procedure.
@node QInt Intrinsic
@subsubsection QInt Intrinsic
@cindex QInt intrinsic
@cindex intrinsics, QInt
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QInt} to use this name for an
external procedure.
@node QLog Intrinsic
@subsubsection QLog Intrinsic
@cindex QLog intrinsic
@cindex intrinsics, QLog
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QLog} to use this name for an
external procedure.
@node QLog10 Intrinsic
@subsubsection QLog10 Intrinsic
@cindex QLog10 intrinsic
@cindex intrinsics, QLog10
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QLog10} to use this name for an
external procedure.
@node QMax1 Intrinsic
@subsubsection QMax1 Intrinsic
@cindex QMax1 intrinsic
@cindex intrinsics, QMax1
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QMax1} to use this name for an
external procedure.
@node QMin1 Intrinsic
@subsubsection QMin1 Intrinsic
@cindex QMin1 intrinsic
@cindex intrinsics, QMin1
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QMin1} to use this name for an
external procedure.
@node QMod Intrinsic
@subsubsection QMod Intrinsic
@cindex QMod intrinsic
@cindex intrinsics, QMod
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QMod} to use this name for an
external procedure.
@node QNInt Intrinsic
@subsubsection QNInt Intrinsic
@cindex QNInt intrinsic
@cindex intrinsics, QNInt
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QNInt} to use this name for an
external procedure.
@node QSin Intrinsic
@subsubsection QSin Intrinsic
@cindex QSin intrinsic
@cindex intrinsics, QSin
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QSin} to use this name for an
external procedure.
@node QSinD Intrinsic
@subsubsection QSinD Intrinsic
@cindex QSinD intrinsic
@cindex intrinsics, QSinD
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QSinD} to use this name for an
external procedure.
@node QSinH Intrinsic
@subsubsection QSinH Intrinsic
@cindex QSinH intrinsic
@cindex intrinsics, QSinH
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QSinH} to use this name for an
external procedure.
@node QSqRt Intrinsic
@subsubsection QSqRt Intrinsic
@cindex QSqRt intrinsic
@cindex intrinsics, QSqRt
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QSqRt} to use this name for an
external procedure.
@node QTan Intrinsic
@subsubsection QTan Intrinsic
@cindex QTan intrinsic
@cindex intrinsics, QTan
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QTan} to use this name for an
external procedure.
@node QTanD Intrinsic
@subsubsection QTanD Intrinsic
@cindex QTanD intrinsic
@cindex intrinsics, QTanD
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QTanD} to use this name for an
external procedure.
@node QTanH Intrinsic
@subsubsection QTanH Intrinsic
@cindex QTanH intrinsic
@cindex intrinsics, QTanH
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL QTanH} to use this name for an
external procedure.
@end ifset
@ifset familyF90
@node Radix Intrinsic
@subsubsection Radix Intrinsic
@cindex Radix intrinsic
@cindex intrinsics, Radix
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Radix} to use this name for an
external procedure.
@end ifset
@ifset familyF2U
@node Rand Intrinsic
@subsubsection Rand Intrinsic
@cindex Rand intrinsic
@cindex intrinsics, Rand
@noindent
@example
Rand(@var{Flag})
@end example
@noindent
Rand: @code{REAL(KIND=1)} function.
@noindent
@var{Flag}: @code{INTEGER}; OPTIONAL; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns a uniform quasi-random number between 0 and 1.
If @var{Flag} is 0, the next number in sequence is returned; if
@var{Flag} is 1, the generator is restarted by calling @samp{srand(0)};
if @var{Flag} has any other value, it is used as a new seed with
@code{srand}.
@xref{SRand Intrinsic}.
@emph{Note:} As typically implemented (by the routine of the same
name in the C library), this random number generator is a very poor
one, though the BSD and GNU libraries provide a much better
implementation than the `traditional' one.
On a different system you
almost certainly want to use something better.
@end ifset
@ifset familyF90
@node Random_Number Intrinsic
@subsubsection Random_Number Intrinsic
@cindex Random_Number intrinsic
@cindex intrinsics, Random_Number
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Random_Number} to use this name for an
external procedure.
@node Random_Seed Intrinsic
@subsubsection Random_Seed Intrinsic
@cindex Random_Seed intrinsic
@cindex intrinsics, Random_Seed
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Random_Seed} to use this name for an
external procedure.
@node Range Intrinsic
@subsubsection Range Intrinsic
@cindex Range intrinsic
@cindex intrinsics, Range
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Range} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node Real Intrinsic
@subsubsection Real Intrinsic
@cindex Real intrinsic
@cindex intrinsics, Real
@noindent
@example
Real(@var{A})
@end example
@noindent
Real: @code{REAL} function.
The exact type is @samp{REAL(KIND=1)} when argument @var{A} is
any type other than @code{COMPLEX}, or when it is @code{COMPLEX(KIND=1)}.
When @var{A} is any @code{COMPLEX} type other than @code{COMPLEX(KIND=1)},
this intrinsic is valid only when used as the argument to
@code{REAL()}, as explained below.
@noindent
@var{A}: @code{INTEGER}, @code{REAL}, or @code{COMPLEX}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Converts @var{A} to @code{REAL(KIND=1)}.
Use of @code{REAL()} with a @code{COMPLEX} argument
(other than @code{COMPLEX(KIND=1)}) is restricted to the following case:
@example
REAL(REAL(A))
@end example
@noindent
This expression converts the real part of A to
@code{REAL(KIND=1)}.
@xref{RealPart Intrinsic}, for information on a GNU Fortran
intrinsic that extracts the real part of an arbitrary
@code{COMPLEX} value.
@xref{REAL() and AIMAG() of Complex}, for more information.
@end ifset
@ifset familyGNU
@node RealPart Intrinsic
@subsubsection RealPart Intrinsic
@cindex RealPart intrinsic
@cindex intrinsics, RealPart
@noindent
@example
RealPart(@var{Z})
@end example
@noindent
RealPart: @code{REAL} function, the @samp{KIND=} value of the type being that of argument @var{Z}.
@noindent
@var{Z}: @code{COMPLEX}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{gnu}.
@noindent
Description:
The real part of @var{Z} is returned, without conversion.
@emph{Note:} The way to do this in standard Fortran 90
is @samp{REAL(@var{Z})}.
However, when, for example, @var{Z} is @code{COMPLEX(KIND=2)},
@samp{REAL(@var{Z})} means something different for some compilers
that are not true Fortran 90 compilers but offer some
extensions standardized by Fortran 90 (such as the
@code{DOUBLE COMPLEX} type, also known as @code{COMPLEX(KIND=2)}).
The advantage of @code{REALPART()} is that, while not necessarily
more or less portable than @code{REAL()}, it is more likely to
cause a compiler that doesn't support it to produce a diagnostic
than generate incorrect code.
@xref{REAL() and AIMAG() of Complex}, for more information.
@end ifset
@ifset familyF2U
@node Rename Intrinsic (subroutine)
@subsubsection Rename Intrinsic (subroutine)
@cindex Rename intrinsic
@cindex intrinsics, Rename
@noindent
@example
CALL Rename(@var{Path1}, @var{Path2}, @var{Status})
@end example
@noindent
@var{Path1}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{Path2}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{Status}: @code{INTEGER(KIND=1)}; OPTIONAL; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Renames the file @var{Path1} to @var{Path2}.
A null character (@samp{CHAR(0)}) marks the end of
the names in @var{Path1} and @var{Path2}---otherwise,
trailing blanks in @var{Path1} and @var{Path2} are ignored.
See @code{rename(2)}.
If the @var{Status} argument is supplied, it contains
0 on success or a nonzero error code upon return.
Some non-GNU implementations of Fortran provide this intrinsic as
only a function, not as a subroutine, or do not support the
(optional) @var{Status} argument.
For information on other intrinsics with the same name:
@xref{Rename Intrinsic (function)}.
@end ifset
@ifset familyBADU77
@node Rename Intrinsic (function)
@subsubsection Rename Intrinsic (function)
@cindex Rename intrinsic
@cindex intrinsics, Rename
@noindent
@example
Rename(@var{Path1}, @var{Path2})
@end example
@noindent
Rename: @code{INTEGER(KIND=1)} function.
@noindent
@var{Path1}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{Path2}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{badu77}.
@noindent
Description:
Renames the file @var{Path1} to @var{Path2}.
A null character (@samp{CHAR(0)}) marks the end of
the names in @var{Path1} and @var{Path2}---otherwise,
trailing blanks in @var{Path1} and @var{Path2} are ignored.
See @code{rename(2)}.
Returns 0 on success or a nonzero error code.
Due to the side effects performed by this intrinsic, the function
form is not recommended.
For information on other intrinsics with the same name:
@xref{Rename Intrinsic (subroutine)}.
@end ifset
@ifset familyF90
@node Repeat Intrinsic
@subsubsection Repeat Intrinsic
@cindex Repeat intrinsic
@cindex intrinsics, Repeat
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Repeat} to use this name for an
external procedure.
@node Reshape Intrinsic
@subsubsection Reshape Intrinsic
@cindex Reshape intrinsic
@cindex intrinsics, Reshape
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Reshape} to use this name for an
external procedure.
@node RRSpacing Intrinsic
@subsubsection RRSpacing Intrinsic
@cindex RRSpacing intrinsic
@cindex intrinsics, RRSpacing
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL RRSpacing} to use this name for an
external procedure.
@end ifset
@ifset familyF2C
@node RShift Intrinsic
@subsubsection RShift Intrinsic
@cindex RShift intrinsic
@cindex intrinsics, RShift
@noindent
@example
RShift(@var{I}, @var{Shift})
@end example
@noindent
RShift: @code{INTEGER} function, the @samp{KIND=} value of the type being that of argument @var{I}.
@noindent
@var{I}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Shift}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}.
@noindent
Description:
Returns @var{I} shifted to the right
@var{Shift} bits.
Although similar to the expression
@samp{@var{I}/(2**@var{Shift})}, there
are important differences.
For example, the sign of the result is
undefined.
Currently this intrinsic is defined assuming
the underlying representation of @var{I}
is as a two's-complement integer.
It is unclear at this point whether that
definition will apply when a different
representation is involved.
@xref{RShift Intrinsic}, for the inverse of this function.
@xref{IShft Intrinsic}, for information
on a more widely available right-shifting
intrinsic that is also more precisely defined.
@end ifset
@ifset familyF90
@node Scale Intrinsic
@subsubsection Scale Intrinsic
@cindex Scale intrinsic
@cindex intrinsics, Scale
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Scale} to use this name for an
external procedure.
@node Scan Intrinsic
@subsubsection Scan Intrinsic
@cindex Scan intrinsic
@cindex intrinsics, Scan
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Scan} to use this name for an
external procedure.
@end ifset
@ifset familyVXT
@node Secnds Intrinsic
@subsubsection Secnds Intrinsic
@cindex Secnds intrinsic
@cindex intrinsics, Secnds
@noindent
@example
Secnds(@var{T})
@end example
@noindent
Secnds: @code{REAL(KIND=1)} function.
@noindent
@var{T}: @code{REAL(KIND=1)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{vxt}.
@noindent
Description:
Returns the local time in seconds since midnight minus the value
@var{T}.
@cindex wraparound, timings
@cindex limits, timings
This values returned by this intrinsic
become numerically less than previous values
(they wrap around) during a single run of the
compiler program, under normal circumstances
(such as running through the midnight hour).
@end ifset
@ifset familyF2U
@node Second Intrinsic (function)
@subsubsection Second Intrinsic (function)
@cindex Second intrinsic
@cindex intrinsics, Second
@noindent
@example
Second()
@end example
@noindent
Second: @code{REAL(KIND=1)} function.
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns the process's runtime in seconds---the same value as the
UNIX function @code{etime} returns.
@cindex wraparound, timings
@cindex limits, timings
On some systems, the underlying timings are represented
using types with sufficiently small limits that overflows
(wraparounds) are possible, such as 32-bit types.
Therefore, the values returned by this intrinsic
might be, or become, negative,
or numerically less than previous values,
during a single run of the compiled program.
For information on other intrinsics with the same name:
@xref{Second Intrinsic (subroutine)}.
@node Second Intrinsic (subroutine)
@subsubsection Second Intrinsic (subroutine)
@cindex Second intrinsic
@cindex intrinsics, Second
@noindent
@example
CALL Second(@var{Seconds})
@end example
@noindent
@var{Seconds}: @code{REAL}; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns the process's runtime in seconds in @var{Seconds}---the same value
as the UNIX function @code{etime} returns.
@cindex wraparound, timings
@cindex limits, timings
On some systems, the underlying timings are represented
using types with sufficiently small limits that overflows
(wraparounds) are possible, such as 32-bit types.
Therefore, the values returned by this intrinsic
might be, or become, negative,
or numerically less than previous values,
during a single run of the compiled program.
This routine is known from Cray Fortran. @xref{CPU_Time Intrinsic},
for a standard equivalent.
For information on other intrinsics with the same name:
@xref{Second Intrinsic (function)}.
@end ifset
@ifset familyF90
@node Selected_Int_Kind Intrinsic
@subsubsection Selected_Int_Kind Intrinsic
@cindex Selected_Int_Kind intrinsic
@cindex intrinsics, Selected_Int_Kind
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Selected_Int_Kind} to use this name for an
external procedure.
@node Selected_Real_Kind Intrinsic
@subsubsection Selected_Real_Kind Intrinsic
@cindex Selected_Real_Kind intrinsic
@cindex intrinsics, Selected_Real_Kind
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Selected_Real_Kind} to use this name for an
external procedure.
@node Set_Exponent Intrinsic
@subsubsection Set_Exponent Intrinsic
@cindex Set_Exponent intrinsic
@cindex intrinsics, Set_Exponent
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Set_Exponent} to use this name for an
external procedure.
@node Shape Intrinsic
@subsubsection Shape Intrinsic
@cindex Shape intrinsic
@cindex intrinsics, Shape
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Shape} to use this name for an
external procedure.
@end ifset
@ifset familyF2U
@node Short Intrinsic
@subsubsection Short Intrinsic
@cindex Short intrinsic
@cindex intrinsics, Short
@noindent
@example
Short(@var{A})
@end example
@noindent
Short: @code{INTEGER(KIND=6)} function.
@noindent
@var{A}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns @var{A} with the fractional portion of its
magnitude truncated and its sign preserved, converted
to type @code{INTEGER(KIND=6)}.
If @var{A} is type @code{COMPLEX}, its real part
is truncated and converted, and its imaginary part is disregarded.
@xref{Int Intrinsic}.
The precise meaning of this intrinsic might change
in a future version of the GNU Fortran language,
as more is learned about how it is used.
@end ifset
@ifset familyF77
@node Sign Intrinsic
@subsubsection Sign Intrinsic
@cindex Sign intrinsic
@cindex intrinsics, Sign
@noindent
@example
Sign(@var{A}, @var{B})
@end example
@noindent
Sign: @code{INTEGER} or @code{REAL} function, the exact type being the result of cross-promoting the
types of all the arguments.
@noindent
@var{A}: @code{INTEGER} or @code{REAL}; scalar; INTENT(IN).
@noindent
@var{B}: @code{INTEGER} or @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns @samp{ABS(@var{A})*@var{s}}, where
@var{s} is +1 if @samp{@var{B}.GE.0},
-1 otherwise.
@xref{Abs Intrinsic}, for the function that returns
the magnitude of a value.
@end ifset
@ifset familyF2U
@node Signal Intrinsic (subroutine)
@subsubsection Signal Intrinsic (subroutine)
@cindex Signal intrinsic
@cindex intrinsics, Signal
@noindent
@example
CALL Signal(@var{Number}, @var{Handler}, @var{Status})
@end example
@noindent
@var{Number}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Handler}: Signal handler (@code{INTEGER FUNCTION} or @code{SUBROUTINE})
or dummy/global @code{INTEGER(KIND=1)} scalar.
@noindent
@var{Status}: @code{INTEGER(KIND=7)}; OPTIONAL; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
If @var{Handler} is a an @code{EXTERNAL} routine, arranges for it to be
invoked with a single integer argument (of system-dependent length)
when signal @var{Number} occurs.
If @var{Handler} is an integer, it can be
used to turn off handling of signal @var{Number} or revert to its default
action.
See @code{signal(2)}.
Note that @var{Handler} will be called using C conventions,
so the value of its argument in Fortran terms
Fortran terms is obtained by applying @code{%LOC()} (or @var{LOC()}) to it.
The value returned by @code{signal(2)} is written to @var{Status}, if
that argument is supplied.
Otherwise the return value is ignored.
Some non-GNU implementations of Fortran provide this intrinsic as
only a function, not as a subroutine, or do not support the
(optional) @var{Status} argument.
@emph{Warning:} Use of the @code{libf2c} run-time library function
@samp{signal_} directly
(such as via @samp{EXTERNAL SIGNAL})
requires use of the @code{%VAL()} construct
to pass an @code{INTEGER} value
(such as @samp{SIG_IGN} or @samp{SIG_DFL})
for the @var{Handler} argument.
However, while @samp{CALL SIGNAL(@var{signum}, %VAL(SIG_IGN))}
works when @samp{SIGNAL} is treated as an external procedure
(and resolves, at link time, to @code{libf2c}'s @samp{signal_} routine),
this construct is not valid when @samp{SIGNAL} is recognized
as the intrinsic of that name.
Therefore, for maximum portability and reliability,
code such references to the @samp{SIGNAL} facility as follows:
@smallexample
INTRINSIC SIGNAL
@dots{}
CALL SIGNAL(@var{signum}, SIG_IGN)
@end smallexample
@code{g77} will compile such a call correctly,
while other compilers will generally either do so as well
or reject the @samp{INTRINSIC SIGNAL} statement via a diagnostic,
allowing you to take appropriate action.
For information on other intrinsics with the same name:
@xref{Signal Intrinsic (function)}.
@end ifset
@ifset familyBADU77
@node Signal Intrinsic (function)
@subsubsection Signal Intrinsic (function)
@cindex Signal intrinsic
@cindex intrinsics, Signal
@noindent
@example
Signal(@var{Number}, @var{Handler})
@end example
@noindent
Signal: @code{INTEGER(KIND=7)} function.
@noindent
@var{Number}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Handler}: Signal handler (@code{INTEGER FUNCTION} or @code{SUBROUTINE})
or dummy/global @code{INTEGER(KIND=1)} scalar.
@noindent
Intrinsic groups: @code{badu77}.
@noindent
Description:
If @var{Handler} is a an @code{EXTERNAL} routine, arranges for it to be
invoked with a single integer argument (of system-dependent length)
when signal @var{Number} occurs.
If @var{Handler} is an integer, it can be
used to turn off handling of signal @var{Number} or revert to its default
action.
See @code{signal(2)}.
Note that @var{Handler} will be called using C conventions,
so the value of its argument in Fortran terms
is obtained by applying @code{%LOC()} (or @var{LOC()}) to it.
The value returned by @code{signal(2)} is returned.
Due to the side effects performed by this intrinsic, the function
form is not recommended.
@emph{Warning:} If the returned value is stored in
an @code{INTEGER(KIND=1)} (default @code{INTEGER}) argument,
truncation of the original return value occurs on some systems
(such as Alphas, which have 64-bit pointers but 32-bit default integers),
with no warning issued by @code{g77} under normal circumstances.
Therefore, the following code fragment might silently fail on
some systems:
@smallexample
INTEGER RTN
EXTERNAL MYHNDL
RTN = SIGNAL(@var{signum}, MYHNDL)
@dots{}
! Restore original handler:
RTN = SIGNAL(@var{signum}, RTN)
@end smallexample
The reason for the failure is that @samp{RTN} might not hold
all the information on the original handler for the signal,
thus restoring an invalid handler.
This bug could manifest itself as a spurious run-time failure
at an arbitrary point later during the program's execution,
for example.
@emph{Warning:} Use of the @code{libf2c} run-time library function
@samp{signal_} directly
(such as via @samp{EXTERNAL SIGNAL})
requires use of the @code{%VAL()} construct
to pass an @code{INTEGER} value
(such as @samp{SIG_IGN} or @samp{SIG_DFL})
for the @var{Handler} argument.
However, while @samp{RTN = SIGNAL(@var{signum}, %VAL(SIG_IGN))}
works when @samp{SIGNAL} is treated as an external procedure
(and resolves, at link time, to @code{libf2c}'s @samp{signal_} routine),
this construct is not valid when @samp{SIGNAL} is recognized
as the intrinsic of that name.
Therefore, for maximum portability and reliability,
code such references to the @samp{SIGNAL} facility as follows:
@smallexample
INTRINSIC SIGNAL
@dots{}
RTN = SIGNAL(@var{signum}, SIG_IGN)
@end smallexample
@code{g77} will compile such a call correctly,
while other compilers will generally either do so as well
or reject the @samp{INTRINSIC SIGNAL} statement via a diagnostic,
allowing you to take appropriate action.
For information on other intrinsics with the same name:
@xref{Signal Intrinsic (subroutine)}.
@end ifset
@ifset familyF77
@node Sin Intrinsic
@subsubsection Sin Intrinsic
@cindex Sin intrinsic
@cindex intrinsics, Sin
@noindent
@example
Sin(@var{X})
@end example
@noindent
Sin: @code{REAL} or @code{COMPLEX} function, the exact type being that of argument @var{X}.
@noindent
@var{X}: @code{REAL} or @code{COMPLEX}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns the sine of @var{X}, an angle measured
in radians.
@xref{ASin Intrinsic}, for the inverse of this function.
@end ifset
@ifset familyVXT
@node SinD Intrinsic
@subsubsection SinD Intrinsic
@cindex SinD intrinsic
@cindex intrinsics, SinD
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL SinD} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node SinH Intrinsic
@subsubsection SinH Intrinsic
@cindex SinH intrinsic
@cindex intrinsics, SinH
@noindent
@example
SinH(@var{X})
@end example
@noindent
SinH: @code{REAL} function, the @samp{KIND=} value of the type being that of argument @var{X}.
@noindent
@var{X}: @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns the hyperbolic sine of @var{X}.
@end ifset
@ifset familyF2U
@node Sleep Intrinsic
@subsubsection Sleep Intrinsic
@cindex Sleep intrinsic
@cindex intrinsics, Sleep
@noindent
@example
CALL Sleep(@var{Seconds})
@end example
@noindent
@var{Seconds}: @code{INTEGER(KIND=1)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Causes the process to pause for @var{Seconds} seconds.
See @code{sleep(2)}.
@end ifset
@ifset familyF77
@node Sngl Intrinsic
@subsubsection Sngl Intrinsic
@cindex Sngl intrinsic
@cindex intrinsics, Sngl
@noindent
@example
Sngl(@var{A})
@end example
@noindent
Sngl: @code{REAL(KIND=1)} function.
@noindent
@var{A}: @code{REAL(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Archaic form of @code{REAL()} that is specific
to one type for @var{A}.
@xref{Real Intrinsic}.
@end ifset
@ifset familyVXT
@node SnglQ Intrinsic
@subsubsection SnglQ Intrinsic
@cindex SnglQ intrinsic
@cindex intrinsics, SnglQ
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL SnglQ} to use this name for an
external procedure.
@end ifset
@ifset familyF90
@node Spacing Intrinsic
@subsubsection Spacing Intrinsic
@cindex Spacing intrinsic
@cindex intrinsics, Spacing
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Spacing} to use this name for an
external procedure.
@node Spread Intrinsic
@subsubsection Spread Intrinsic
@cindex Spread intrinsic
@cindex intrinsics, Spread
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Spread} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node SqRt Intrinsic
@subsubsection SqRt Intrinsic
@cindex SqRt intrinsic
@cindex intrinsics, SqRt
@noindent
@example
SqRt(@var{X})
@end example
@noindent
SqRt: @code{REAL} or @code{COMPLEX} function, the exact type being that of argument @var{X}.
@noindent
@var{X}: @code{REAL} or @code{COMPLEX}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns the square root of @var{X}, which must
not be negative.
To calculate and represent the square root of a negative
number, complex arithmetic must be used.
For example, @samp{SQRT(COMPLEX(@var{X}))}.
The inverse of this function is @samp{SQRT(@var{X}) * SQRT(@var{X})}.
@end ifset
@ifset familyF2U
@node SRand Intrinsic
@subsubsection SRand Intrinsic
@cindex SRand intrinsic
@cindex intrinsics, SRand
@noindent
@example
CALL SRand(@var{Seed})
@end example
@noindent
@var{Seed}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Reinitializes the generator with the seed in @var{Seed}.
@xref{IRand Intrinsic}.
@xref{Rand Intrinsic}.
@node Stat Intrinsic (subroutine)
@subsubsection Stat Intrinsic (subroutine)
@cindex Stat intrinsic
@cindex intrinsics, Stat
@noindent
@example
CALL Stat(@var{File}, @var{SArray}, @var{Status})
@end example
@noindent
@var{File}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{SArray}: @code{INTEGER(KIND=1)}; DIMENSION(13); INTENT(OUT).
@noindent
@var{Status}: @code{INTEGER(KIND=1)}; OPTIONAL; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Obtains data about the given file @var{File} and places them in the array
@var{SArray}.
A null character (@samp{CHAR(0)}) marks the end of
the name in @var{File}---otherwise,
trailing blanks in @var{File} are ignored.
The values in this array are extracted from the
@code{stat} structure as returned by @code{fstat(2)} q.v., as follows:
@enumerate
@item
Device ID
@item
Inode number
@item
File mode
@item
Number of links
@item
Owner's uid
@item
Owner's gid
@item
ID of device containing directory entry for file
(0 if not available)
@item
File size (bytes)
@item
Last access time
@item
Last modification time
@item
Last file status change time
@item
Preferred I/O block size (-1 if not available)
@item
Number of blocks allocated (-1 if not available)
@end enumerate
Not all these elements are relevant on all systems.
If an element is not relevant, it is returned as 0.
If the @var{Status} argument is supplied, it contains
0 on success or a nonzero error code upon return.
Some non-GNU implementations of Fortran provide this intrinsic as
only a function, not as a subroutine, or do not support the
(optional) @var{Status} argument.
For information on other intrinsics with the same name:
@xref{Stat Intrinsic (function)}.
@node Stat Intrinsic (function)
@subsubsection Stat Intrinsic (function)
@cindex Stat intrinsic
@cindex intrinsics, Stat
@noindent
@example
Stat(@var{File}, @var{SArray})
@end example
@noindent
Stat: @code{INTEGER(KIND=1)} function.
@noindent
@var{File}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{SArray}: @code{INTEGER(KIND=1)}; DIMENSION(13); INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Obtains data about the given file @var{File} and places them in the array
@var{SArray}.
A null character (@samp{CHAR(0)}) marks the end of
the name in @var{File}---otherwise,
trailing blanks in @var{File} are ignored.
The values in this array are extracted from the
@code{stat} structure as returned by @code{fstat(2)} q.v., as follows:
@enumerate
@item
Device ID
@item
Inode number
@item
File mode
@item
Number of links
@item
Owner's uid
@item
Owner's gid
@item
ID of device containing directory entry for file
(0 if not available)
@item
File size (bytes)
@item
Last access time
@item
Last modification time
@item
Last file status change time
@item
Preferred I/O block size (-1 if not available)
@item
Number of blocks allocated (-1 if not available)
@end enumerate
Not all these elements are relevant on all systems.
If an element is not relevant, it is returned as 0.
Returns 0 on success or a nonzero error code.
For information on other intrinsics with the same name:
@xref{Stat Intrinsic (subroutine)}.
@end ifset
@ifset familyF90
@node Sum Intrinsic
@subsubsection Sum Intrinsic
@cindex Sum intrinsic
@cindex intrinsics, Sum
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Sum} to use this name for an
external procedure.
@end ifset
@ifset familyF2U
@node SymLnk Intrinsic (subroutine)
@subsubsection SymLnk Intrinsic (subroutine)
@cindex SymLnk intrinsic
@cindex intrinsics, SymLnk
@noindent
@example
CALL SymLnk(@var{Path1}, @var{Path2}, @var{Status})
@end example
@noindent
@var{Path1}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{Path2}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{Status}: @code{INTEGER(KIND=1)}; OPTIONAL; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Makes a symbolic link from file @var{Path1} to @var{Path2}.
A null character (@samp{CHAR(0)}) marks the end of
the names in @var{Path1} and @var{Path2}---otherwise,
trailing blanks in @var{Path1} and @var{Path2} are ignored.
If the @var{Status} argument is supplied, it contains
0 on success or a nonzero error code upon return
(@code{ENOSYS} if the system does not provide @code{symlink(2)}).
Some non-GNU implementations of Fortran provide this intrinsic as
only a function, not as a subroutine, or do not support the
(optional) @var{Status} argument.
For information on other intrinsics with the same name:
@xref{SymLnk Intrinsic (function)}.
@end ifset
@ifset familyBADU77
@node SymLnk Intrinsic (function)
@subsubsection SymLnk Intrinsic (function)
@cindex SymLnk intrinsic
@cindex intrinsics, SymLnk
@noindent
@example
SymLnk(@var{Path1}, @var{Path2})
@end example
@noindent
SymLnk: @code{INTEGER(KIND=1)} function.
@noindent
@var{Path1}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{Path2}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{badu77}.
@noindent
Description:
Makes a symbolic link from file @var{Path1} to @var{Path2}.
A null character (@samp{CHAR(0)}) marks the end of
the names in @var{Path1} and @var{Path2}---otherwise,
trailing blanks in @var{Path1} and @var{Path2} are ignored.
Returns 0 on success or a nonzero error code
(@code{ENOSYS} if the system does not provide @code{symlink(2)}).
Due to the side effects performed by this intrinsic, the function
form is not recommended.
For information on other intrinsics with the same name:
@xref{SymLnk Intrinsic (subroutine)}.
@end ifset
@ifset familyF2U
@node System Intrinsic (subroutine)
@subsubsection System Intrinsic (subroutine)
@cindex System intrinsic
@cindex intrinsics, System
@noindent
@example
CALL System(@var{Command}, @var{Status})
@end example
@noindent
@var{Command}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{Status}: @code{INTEGER(KIND=1)}; OPTIONAL; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Passes the command @var{Command} to a shell (see @code{system(3)}).
If argument @var{Status} is present, it contains the value returned by
@code{system(3)}, presumably 0 if the shell command succeeded.
Note that which shell is used to invoke the command is system-dependent
and environment-dependent.
Some non-GNU implementations of Fortran provide this intrinsic as
only a function, not as a subroutine, or do not support the
(optional) @var{Status} argument.
For information on other intrinsics with the same name:
@xref{System Intrinsic (function)}.
@end ifset
@ifset familyBADU77
@node System Intrinsic (function)
@subsubsection System Intrinsic (function)
@cindex System intrinsic
@cindex intrinsics, System
@noindent
@example
System(@var{Command})
@end example
@noindent
System: @code{INTEGER(KIND=1)} function.
@noindent
@var{Command}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{badu77}.
@noindent
Description:
Passes the command @var{Command} to a shell (see @code{system(3)}).
Returns the value returned by
@code{system(3)}, presumably 0 if the shell command succeeded.
Note that which shell is used to invoke the command is system-dependent
and environment-dependent.
Due to the side effects performed by this intrinsic, the function
form is not recommended.
However, the function form can be valid in cases where the
actual side effects performed by the call are unimportant to
the application.
For example, on a UNIX system, @samp{SAME = SYSTEM('cmp a b')}
does not perform any side effects likely to be important to the
program, so the programmer would not care if the actual system
call (and invocation of @code{cmp}) was optimized away in a situation
where the return value could be determined otherwise, or was not
actually needed (@samp{SAME} not actually referenced after the
sample assignment statement).
For information on other intrinsics with the same name:
@xref{System Intrinsic (subroutine)}.
@end ifset
@ifset familyF90
@node System_Clock Intrinsic
@subsubsection System_Clock Intrinsic
@cindex System_Clock intrinsic
@cindex intrinsics, System_Clock
@noindent
@example
CALL System_Clock(@var{Count}, @var{Rate}, @var{Max})
@end example
@noindent
@var{Count}: @code{INTEGER(KIND=1)}; scalar; INTENT(OUT).
@noindent
@var{Rate}: @code{INTEGER(KIND=1)}; OPTIONAL; scalar; INTENT(OUT).
@noindent
@var{Max}: @code{INTEGER(KIND=1)}; OPTIONAL; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{f90}.
@noindent
Description:
Returns in @var{Count} the current value of the system clock; this is
the value returned by the UNIX function @code{times(2)}
in this implementation, but
isn't in general.
@var{Rate} is the number of clock ticks per second and
@var{Max} is the maximum value this can take, which isn't very useful
in this implementation since it's just the maximum C @code{unsigned
int} value.
@cindex wraparound, timings
@cindex limits, timings
On some systems, the underlying timings are represented
using types with sufficiently small limits that overflows
(wraparounds) are possible, such as 32-bit types.
Therefore, the values returned by this intrinsic
might be, or become, negative,
or numerically less than previous values,
during a single run of the compiled program.
@end ifset
@ifset familyF77
@node Tan Intrinsic
@subsubsection Tan Intrinsic
@cindex Tan intrinsic
@cindex intrinsics, Tan
@noindent
@example
Tan(@var{X})
@end example
@noindent
Tan: @code{REAL} function, the @samp{KIND=} value of the type being that of argument @var{X}.
@noindent
@var{X}: @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns the tangent of @var{X}, an angle measured
in radians.
@xref{ATan Intrinsic}, for the inverse of this function.
@end ifset
@ifset familyVXT
@node TanD Intrinsic
@subsubsection TanD Intrinsic
@cindex TanD intrinsic
@cindex intrinsics, TanD
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL TanD} to use this name for an
external procedure.
@end ifset
@ifset familyF77
@node TanH Intrinsic
@subsubsection TanH Intrinsic
@cindex TanH intrinsic
@cindex intrinsics, TanH
@noindent
@example
TanH(@var{X})
@end example
@noindent
TanH: @code{REAL} function, the @samp{KIND=} value of the type being that of argument @var{X}.
@noindent
@var{X}: @code{REAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: (standard FORTRAN 77).
@noindent
Description:
Returns the hyperbolic tangent of @var{X}.
@end ifset
@ifset familyF2U
@node Time Intrinsic (UNIX)
@subsubsection Time Intrinsic (UNIX)
@cindex Time intrinsic
@cindex intrinsics, Time
@noindent
@example
Time()
@end example
@noindent
Time: @code{INTEGER(KIND=1)} function.
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns the current time encoded as an integer
(in the manner of the UNIX function @code{time(3)}).
This value is suitable for passing to @code{CTIME},
@code{GMTIME}, and @code{LTIME}.
@cindex wraparound, timings
@cindex limits, timings
This intrinsic is not fully portable, such as to systems
with 32-bit @code{INTEGER} types but supporting times
wider than 32 bits.
Therefore, the values returned by this intrinsic
might be, or become, negative,
or numerically less than previous values,
during a single run of the compiled program.
@xref{Time8 Intrinsic}, for information on a
similar intrinsic that might be portable to more
GNU Fortran implementations, though to fewer
Fortran compilers.
For information on other intrinsics with the same name:
@xref{Time Intrinsic (VXT)}.
@end ifset
@ifset familyVXT
@node Time Intrinsic (VXT)
@subsubsection Time Intrinsic (VXT)
@cindex Time intrinsic
@cindex intrinsics, Time
@noindent
@example
CALL Time(@var{Time})
@end example
@noindent
@var{Time}: @code{CHARACTER*8}; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{vxt}.
@noindent
Description:
Returns in @var{Time} a character representation of the current time as
obtained from @code{ctime(3)}.
@cindex Y10K compliance
@cindex Year 10000 compliance
@cindex wraparound, Y10K
@cindex limits, Y10K
Programs making use of this intrinsic
might not be Year 10000 (Y10K) compliant.
For example, the date might appear,
to such programs, to wrap around
(change from a larger value to a smaller one)
as of the Year 10000.
@xref{FDate Intrinsic (subroutine)}, for an equivalent routine.
For information on other intrinsics with the same name:
@xref{Time Intrinsic (UNIX)}.
@end ifset
@ifset familyF2U
@node Time8 Intrinsic
@subsubsection Time8 Intrinsic
@cindex Time8 intrinsic
@cindex intrinsics, Time8
@noindent
@example
Time8()
@end example
@noindent
Time8: @code{INTEGER(KIND=2)} function.
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns the current time encoded as a long integer
(in the manner of the UNIX function @code{time(3)}).
This value is suitable for passing to @code{CTIME},
@code{GMTIME}, and @code{LTIME}.
@cindex wraparound, timings
@cindex limits, timings
@emph{Warning:} this intrinsic does not increase the range
of the timing values over that returned by @code{time(3)}.
On a system with a 32-bit @code{time(3)},
@code{TIME8} will return a 32-bit value,
even though converted to an @samp{INTEGER(KIND=2)} value.
That means overflows of the 32-bit value can still occur.
Therefore, the values returned by this intrinsic
might be, or become, negative,
or numerically less than previous values,
during a single run of the compiled program.
No Fortran implementations other than GNU Fortran are
known to support this intrinsic at the time of this
writing.
@xref{Time Intrinsic (UNIX)}, for information on a
similar intrinsic that might be portable to more Fortran
compilers, though to fewer GNU Fortran implementations.
@end ifset
@ifset familyF90
@node Tiny Intrinsic
@subsubsection Tiny Intrinsic
@cindex Tiny intrinsic
@cindex intrinsics, Tiny
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Tiny} to use this name for an
external procedure.
@node Transfer Intrinsic
@subsubsection Transfer Intrinsic
@cindex Transfer intrinsic
@cindex intrinsics, Transfer
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Transfer} to use this name for an
external procedure.
@node Transpose Intrinsic
@subsubsection Transpose Intrinsic
@cindex Transpose intrinsic
@cindex intrinsics, Transpose
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Transpose} to use this name for an
external procedure.
@node Trim Intrinsic
@subsubsection Trim Intrinsic
@cindex Trim intrinsic
@cindex intrinsics, Trim
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Trim} to use this name for an
external procedure.
@end ifset
@ifset familyF2U
@node TtyNam Intrinsic (subroutine)
@subsubsection TtyNam Intrinsic (subroutine)
@cindex TtyNam intrinsic
@cindex intrinsics, TtyNam
@noindent
@example
CALL TtyNam(@var{Unit}, @var{Name})
@end example
@noindent
@var{Unit}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Name}: @code{CHARACTER}; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Sets @var{Name} to the name of the terminal device open on logical unit
@var{Unit} or to a blank string if @var{Unit} is not connected to a
terminal.
Some non-GNU implementations of Fortran provide this intrinsic as
only a function, not as a subroutine.
For information on other intrinsics with the same name:
@xref{TtyNam Intrinsic (function)}.
@node TtyNam Intrinsic (function)
@subsubsection TtyNam Intrinsic (function)
@cindex TtyNam intrinsic
@cindex intrinsics, TtyNam
@noindent
@example
TtyNam(@var{Unit})
@end example
@noindent
TtyNam: @code{CHARACTER*(*)} function.
@noindent
@var{Unit}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Returns the name of the terminal device open on logical unit
@var{Unit} or a blank string if @var{Unit} is not connected to a
terminal.
For information on other intrinsics with the same name:
@xref{TtyNam Intrinsic (subroutine)}.
@end ifset
@ifset familyF90
@node UBound Intrinsic
@subsubsection UBound Intrinsic
@cindex UBound intrinsic
@cindex intrinsics, UBound
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL UBound} to use this name for an
external procedure.
@end ifset
@ifset familyF2U
@node UMask Intrinsic (subroutine)
@subsubsection UMask Intrinsic (subroutine)
@cindex UMask intrinsic
@cindex intrinsics, UMask
@noindent
@example
CALL UMask(@var{Mask}, @var{Old})
@end example
@noindent
@var{Mask}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
@var{Old}: @code{INTEGER(KIND=1)}; OPTIONAL; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Sets the file creation mask to @var{Mask} and returns the old value in
argument @var{Old} if it is supplied.
See @code{umask(2)}.
Some non-GNU implementations of Fortran provide this intrinsic as
only a function, not as a subroutine.
For information on other intrinsics with the same name:
@xref{UMask Intrinsic (function)}.
@end ifset
@ifset familyBADU77
@node UMask Intrinsic (function)
@subsubsection UMask Intrinsic (function)
@cindex UMask intrinsic
@cindex intrinsics, UMask
@noindent
@example
UMask(@var{Mask})
@end example
@noindent
UMask: @code{INTEGER(KIND=1)} function.
@noindent
@var{Mask}: @code{INTEGER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{badu77}.
@noindent
Description:
Sets the file creation mask to @var{Mask} and returns the old value.
See @code{umask(2)}.
Due to the side effects performed by this intrinsic, the function
form is not recommended.
For information on other intrinsics with the same name:
@xref{UMask Intrinsic (subroutine)}.
@end ifset
@ifset familyF2U
@node Unlink Intrinsic (subroutine)
@subsubsection Unlink Intrinsic (subroutine)
@cindex Unlink intrinsic
@cindex intrinsics, Unlink
@noindent
@example
CALL Unlink(@var{File}, @var{Status})
@end example
@noindent
@var{File}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
@var{Status}: @code{INTEGER(KIND=1)}; OPTIONAL; scalar; INTENT(OUT).
@noindent
Intrinsic groups: @code{unix}.
@noindent
Description:
Unlink the file @var{File}.
A null character (@samp{CHAR(0)}) marks the end of
the name in @var{File}---otherwise,
trailing blanks in @var{File} are ignored.
If the @var{Status} argument is supplied, it contains
0 on success or a nonzero error code upon return.
See @code{unlink(2)}.
Some non-GNU implementations of Fortran provide this intrinsic as
only a function, not as a subroutine, or do not support the
(optional) @var{Status} argument.
For information on other intrinsics with the same name:
@xref{Unlink Intrinsic (function)}.
@end ifset
@ifset familyBADU77
@node Unlink Intrinsic (function)
@subsubsection Unlink Intrinsic (function)
@cindex Unlink intrinsic
@cindex intrinsics, Unlink
@noindent
@example
Unlink(@var{File})
@end example
@noindent
Unlink: @code{INTEGER(KIND=1)} function.
@noindent
@var{File}: @code{CHARACTER}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{badu77}.
@noindent
Description:
Unlink the file @var{File}.
A null character (@samp{CHAR(0)}) marks the end of
the name in @var{File}---otherwise,
trailing blanks in @var{File} are ignored.
Returns 0 on success or a nonzero error code.
See @code{unlink(2)}.
Due to the side effects performed by this intrinsic, the function
form is not recommended.
For information on other intrinsics with the same name:
@xref{Unlink Intrinsic (subroutine)}.
@end ifset
@ifset familyF90
@node Unpack Intrinsic
@subsubsection Unpack Intrinsic
@cindex Unpack intrinsic
@cindex intrinsics, Unpack
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Unpack} to use this name for an
external procedure.
@node Verify Intrinsic
@subsubsection Verify Intrinsic
@cindex Verify intrinsic
@cindex intrinsics, Verify
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL Verify} to use this name for an
external procedure.
@end ifset
@ifset familyF2C
@node XOr Intrinsic
@subsubsection XOr Intrinsic
@cindex XOr intrinsic
@cindex intrinsics, XOr
@noindent
@example
XOr(@var{I}, @var{J})
@end example
@noindent
XOr: @code{INTEGER} or @code{LOGICAL} function, the exact type being the result of cross-promoting the
types of all the arguments.
@noindent
@var{I}: @code{INTEGER} or @code{LOGICAL}; scalar; INTENT(IN).
@noindent
@var{J}: @code{INTEGER} or @code{LOGICAL}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}.
@noindent
Description:
Returns value resulting from boolean exclusive-OR of
pair of bits in each of @var{I} and @var{J}.
@node ZAbs Intrinsic
@subsubsection ZAbs Intrinsic
@cindex ZAbs intrinsic
@cindex intrinsics, ZAbs
@noindent
@example
ZAbs(@var{A})
@end example
@noindent
ZAbs: @code{REAL(KIND=2)} function.
@noindent
@var{A}: @code{COMPLEX(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}.
@noindent
Description:
Archaic form of @code{ABS()} that is specific
to one type for @var{A}.
@xref{Abs Intrinsic}.
@node ZCos Intrinsic
@subsubsection ZCos Intrinsic
@cindex ZCos intrinsic
@cindex intrinsics, ZCos
@noindent
@example
ZCos(@var{X})
@end example
@noindent
ZCos: @code{COMPLEX(KIND=2)} function.
@noindent
@var{X}: @code{COMPLEX(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}.
@noindent
Description:
Archaic form of @code{COS()} that is specific
to one type for @var{X}.
@xref{Cos Intrinsic}.
@node ZExp Intrinsic
@subsubsection ZExp Intrinsic
@cindex ZExp intrinsic
@cindex intrinsics, ZExp
@noindent
@example
ZExp(@var{X})
@end example
@noindent
ZExp: @code{COMPLEX(KIND=2)} function.
@noindent
@var{X}: @code{COMPLEX(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}.
@noindent
Description:
Archaic form of @code{EXP()} that is specific
to one type for @var{X}.
@xref{Exp Intrinsic}.
@end ifset
@ifset familyVXT
@node ZExt Intrinsic
@subsubsection ZExt Intrinsic
@cindex ZExt intrinsic
@cindex intrinsics, ZExt
This intrinsic is not yet implemented.
The name is, however, reserved as an intrinsic.
Use @samp{EXTERNAL ZExt} to use this name for an
external procedure.
@end ifset
@ifset familyF2C
@node ZLog Intrinsic
@subsubsection ZLog Intrinsic
@cindex ZLog intrinsic
@cindex intrinsics, ZLog
@noindent
@example
ZLog(@var{X})
@end example
@noindent
ZLog: @code{COMPLEX(KIND=2)} function.
@noindent
@var{X}: @code{COMPLEX(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}.
@noindent
Description:
Archaic form of @code{LOG()} that is specific
to one type for @var{X}.
@xref{Log Intrinsic}.
@node ZSin Intrinsic
@subsubsection ZSin Intrinsic
@cindex ZSin intrinsic
@cindex intrinsics, ZSin
@noindent
@example
ZSin(@var{X})
@end example
@noindent
ZSin: @code{COMPLEX(KIND=2)} function.
@noindent
@var{X}: @code{COMPLEX(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}.
@noindent
Description:
Archaic form of @code{SIN()} that is specific
to one type for @var{X}.
@xref{Sin Intrinsic}.
@node ZSqRt Intrinsic
@subsubsection ZSqRt Intrinsic
@cindex ZSqRt intrinsic
@cindex intrinsics, ZSqRt
@noindent
@example
ZSqRt(@var{X})
@end example
@noindent
ZSqRt: @code{COMPLEX(KIND=2)} function.
@noindent
@var{X}: @code{COMPLEX(KIND=2)}; scalar; INTENT(IN).
@noindent
Intrinsic groups: @code{f2c}.
@noindent
Description:
Archaic form of @code{SQRT()} that is specific
to one type for @var{X}.
@xref{SqRt Intrinsic}.
@end ifset