wy.3wy

一个不错

      Wy::cout << Wy::wrd(num+0.005,10,2);  // Rounded-up to two
                                            // fraction digits
.PP
    [\fBThrow\fP] WyStr::Reply
            Wym_EINVAL      \fIradix\fP not in valid range [0,2-36] or
                            \fIfrdig\fP not 0 (NumType is integer type)
            Wym_ENOMEM      Not enough memory
.PP 
    [\fBRet\fP] WyStr number representation of the conversion
.\"--------------------------------------------
.PP
.BI "WyByteFlow& Wy::cerr"
.PP
.BI "WyByteFlow& Wy::cin"
.PP
.BI "WyByteFlow& Wy::cout"
.PP
    Wy::cerr, Wy::cin, and Wy::cout are predefined WyByteFlow
    references for file descriptors STDERR_FILENO, STDIN_FILENO and
    STDOUT_FILENO respectively.
 
    Note: These standard i/o handlers have their specifics:
          1. Not allow be set to default, reset() throws 
             WyRet(Wym_EBADF), object is intact. If the given
             argument is default, reset(WyFileHandle) and 
             reset(const WySysFile&) return WyRet(Wym_EBADF)
          2. reset(WyFileHandle) and reset(const WySysFile&)
             may return Wym_EINTR and Wym_EBUSY (see (2)dup2).
          3. _swap(..) always fails (Wym_EBADTYPE)
          4. _alloc(..) always fails (Wym_ENOSYS)

    [\fBRefer\fP] ::dup2(..),STDERR_FILENO, STDIN_FILENO, STDOUT_FILENO
.\"--------------------------------------------
.PP
.BI "WyRet stat(const char* " "pathname" ", WyFileStat& " "stt" ")"
.PP
.BI "WyRet stat(const WyStr& " "pathname" ", WyFileStat& " "stt" ")"
.PP
    Read file information of \fIpathname\fP associated system file 
    and reset \fIstt\fP with the file information

    If \fIpathname\fP associates to a symbolic link, file information of
    the linked-to file is read.
.PP
    [\fBRet\fP] Ok              Succeed.
          Wym_ENOENT      Entry in \fIpathname\fP does not exist
          Wym_EFAULT      \fIpathname\fP is inaccessible
          Wym_EACCES      Search permission is denied
          Wym_ENOMEM      Not enough memory
          Wym_ENAMETOOLONG \fIpathname\fP too long
          Wym_ENOTDIR     Entry in \fIpathname\fP is not a directory
          ...
.PP 
    [\fBRefer\fP] ::stat(const char*,struct stat*)
.\"--------------------------------------------
.PP
.BI "WyRet lstat(const char* " "pathname" ", WyFileStat& " "stt" ")"
.PP
.BI "WyRet lstat(const WyStr& " "pathname" ", WyFileStat& " "stt" ")"
.PP
    Read file information of \fIpathname\fP associated system file 
    and reset \fIstt\fP with the file information

    If \fIpathname\fP associates to a symbolic link, file information of
    the link itself is read.
.PP
    [\fBRet\fP] Ok              Succeed.
          Wym_ENOENT      Entry in \fIpathname\fP does not exist
          Wym_EFAULT      \fIpathname\fP is inaccessible
          Wym_EACCES      Search permission is denied
          Wym_ENOMEM      Not enough memory
          Wym_ENAMETOOLONG \fIpathname\fP too long
          Wym_ENOTDIR     Entry in \fIpathname\fP is not a directory
          ...
.PP 
    [\fBRefer\fP] ::lstat(const char*,struct stat*)
