.\" Process this file with
.\" groff -man -Tascii js_append.3
.\"
.TH js_append 3 "August 2000" JS "js library reference"
.\" We don't want hyphenation (it's too ugly)
.\" We also disable justification when using nroff
.hy 0
.if n .na
.SH NAME
js_append \- append one js_string string after another js_string object
.SH SYNOPSIS
.nf
.B #include "JsStr.h"
.sp
.B "int js_append(js_string *toappend, js_string *target)"
.fi
.SH DESCRIPTION
.B js_append
appends the string in the
.I js_string
object
.B toappend
after the end of the
.I js_string
object
.B target.

.SH ARGUMENTS
.B toappend
is a pointer to the  
.I js_string
object we will place after 
.B target.

.B target
is the 
.I js_string
object that will be appended by the
.B toappend
string.

.SH "RETURN VALUE"
.B js_append
returns 
.I 0
on successful appending of the string,
.I JS_ERROR
otherwise.
.SH EXAMPLE
The following example will give foo the string "1234567890":

.nf
	js_string *foo, *bar;
	foo = js_create(256,1);
	bar = js_create(256,1);
	js_str2js(foo,"12345",5,1);
	js_str2js(bar,"67890",5,1);
	js_append(bar,foo); /* foo is now "1234567890" */
.fi
.SH AUTHOR
Sam Trenholme <kiwi-zttfryb@koala.samiam.org>