BS ISO/IEC 1539-2:2000

1 Scope
2 Normative References
3 Requirements
      3.1 The Name of the Module
      3.2 The Type
      3.3 Extended Meanings for Intrinsic Operators
             3.3.1 Assignment
             3.3.2 Concatenation
             3.3.3 Comparisons
      3.4 Extended Meanings for Generic Intrinsic
             Procedures
             3.4.1 ADJUSTL (string)
             3.4.2 ADJUSTR (string)
             3.4.3 CHAR (string [, length])
             3.4.4 IACHAR (c)
             3.4.5 ICHAR (c)
             3.4.6 INDEX (string, substring [, back])
             3.4.7 LEN (string)
             3.4.8 LEN_TRIM (string)
             3.4.9 LGE (string_a, string_b)
             3.4.10 LGT (string_a, string_b)
             3.4.11 LLE (string_a, string_b)
             3.4.12 LLT (string_a, string_b)
             3.4.13 REPEAT (string, ncopies)
             3.4.14 SCAN (string, set [, back])
             3.4.15 TRIM (string)
             3.4.16 VERIFY (string, set [, back])
      3.5 Additional Generic Procedure for Type Conversion
             3.5.1 VAR_STR (char)
      3.6 Additional Generic Procedures for Input/Output
             3.6.1 GET (string [, maxlen, iostat]) or
                      GET (unit, string [, maxlen, iostat])
                      or GET (string, set [, separator,
                      maxlen, iostat]) or GET (unit, string,
                      set [, separator, maxlen, iostat])
             3.6.2 PUT (string [, iostat]) or PUT (unit,
                      string [, iostat])
             3.6.3 PUT_LINE (string [, iostat]) or PUT_
                      LINE (unit, string [, iostat])
      3.7 Additional Generic Procedures for Substring
             Manipulation
             3.7.1 EXTRACT (string [, start, finish])
             3.7.2 INSERT (string, start, substring)
             3.7.3 REMOVE (string [, start, finish])
             3.7.4 REPLACE (string, start, substring) or
                      REPLACE (string, start, finish,
                      substring) or REPLACE (string, target,
                      substring [,every, back])
             3.7.5 SPLIT (string, word, set [, separator,
                      back])
Annex A (informative) Module ISO_VARYING_STRING
Annex B (informative) Two examples
      B.1 - Word count
      B.2 - Vocabulary list

Defines facilities in Fortran for manipulation of character strings of dynamically variable length. Provides an auxiliary standard for the version of the fortran language specified by ISO/IEC 1539-1:1997 and informally known as Fortran 95.A programme that conforms with 1539-2:1994 also conforms with this standard. Defines additional facilities to those defined intrinsically in the primary language standard. Does not prescribe the details on any implementation.

This part of ISO/IEC1539 defines facilities in Fortran for the manipulation of character strings of dynamically variable length. This part of ISO/IEC1539 provides an auxiliary standard for the version of the Fortran language specified by ISO/IEC1539-1: 1997 and informally known as Fortran 95.

A program that conforms with 1539-2: 1994 also conforms with this standard.

This part of ISO/IEC1539 is an auxiliary standard to that defining Fortran 95 in that it defines additional facilities to those defined intrinsically in the primary language standard. A processor conforming to the Fortran 95 standard is not required also to conform to this part of ISO/IEC1539. However, conformance to this part of ISO/IEC1539 assumes conformance to the primary Fortran 95 standard.

This part of ISO/IEC1539 prescribes the name of a Fortran module, the name of a derived data type to be used to represent varying-length strings, the interfaces for the procedures and operators to be provided to manipulate objects of this type, and the semantics that are required for each of the entities made accessible by this module.

This part of ISO/IEC1539 does not prescribe the details of any implementation. Neither the method used to represent the data entities of the defined type nor the algorithms used to implement the procedures or operators whose interfaces are defined by this part of ISO/IEC1539 are prescribed. A conformant implementation may use any representation and any algorithms, subject only to the requirement that the publicly accessible names and interfaces conform to this part of ISO/IEC1539, and that the semantics are as required by this part of ISO/IEC1539 and those of ISO/IEC1539-1 : 1997.

It should be noted that a processor is not required to implement this part of ISO/IEC1539 in order to be a standard conforming Fortran processor, but if a processor implements facilities for manipulating varying length character strings, it is recommended that this be done in a manner that is conformant with this part of ISO/IEC1539.

A processor conforming to this part of ISO/IEC1539 may extend the facilities provided for the manipulation of varying length character strings as long as such extensions do not conflict with this part of ISO/IEC1539 or with ISO/IEC1539-1 : 1997.

A module, written in standard conforming Fortran, is referenced in AnnexA. This module illustrates one way in which the facilities described in this part of ISO/IEC1539 could be provided. This module is both conformant with the requirements of this part of ISO/IEC1539 and, because it is written in standard conforming Fortran, it provides a portable implementation of the required facilities. This module is referenced for information only and is not intended to constrain implementations in any way. This module is a demonstration that at least one implementation, in standard conforming and hence portable Fortran, is possible.

It should be noted that this part of ISO/IEC1539 defines facilities for dynamically varying length strings of characters of default kind only. Throughout this part of ISO/IEC1539 all references to intrinsic type CHARACTER should be read as meaning characters of default kind. Similar facilities could be defined for non-default kind characters by a separate, if similar, module for each such character kind.

This part of ISO/IEC1539 has been designed, as far as is reasonable, to provide for varying length character strings the facilities that are available for intrinsic fixed length character strings. All the intrinsic operations and functions that apply to fixed length character strings have extended meanings defined by this part of ISO/IEC1539 for varying length character strings. Also a small number of additional facilities are defined that are appropriate because of the essential differences between the intrinsic type and the varying length derived data type.