.\" Process this file with
.\" groff -man -Tascii cryptday.1
.\"
.TH js_copy 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_copy \- copy one js_string to another js_string object
.SH SYNOPSIS
.nf
.B #include "JsStr.h"
.sp
.B "int js_copy(js_string *src, js_string *dest)"
.fi
.SH DESCRIPTION
.B js_copy
copys the 
.I js_string
object
.B src
to the 
.I js_string
object
.B dest.

.SH ARGUMENTS
.B src
is the source 
.I js_string
object, the string we copy.

.B dest
is the 
.I js_string
object we copy over.

.SH "RETURN VALUE"
.B js_copy
returns 
.I JS_SUCCESS 
on successful copying of the string,
.I JS_ERROR
otherwise.
.SH EXAMPLE
The following example will give bar the string "1234567890":

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