STRPUT Procedure

Inserts the contents of one string into another.

STRPUT, destination, source [, position]

destination The string into which source will be inserted. Must be a named variable of type string. Cannot be an element of an array. If destination is an array, source is inserted into every element.

source The string to be inserted into destination. Must be scalar.

If not of type string, source is converted to string using PV-WAVE's default formatting rules. (These rules are described in Free Format Output in Chapter 8 of the PV-WAVE Programmer's Guide.)

position (optional) The character position at which the insertion is begun. If position is omitted or is less than zero, the search begins at the first character (character position 0).

None.

The source string is inserted into the destination string, starting at the given position. All characters in destination that occur either before the starting position, or after the starting position plus the length of source, remain unchanged.

This example uses STRPUT to insert a substring into a larger string, starting at position 0 of the destination string. Clipping is then demonstrated by using STRPUT to insert a substring that would otherwise extend the length of the destination string.

a = 'Strings are fun'

; Create a string in the variable a.

STRPUT, a, 'PV-WAVE is '

; Insert the string "PV-WAVE is" into a, starting at position 0.

PRINT, a

PV-WAVE is  fun

; Display the result.

STRPUT, a, 'fun to use', 12

; Insert a string into a that would extend its length.

PRINT, a

PV-WAVE is  fun

; Display the result. Note that the inserted string was clipped so the

; length of a did not change.

STRLEN, STRLOWCASE, STRMESSAGE, STRPOS, STRUPCASE