StrBuf::operator <<( const StrPtr * )

Append a StrPtr to a StrBuf. The string pointed to by the StrPtr's buffer is logically appended to the string pointed to by the StrBuf's buffer.

Virtual?	No
Class	`StrBuf`
Arguments	`const StrPtr *s`	(implied) pointer to the `StrPtr` instance
Returns	`StrBuf &`	reference of the `StrBuf`

Notes

Exactly the number of bytes specified by the StrPtr's length are appended to the StrBuf. The StrBuf's length is incremented by the StrPtr's length.

If the memory for the StrBuf's buffer is not large enough, new contiguous memory is allocated to contain the results of appending the StrPtr. If new memory is allocated, the old memory is freed. Any memory allocated is separate from the memory for the StrPtr.

Example

Copy

#include &lt;iostream&gt;

#include &lt;stdhdrs.h&gt;
#include &lt;strbuf.h&gt;

int main( int argc, char **argv )
{
    StrRef sr( "zy" );
    StrPtr *sp = &amp;sr;
    StrBuf sb;

    sb.Set( "xyz" );

    cout &lt;&lt; "sb.Text() prior to sb &lt;&lt; sp returns ";
    cout &lt;&lt; "\"" &lt;&lt; sb.Text() &lt;&lt; "\"\n";
    cout &lt;&lt; "sb.Length() prior to sb &lt;&lt; sp returns ";
    cout &lt;&lt; sb.Length() &lt;&lt; "\n\n";

    sb &lt;&lt; sp;   // append StrPtr * to StrBuf

    cout &lt;&lt; "sb.Text() after sb &lt;&lt; sp returns ";
    cout &lt;&lt; "\"" &lt;&lt; sb.Text() &lt;&lt; "\"\n";
    cout &lt;&lt; "sb.Length() after sb &lt;&lt; sp returns ";
    cout &lt;&lt; sb.Length() &lt;&lt; "\n";
}

Executing the preceding code produces the following output:

sb.Text() prior to sb << sp returns "xyz"
sb.Length() prior to sb << sp returns 3

sb.Text() after sb << sp returns "xyzzy"
sb.Length() after sb << sp returns 5