STRPUT
The
STRPUT procedure inserts the contents of one string into another. The source string,
Source
, is inserted into the destination string,
Destination
, starting at the given position,
Position
. Characters in
Destination
before the starting position and after the starting position plus the length of
Source
remain unchanged. The length of the destination string is not changed. If the insertion extends past the end of the destination, it is clipped at the end.
Calling Sequence
STRPUT,
Destination, Source [, Position]
Arguments
Destination
The named string variable into which
Source
is inserted.
Destination
must be a named variable of type string. If it is an array,
Source
is inserted into every element of the array.
Source
A scalar string to be inserted into
Destination
. If this argument is not a string, it is converted using IDL's default formatting rules.
Position
The character position at which the insertion is begun. If
Position
is omitted, the insertion begins at the first character (character position 0). If
Position
is less than zero, zero is used for the initial position.
Examples
If the variable A contains the string "IBM is fun", the substring "IBM" can be overwritten with the string "IDL" by entering:
STRPUT, A, 'IDL', 0
The following commands demonstrate the clipping of output that extends past the end of the destination string:
STRPUT, A, 'FUNNY', 7
PRINT, A
IDL prints:
IDL is FUN
