memchr man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

MEMORY(3C)							    MEMORY(3C)

NAME
       memory, memccpy, memchr, memcmp, memcpy, memmove, memset - memory oper‐
       ations

SYNOPSIS
       #include <string.h>

       void *memccpy(void *restrict s1, const void *restrict s2,
	    int c, size_t n);

       void *memchr(const void *s, int c, size_t n);

       int memcmp(const void *s1, const void *s2, size_t n);

       void *memcpy(void *restrict s1, const void *restrict s2, size_t n);

       void *memmove(void *s1, const void *s2, size_t n);

       void *memset(void *s, int c, size_t n);

   ISO C++
       #include <string.h>

       const void *memchr(const void *s, int c, size_t n);

       #include <cstring>

       void *std::memchr(void *s, int c, size_t n);

DESCRIPTION
       These functions operate as efficiently  as  possible  on	 memory	 areas
       (arrays	of  bytes bounded by a count, not terminated by a null charac‐
       ter). They do not check for the overflow of any receiving memory area.

       The memccpy() function copies bytes from memory area s2 into s1,	 stop‐
       ping  after  the	 first occurrence of c (converted to an unsigned char)
       has been copied, or after n bytes have  been  copied,  whichever	 comes
       first. It returns a pointer to the byte after the copy of c in s1, or a
       null pointer if c was not found in the first n bytes of s2.

       The memchr() function returns a pointer to the first  occurrence	 of  c
       (converted  to an unsigned char) in the first n bytes (each interpreted
       as an unsigned char) of memory area s, or a null pointer if c does  not
       occur.

       The  memcmp()  function	compares its arguments, looking at the first n
       bytes (each interpreted as an unsigned char), and  returns  an  integer
       less than, equal to, or greater than 0, according as s1 is lexicograph‐
       ically less than, equal to,  or	greater	 than  s2  when	 taken	to  be
       unsigned characters.

       The  memcpy()  function	copies	n  bytes from memory area s2 to s1. It
       returns s1. If copying takes place between objects  that	 overlap,  the
       behavior is undefined.

       The  memmove()  function	 copies	 n bytes from memory area s2 to memory
       area s1. Copying between objects that  overlap  will  take  place  cor‐
       rectly. It returns s1.

       The  memset()  function	sets the first n bytes in memory area s to the
       value of c (converted to an unsigned char). It returns s.

USAGE
       Using memcpy() might be faster than using memmove() if the  application
       knows that the objects being copied do not overlap.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌────────────────────┬───────────────────┐
       │  ATTRIBUTE TYPE    │  ATTRIBUTE VALUE	│
       ├────────────────────┼───────────────────┤
       │Interface Stability │ Stable		│
       ├────────────────────┼───────────────────┤
       │MT-Level	    │ MT-Safe		│
       ├────────────────────┼───────────────────┤
       │Standard	    │ See standards(5). │
       └────────────────────┴───────────────────┘

SEE ALSO
       string(3C), attributes(5), standards(5)

NOTES
       Overlap	between	 objects  being copied can arise even when their (vir‐
       tual) address ranges appear to be disjoint; for example, as a result of
       memory-mapping  overlapping portions of the same underlying file, or of
       attaching the same shared memory segment more than once.

				  Feb 4, 2009			    MEMORY(3C)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net