.\"break a string at regular intervals
.TH break_string 3
 
.SH NAME
break_string() - break a string at regular intervals
        
.SH SYNOPSIS
tring break_string(string str|int foobar, int len, void|int indent|string indent)
 
.SH DESCRIPTION
This function breaks a continous string without newlines into a
a string with newlines inserted at every `len':th character. 
 
If `indent' is defined and is given as an integer, `indent' number
of spaces are inserted after every newline. If `indent' is a string 
that string is inserted before every newline.
 
If the first argument is an integer, the function simply returns 0.
 
.SH BUGS
break_string() is *not* context sensitive.  It does not take account
of periods '.' and new-lines '\n'.  This means that the result is not
necessarily what you would expect.  My experience is that you should
use one space after a period and do not embed new-lines in the
text, but append them to the result of break_string().  If this format
does not meet your tastes you may find break_string() to be
inadequate.  A future revision of break_string() may allow different
line-breaking semantics.  (Cygnus)
 
.SH SEE ALSO
implode(3), explode(3), sprintf(3)