6.2.37 "COBOL Language Reference" IBM Library Server

6.2.37 STRING Statement

The STRING statement strings together the partial or complete contents of two or more data items or literals into one single data item.

One STRING statement can be written instead of a series of MOVE statements.


    ___ Format _____________________________________________________________ 
   |                                                                        |
   | >>__STRING___________________________________________________________> |
   |                                                                        |
   |    <___________________________________________________________        |
   |      <__________________                                       |       |
   | >______ _identifier-1_ _|__DELIMITED__ ____ __ _identifier-2_ _|_____> |
   |        |_literal-1____|               |_BY_|  |_literal-2____|         |
   |                                               |_SIZE_________|         |
   |                                                                        |
   | >__INTO__identifier-3__ _________________________________ ___________> |
   |                        |_ ______ __POINTER__identifier-4_|             |
   |                          |_WITH_|                                      |
   |                                                                        |
   | >__ __________________________________________ ______________________> |
   |    |_ ____ __OVERFLOW__imperative-statement-1_|                        |
   |      |_ON_|                                                            |
   |                                                                        |
   | >__ _______________________________________________ _________________> |
   |    |_NOT__ ____ __OVERFLOW__imperative-statement-2_|                   |
   |           |_ON_|                                                       |
   |                                                                        |
   | >__ ____________ ___________________________________________________>< |
   |    |_END-STRING_|                                                      |
   |                                                                        |
   |________________________________________________________________________|

X None of the identifiers in a STRING statement can be windowed date fields.

identifier-1

Represents the sending field(s).

All identifiers (except identifier-4, the POINTER item) must have USAGE DISPLAY, explicitly or implicitly.

When the sending field or any of the delimiters is an elementary numeric item, it must be described as an integer, and its PICTURE character-string must not contain the symbol P.

literal-1

Represents the sending field(s).

All literals must be nonnumeric literals; each may be any figurative constant except the ALL literal. When a figurative constant is specified, it is considered a 1-character nonnumeric literal.

X identifier-1 through identifier-3

X May be DBCS data items. If one of these identifiers is a DBCS item,
X then all of them, and all literals, must be DBCS items. May not be
X external floating-point items.

X literal-1 and literal-2

X May be DBCS literals. If one of these is a DBCS literal, then all of
X them must be DBCS literals, and identifier-1 through identifier-3 must
X be DBCS items.

X SPACE is the only figurative constant allowed for DBCS items.

Subtopics:

Adobe, the Adobe logo, Acrobat, the Acrobat logo, and Acrobat Reader are registered trademarks of Adobe Systems incorporated.

6.2.37 STRING Statement

IBM Library Server Copyright 1989, 2005 IBM Corporation. All rights reserved.