AutoGen: 2.2.7 A Here String

[ < ] | [ > ] |  | [ << ] | [ Up ] | [ >> ] |  |  |  |  | [Top] | [Contents] | [Index] | [ ? ]

### 2.2.7 A Here String

A ``here string'` is formed in much the same way as a shell here doc. It is denoted with a doubled less than character and, optionally, a hyphen. This is followed by optional horizontal white space and an ending marker-identifier. This marker must follow the syntax rules for identifiers. Unlike the shell version, however, you must not quote this marker. The resulting string will start with the first character on the next line and continue up to but not including the newline that precedes the line that begins with the marker token. No backslash or any other kind of processing is done on this string. The characters are copied directly into the result string.

Here are two examples:

    str1 = <<-  STR_END
            $quotes = " ' `
            STR_END;

    str2 = <<   STR_END
            $quotes = " ' `
            STR_END;
    STR_END;

The first string contains no new line characters. The first character is the dollar sign, the last the back quote.

The second string contains one new line character. The first character is the tab character preceding the dollar sign. The last character is the semicolon after the `STR_END`. That `STR_END` does not end the string because it is not at the beginning of the line. In the preceding case, the leading tab was stripped.

This document was generated by Bruce Korb on October, 8 2005 using texi2html 1.76.