.\"--------------------------------------------
.PP
.BI "WyRet Wy::select(Wy_FdSet* " "readfds" ", Wy_FdSet* " "writefds" ", Wy_FdSet* " "exceptfds" ")"
.PP
.BI "WyRet Wy::select(Wy_FdSet* " "readfds" ", Wy_FdSet* " "writefds" ", Wy_FdSet* " "exceptfds" ", const WyTimeSpec& " "timeout" ")"
.PP
    Wait at most \fItimeout\fP seconds for I/O ready notification of any
    object in the given set *\fIreadfds\fP, *\fIwritefds\fP and *\fIexceptfds\fP,
    if not NULL. Upon successful return, the given sets are left
    with those whose I/O ready notification had occurred. \fItimeout\fP,
    if not specified, is treated as infinite.

    Note: Wy_FdSet object have to be reset before call of Wy::select
          See also wy_fdset(3wy)
.PP
    [\fBRet\fP] Ok              Succeed. I/O ready notification occurred.
          Wym_ETIMEDOUT   \fItimeout\fP time expired
          Wym_ENODEV      Wy_FdSet had been used to call this function
          Wym_EBADF       Invalid file descriptor(s) in the given set
          Wym_EINVAL      Invalid argument(s)
          Wym_EINTR       Interrupted by a signal
          Wym_ENOMEM      Not enough memory
 
    [\fBRefer\fP] ::select(int,fd_set*,fd_set*,fd_set*,struct timeval*)
.\"--------------------------------------------
.PP
.BI "WyRet Wy::select(Wy_FdSet* " "readfds" ", Wy_FdSet* " "writefds" ", Wy_FdSet* " "exceptfds" ", WyTimeSpec& " "timeout" ")"
.PP
    Function is the same as
    Wy::select(Wy_FdSet*,Wy_FdSet*,Wy_FdSet*,const WyTimeSpec&) 
    except that, upon return, \fItimeout\fP is reset with the time left
    before timeout.
.\"--------------------------------------------
.PP
.BI "int Wy::_strcmp(const WyCSeg& " "s1" ", const WyCSeg& " "s2" ") throw()"
.PP
   Compare lexicographical order of the string pointed by \fIs1\fP
   and \fIs2\fP

   Note: Construction of WyCSeg throws WyCSeg::Reply
.PP
    [\fBRet\fP]  0, \fIs1\fP is equal to \fIs2\fP
          >0, \fIs1\fP is greater than \fIs2\fP
          <0, \fIs1\fP is lesser than \fIs2\fP
.PP 
    [\fBRefer\fP] ::memcmp(void*,void*,size_t)
.\"--------------------------------------------
.PP
.BI "int Wy::_strcmp(const char* " "s1" ", const char* " "s2" ")"
.PP
   Compare lexicographical order of the zero-terminated strings 

   Note: This is a function overload, documented for reference.
         See Wy::_strcmp(const WyCSeg&,const WyCSeg&).
.PP 
    [\fBRefer\fP] ::memcmp(void*,void*,size_t)
.\"--------------------------------------------
.PP
.BI "int Wy::_strcmp(const WyCSeg& " "s1" ", const char* " "s2" ")"
.PP
.BI "int Wy::_strcmp(const char* " "s1" ", const WyCSeg& " "s2" ")"
.PP
   Compare lexicographical order of the zero-terminated string and
   the string indicated by WyCSeg.

   Note: This is a function overload, documented for reference.
         See Wy::_strcmp(const WyCSeg&,const WyCSeg&).
.PP 
    [\fBRefer\fP] ::memcmp(const char*,const char*)
.\"--------------------------------------------
.PP
.BI "int Wy::_strcmp(const WyStr& " "s1" ",const WyStr& " "s2" ") throw()"
.PP
.BI "int Wy::_strcmp(const WyStr& " "s1" ",const WyCSeg& " "s2" ") throw()"
.PP
.BI "int Wy::_strcmp(const WyCSeg& " "s1" ",const WyStr& " "s2" ") throw()"
.PP
   Compare lexicographical order of the strings indicated by 
   \fIs1\fP and \fIs2\fP

   Note: Construction of WyCSeg throws WyCSeg::Reply
.PP
    [\fBRet\fP]  0, \fIs1\fP is equal to \fIs2\fP
          >0, \fIs1\fP is greater than \fIs2\fP
          <0, \fIs1\fP is lesser than \fIs2\fP
