Routines (alphabetical) > Routines: S > STRJOIN

# 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

## See Also

String Operations, String Processing, STRCMP, STREGEX, STRMATCH, STRMID, STRPOS, STRSPLIT, IDL_String