NAME
wavmrgest - WAVeform MeRGe Extended Segment Table
SYNOPSIS
#include "wiodef.h"
short wavmrgest (WVFILE *wfp, SEGETBL *segetbl, long offset)
DESCRIPTION
wavmrgest() merges segment definitions from segetbl into the
waveform represented by wfp, adding offset to the end_points of each
segment. If a name collision occurs, the segment name is altered
using the algorithm described in addsega().
RETURN VALUES
On success wavmrgest() returns 0. If any segment cannot be added,
the reason is returned in the error value as follows:
- -1
- unalterable name collision
- -2
- invalid segment definition
- -3
- system error
BUGS
If there is an error in adding any segment, the merge stops at that point,
leaving the remaining segment definitions unmerged.
SEE ALSO
addsega(),
wavcpyest(),
free_segetbl(),
Libcwav library
AUTHOR
Shirley Peters