

memccpy()                String Function                memccpy()




Copy  one  region  of  memory  into  another up  to  a  requested
character

#iinncclluuddee <ssttrriinngg.hh>
cchhaarr *mmeemmccccppyy(_d_e_s_t, _s_r_c, _c, _n)
cchhaarr *_d_e_s_t, *_s_r_c; uunnssiiggnneedd iinntt _c, _n;

mmeemmccccppyy copies characters  from _s_r_c to _d_e_s_t, stopping when either
it finds the  first occurrence of character _c or  it has copied _n
characters.   Unlike  the  routines  ssttrrccppyy and  ssttrrnnccppyy,  mmeemmccppyy
copies from  one region to another.  Therefore,  it will not halt
automatically when it encounters a null character.

mmeemmccccppyy returns a pointer to the first location after character _c
in _d_e_s_t, or NULL if character _c was not found.

***** See Also *****

mmeemmccppyy(), ssttrrccppyy(), ssttrrnnccppyy(), ssttrriinngg ffuunnccttiioonnss, ssttrriinngg.hh

***** Notes *****

mmeemmccccppyy is not part of the  ANSI C Standard.  Use of this library
routine may restrict portability.

If _d_e_s_t  and _s_r_c overlap,  the behavior of  mmeemmccccppyy is undefined.
_d_e_s_t should  point to enough  reserved memory to hold  _n bytes of
data; otherwise, data corruption may result.




























COHERENT Lexicon                                           Page 1