.PP 
    [\fBRefer\fP] ::memcmp(void*,void*,size_t)
.\"--------------------------------------------
.PP
.BI "int Wy::_strcmp(const WyStr& " "s1" ",const char* " "s2" ")"
.PP
.BI "int Wy::_strcmp(const char* " "s1" ",const WyStr& " "s2" ")"
.PP
   Compare lexicographical order of the strings indicated by 
   \fIs1\fP and \fIs2\fP

   Note: These are function overloads, documented for reference.
         See Wy::_strcmp(const WyCSeg&,const WyStr&). and
             Wy::_strcmp(const WyStr&,const WyCSeg&)
.\"--------------------------------------------
.PP
.BI "void Wy::_strcpy(char* " "dest" " ,WyCSeg " "src" ")"
.PP
   Copy string indicated by segment \fIsrc\fP to character array
   pointed by \fIdest\fP

   Note: Behavior is undefined if \fIsrc\fP overlaps with 
         the segment implied by \fIdest\fP

   Note: Behavior is undefined if \fIdest\fP points to invalid address
.PP 
    [\fBRefer\fP] ::memcpy(void*,const void*,size_t)
.\"--------------------------------------------
.PP
.BI "void Wy::_strmove(char* " "dest" " ,char* " "src" ", size_t " "n" ")"
.PP
   Copy \fIn\fP characters pointed by \fIsrc\fP to the character array 
   pointed by \fIdest\fP. The arrays \fIsrc\fP and \fIdes\fP may overlap.

   Note: Behavior is undefined if \fIsrc\fP or \fIdest\fP point to
         invalid addresse(s).
.PP 
    [\fBRefer\fP] ::memmove(void*,const void*,size_t)
.\"--------------------------------------------
.PP
.BI "const char* Wy::_strchr(const WyCSeg& " "s" ", char " "c" ") throw()"
.PP
   Search the character sequence pointed by \fIs\fP for the first
   occurrence of character \fIc\fP.
.PP
    [\fBRet\fP] Pointer to the first occurrence of character \fIc\fP, or
          NULL if the character is not found.
.PP 
    [\fBRefer\fP] ::memchr(const void*,int,size_t)
.\"--------------------------------------------
.PP
.BI "const char* Wy::_strrchr(const WyCSeg& " "s" ", char " "c" ") throw()"
.PP
   Search the character sequence pointed by \fIs\fP for the last
   occurrence of character \fIc\fP.
.PP
    [\fBRet\fP] Pointer to the last occurrence of character \fIc\fP, or
          NULL if the character is not found.
.PP 
    [\fBRefer\fP] ::memrchr(const void*,int,size_t)
.\"--------------------------------------------
.PP
.BI "const char* Wy::_strstr(const WyCSeg& " "haystack" ", const WyCSeg& " "needle" ") throw()"
.PP
   Search the character sequence pointed by \fIhaystack\fP for the first
   occurrence of character sequence pointed by \fIneedle\fP
.PP
    [\fBRet\fP] Pointer to the first occurrence of character sequence found
          in \fIhaystack\fP, or NULL if the character sequence is not found.
.PP 
    [\fBRefer\fP] ::memmem(const void*,size_t,const void*,size_t)
.\"--------------------------------------------
.PP
.BI "WyStr& Wy::_toupper(WyStr& " "str" ") throw()"
.PP
   Convert characters in \fIstr\fP to upper case.
.PP
    [\fBRet\fP] reference of \fIstr\fP
.\"--------------------------------------------
.PP
.BI "WyStr& Wy::_tolower(WyStr& " "str" ") throw()"
.PP
   Convert characters in \fIstr\fP to lower case.
.PP
    [\fBRet\fP] reference of \fIstr\fP
.\"--------------------------------------------
.PP
.BI "template<typename T> void Wy::_delete_one(T* " "p" ")"
.PP
   Function form of operator \fBdelete\fP
.PP 
    [\fBThrow\fP] from delete \fIp\fP
