STRJOIN

Tip: See also the IDL_String::Join method, which provides similar functionality but with an object-oriented interface.

The STRJOIN function collapses a one-dimensional string array into a single merged string or two-dimensional string array into a one-dimensional array of merged strings. The strings in the removed first dimension are concatenated into a single string using the string in Delimiter to separate them.

Examples

Replace all the blanks in a sentence with colons:

str = 'Out, damned spot! Out I say!'
print, (STRJOIN(STRSPLIT(str, /EXTRACT), ':'))

IDL prints:

Out,:damned:spot!:Out:I:say!

Syntax

Result = STRJOIN( String [, Delimiter], /SINGLE )

Return Value

Returns the merged strings.

Arguments

String

A string array to be collapsed into merged strings.

Delimiter

The separator string to use between the joined strings. If Delimiter is not specified, an empty string is used.

Keywords

SINGLE

If SINGLE is set, the entire String is joined into a single scalar string result.

Version History

5.3	Introduced