Intel® Fortran Libraries Reference Copyright©1996-2003IntelCorporation All Rights Reserved Issued in U.S.A. DocumentNumber:FWL-LIB-710-02 Information in this document is provided in connection with Intel products. No license, express or implied, by estoppel or otherwise, to any intellectual property rights is granted by this document. EXCEPT AS PROVIDED IN INTEL’S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER, AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPY- RIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT. Intel products are not intended for use in medical, life saving, or life sustain- ing applications. This Intel® Fortran Libraries Reference as well as the software described in it is furnished under license and may only be used or copied in accordance with the terms of the license. The information in this manual is furnished for informational use only, is subject to change with- out notice, and should not be construed as a commitment by Intel Corporation. Intel Corporation assumes no responsibility or liability for any errors or inaccuracies that may appear in this document or any software that may be provided in association with this document. Designers must not rely on the absence or characteristics of any features or instructions marked "reserved" or "undefined." Intel reserves these for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them. Intel SpeedStep, Intel Thread Checker, Celeron, Dialogic, i386, i486, iCOMP, Intel, Intel logo, Intel386, Intel486, Intel740, IntelDX2, IntelDX4, IntelSX2, Intel Inside, Intel Inside logo, Intel NetBurst, Intel NetStructure, Intel Xeon, Intel Centrino, Intel XScale, Itanium, MMX, MMX logo, Pentium, Pentium II Xeon, Pentium III Xeon, Intel Pentium M, and VTune are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. * Other names and brands may be claimed as the property of others. Copyright © Intel Corporation 1996 - 2003. Portions Copyright © 2001 Compaq Information Technologies Group, L.P. ii Contents Chapter About This Manual Related Publications............................................................. xxiii Notational Conventions......................................................... xxiv Chapter 1 Intrinsic Procedures Overview of IntrinsicProcedures........................................... 1-1 Availability of IntrinsicProcedures......................................... 1-2 IntrinsicSubroutines and Functions ...................................... 1-2 IntrinsicSubroutines ......................................................... 1-3 Elemental and Nonelemental Subroutines........................ 1-3 IntrinsicFunctions............................................................. 1-3 Genericand SpecificIntrinsicFunction Names ........... 1-4 Elemental Functions..................................................... 1-5 Inquiry Functions.......................................................... 1-5 Transformational Functions.......................................... 1-6 INTRINSIC Attribute and Statement ...................................... 1-7 Documenting Intrinsic Procedures.................................... 1-7 IntrinsicProcedures as Actual Arguments ........................ 1-7 Nonstandard IntrinsicProcedures ......................................... 1-9 Data Representation Models ............................................... 1-10 Data Representation Model Intrinsics ............................. 1-10 The Bit Model.................................................................. 1-11 The Integer Number System Model................................ 1-11 iii Intel Fortran Libraries Reference The Real Number System Model.................................... 1-12 Functional Categories of Intrinsic Procedures ..................... 1-13 Genericand SpecificIntrinsicSummary.............................. 1-14 Summary of Genericand SpecificIntrinsicNames......... 1-15 Intrinsic Procedure Specifications...................................... 1-139 ABS(A) .......................................................................... 1-139 ACHAR(I) ...................................................................... 1-140 ACOS(X) ....................................................................... 1-141 ACOSD(X) .................................................................... 1-142 ACOSH(X) .................................................................... 1-143 ADJUSTL(STRING) ...................................................... 1-144 ADJUSTR(STRING) ..................................................... 1-145 AIMAG(Z)...................................................................... 1-146 AINT(A, KIND) .............................................................. 1-147 ALL(MASK, DIM) .......................................................... 1-148 ALLOCATED(ARRAY) .................................................. 1-150 AND(I, J) ....................................................................... 1-151 ANINT(A, KIND)............................................................ 1-152 ANY(MASK, DIM) ......................................................... 1-153 ASIN(X)......................................................................... 1-155 ASIND(X) ...................................................................... 1-156 ASINH(X) ...................................................................... 1-157 ASSOCIATED(POINTER, TARGET) ............................ 1-158 ATAN(X) ........................................................................ 1-160 ATAN2(Y, X) .................................................................. 1-161 ATAN2D(Y, X)................................................................ 1-163 ATAND(X)...................................................................... 1-164 ATANH(X)...................................................................... 1-165 BADDRESS(X) ............................................................. 1-166 BIT_SIZE(I) ................................................................... 1-167 BTEST(I, POS) ............................................................. 1-168 CEILING(A)................................................................... 1-169 iv Contents CHAR(I, KIND) ............................................................. 1-170 CMPLX(X, Y, KIND)...................................................... 1-171 CONJG(Z) .................................................................... 1-172 COS(X)......................................................................... 1-173 COSD(X) ...................................................................... 1-174 COSH(X) ...................................................................... 1-175 COUNT(MASK, DIM) ................................................... 1-176 CPU_TIME(TIME) ........................................................ 1-178 CSHIFT(ARRAY, SHIFT, DIM)...................................... 1-179 DATE_AND_TIME(DATE, TIME, ZONE, VALUES)...... 1-181 DBLE(A) ....................................................................... 1-183 DFLOAT(A)................................................................... 1-184 DIGITS(X)..................................................................... 1-185 DIM(X, Y)...................................................................... 1-186 DNUM(I) ....................................................................... 1-187 DOT_PRODUCT(VECTOR_A, VECTOR_B) ............... 1-188 DPROD(X, Y) ............................................................... 1-189 DREAL(A)..................................................................... 1-190 DSIGN .......................................................................... 1-191 EOSHIFT(ARRAY, SHIFT, BOUNDARY, DIM) ............. 1-192 EPSILON(X) ................................................................. 1-194 EXP(X) ......................................................................... 1-195 EXPONENT(X)............................................................. 1-196 FLOOR(A) .................................................................... 1-197 FRACTION(X) .............................................................. 1-198 FREE(A) ....................................................................... 1-199 HFIX(A) ........................................................................ 1-200 HUGE(X) ...................................................................... 1-201 IABS(A) ........................................................................ 1-202 IACHAR(C)................................................................... 1-202 IADDR(X) ..................................................................... 1-203 IAND(I, J)...................................................................... 1-204 v Intel Fortran Libraries Reference IBCLR(I, POS) .............................................................. 1-205 IBITS(I, POS, LEN) ....................................................... 1-206 IBSET(I, POS)............................................................... 1-207 ICHAR(C)...................................................................... 1-208 IDIM(X, Y) ..................................................................... 1-209