.PP 
    [\fBRefer\fP] operator delete
.PP
.BI "template<typename T> void Wy::_delete_array(T* " "p" ")"
.PP
   Function form of operator \fBdelete[]\fP
.PP
    [\fBThrow\fP] from delete[] \fIp\fP
.PP 
    [\fBRefer\fP] operator delete[]
.\"--------------------------------------------
.PP
.BI "WyStr Wy::wrd(const WySockAddrLocal& " "addr" ") throw(WyStr::Reply)"
.PP
    Get string representation of \fIaddr\fP
.PP
    [\fBThrow\fP] WyStr::Reply
            Wym_ENOMEM      Not enough memory
.PP 
    [\fBRet\fP] WyStr representation of \fIaddr\fP
.\"--------------------------------------------
.PP
.BI "WyStr Wy::wrd(const WySockAddrINet4& " "addr" ")"
.PP
    Get string representation of \fIaddr\fP
    The returned text string notation is like "ddd.ddd.ddd.ddd:port".
.PP
    [\fBThrow\fP] WyStr::Reply
            Wym_ENOMEM      Not enough memory
.PP
    [\fBThrow\fP] WySockAddrINet4::Reply
            Wym_ENOMEM      Not enough memory
.PP 
    [\fBRet\fP] WyStr representation of \fIaddr\fP in dotted-decimal notation
.PP 
    [\fBRefer\fP] ::inet_ntop(int,const void*,char*,size_t)
.\"--------------------------------------------
.PP
.BI "WyStr Wy::wrd(const WySockAddrINet4::IPAddr& " "addr" ")"
.PP
    Get string representation of \fIaddr\fP
    The returned text string notation is like "ddd.ddd.ddd.ddd".
.PP
    [\fBThrow\fP] WyStr::Reply
            Wym_ENOMEM      Not enough memory
.PP
    [\fBThrow\fP] WySockAddrINet4::IPAddr::Reply
            Wym_ENOMEM      Not enough memory
.PP 
    [\fBRet\fP] WyStr representation of \fIaddr\fP in dotted-decimal notation
.PP 
    [\fBRefer\fP] ::inet_ntop(int,const void*,char*,size_t)
.\"--------------------------------------------
.PP
.BI "WyStr Wy::wrd(const WySockAddrINet6& " "addr" ")"
.PP
    Get string representation of \fIaddr\fP
    The returned text string notation is like "hh:hh:hh.port".
.PP
    [\fBThrow\fP] WyStr::Reply
            Wym_ENOMEM      Not enough memory
.PP
    [\fBThrow\fP] WySockAddrINet6::Reply
            Wym_ENOMEM      Not enough memory
.PP 
    [\fBRet\fP] WyStr representation of \fIaddr\fP in colon-separated notation
.PP 
    [\fBRefer\fP] ::inet_ntop(int,const void*,char*,size_t)
.\"--------------------------------------------
.PP
.BI "WyStr Wy::wrd(const WySockAddrINet6::IPAddr& " "addr" ")"
.PP
    Get string representation of \fIaddr\fP
    The returned text string notation is like "hh:hh:hh".
.PP
    [\fBThrow\fP] WyStr::Reply
            Wym_ENOMEM      Not enough memory
.PP
    [\fBThrow\fP] WySockAddrINet6::IPAddr::Reply
            Wym_ENOMEM      Not enough memory
.PP 
    [\fBRet\fP] WyStr representation of \fIaddr\fP in colon-separated notation
.PP 
    [\fBRefer\fP] ::inet_ntop(int,const void*,char*,size_t)
.\"--------------------------------------------
.SH "SEE ALSO"
.BR wystr
.BR wytimespec
.BR wymath
.BR wybyteflow
.BR wy_fdset
.BR wy_thread
.BR wy_uty
.SH NOTE
Except added by this library, replys are converted from the errno 
an underlying C library function returned. Report of such replys
are brief from Linux Programmer's Manual. See the associated man page
for details.

Project is in development, http://sourceforge.net/projects/libwx