update.txt

一个不错

  removed resize(size_t)
  [Hint] Compiler should complain the differences.

 .operator>>(WyByteFlow&,WyStr&) changed not to throw while reading no byte
  and minor implement bugfix.
  [Hint] Manual inspect of each occurrence of reading no byte

 .Added template Wy_AtDestroy and functions Wy::_delete_one, Wy::_delete_array

 .WyStr::_setsize(..) changed to return WyRet instead of void
  [Hint] add return code checking for each occurrence

+-------+
| v0.24 |
+-------+
 Significant changes had done with this version, Updating previous source may
 be very difficuly(or may be easy). No update hint is provided for this releass
 (for the chk.. files also changed a lot)

 Wy_Thread have rewritten to adopt NPTL C++ implement. Many functions removed
 throw specification. (there may still be some to remove in the future)

 .All classes that contain virtual member have added a virtual member 
  T* _alloc(WyRet&).
  System file classes have reimplemented to better support polymorphism.

 .Class WySysFile is added as the base class of system files

 .Removed class WyAutoCancPtr

 .All the file read/write function argument n_read/n_written have changed 
  from pointer type to reference type, for pointer is difficult or error prone
  for function wrappers(reuse). This includes WySockFile::sendto/recvfrom.

 .Funcion what_is(..) renamed to wrd(..)
  added Wy::wrd(const WyTimeSpec& num, int radix, size_t frdig),
        Wy::wrd(NumType,int),
        Wy::wrd(NumType,int,size_t),

 .Added functions:
   1.Wy::lstat(..)
   2.Wy::_strftime(WyStr&,const char*,const WyDate&)
   3.Wy::sleep(WyTimeSpec)
   4.Wy::sleep(WyTimeSpec, WyTimeSpec&)

 .WyDate:
  bugfix: default timezone string changed (back)to "UTC"

 .Wy::sleep_till 
  removed WYM_ERANGE error code
  changed protocol to sleep_till(WyTimeSpec)
 
 .WyCond:
  changed protocol wait(WyLock&,WyTimeSpec)

 .WyRegFile:
  removed _read_till(void*,size_t,size_t*),
          _read_till(WyStr&,size_t,size_t*),
          _read_char(char&).
  changed create(WyRegFile&,const char*,int mode_t),
          create(WyRegFile&,const WyStr&,int mode_t),
          create_tmpfile(WyRegFile&,WyStr&) of the first argument type to
          reference type.
  changed _read_till(WyStr&,size_t,size_t&,char)
          _read_till(const char*,size_t,size_t&,char)
  renamed seek_pos_end() to seek_end()

 .WyStr:
  added _setsize(size_t)

 .Wy_Thread:
  exit_code() renamed to exitcode()
  removed wait_stopped(),wait_notnull(),tmain_enter(),tmain_leave()
  added wait_not(ThreadState)
  tmain() changed to have default implement (no longer pure virtual)

 .added a file wy_uty for operator<<,>> overloads (see wy_uty(3wy))

 .class WyDirFile renamed to Wy_DirFile
 .class WyLnkFile renamed to Wy_LnkFile

+-------+
| v0.23 |
+-------+
 .WyByteFlow class family (WyRegFile/WyChrFile/WyTerminal/WySockFile/WyFifoFile)
  1.Added: write(WyCSeg,size_t*)

 .WyByteFlow
  1.removed: WyByteFlow(WyFileHandle), reset(WyFileHandle)
    [Hint] No replacement available.
           Modify provious definition code to free function to use.

 .WyByteFlow/WyChrFile/WyTerminal/WySockFile/WyFifoFile/Wy::cin/Wy::cout/Wy::cerr
  1.bugy&removed: read_till(..), read_char(char&)
    [Hint] Provious version probably worked fine for stream socket only.
           No replacement available. Modify and fix previous function definition
           code to free function to use. This library probably is not considering
           providing such functions.

 .WYM_ENDEFAULT removed
  System file class family no more requires object be default before reset
  [Hint] Search for WYM_ENDEFAULT. Non-default object becomes now resetable.

 .Wy::cin/Wy::cout/Wy::cerr
  1.Bugfix: reset(..), swap(..) changed definition
    [Hint] Check and inspect use codes. These members of the previous version
           were incorrect. See wy(3wy).

 .WYM_EBADCAST removed
  libwy is not using this errmsg
  [Hint] See if the following replacement codes fit:
         static Wy_ErrInfo example_EBADCAST("Type cast failure");
         ...
         const WYM_EBADCAST(example_EBADCAST);

 .WYLIB_CONFIG_RSLI changed to WYLIB_CONFIG_NORSLI
  [Hint] Use compiler option to remove SLI in WyRet
         Examine code see if class size is revalent

 .Library removed the requirement wyreqs.h the first included
  [Hint] library now requires _REENTRANT be defined

 .WySockFile
  1.Added: member sendto(..) and recvfrom(..)

 .Wy::local_tzname() reimplemented
  1. Default time zone string changed to ":UTC"
    [Hint] Serach for "UTC", replace with ":UTC"
  2. WYM_ESRCH removed
    Function now returns ":UTC" if the search failed
    [Hint] See if application code can accept

+-------+
| v0.22 |
+-------+
 .WyLock:
  1.Member unlock() removed and added xlock(..)
   [Hint] redesign (updating should not be difficult, see manpage.)

 .WyThreadID renamed to Wy_ThreadID

 .WYM_VFDIS replaced by WYM_EBADTYPE

 .Library added symbol WYLIB_CONFIG_RSLI to configure using SLI in WyRet
  [Hint] symbol is defined in wyret.h

 .WyStr:
  1.Implement optimized: faster than std::string version on RedHat v9.0

  2.Bugfix: rfind(size_t*,size_t,const WyCSeg&)
            document error fix: append+WYM_ELOOP

  3.Removal: substr(..)
    [Hint] str.substr(..) -> WyStr( str.cseg(..) )

  4.Removal: int strcmp(size_type, size_type,const WyStr&)
             int strcmp(size_type, size_type,const WyCSeg&)
    [Hint] s1.strcmp(1,2,s2) -> WyStr(s1.cseg(1,2)).strcmp(s2) or others

 .WyCSeg
  1.Rename: is_joint(..) renamed to is_overlap(..)
  2.Add: swap(..)
  3.Class definition changed

 .WyDirEnt
  1.Rename: _name() renamed to filename()

 .WyByteTape
  1.Class removed
    [Hint] ? ,try using WyRegFile

 .WyByteFlow
  1.max_read(..) renamed to read_till(..)
    read_line(..) renamed to read_till(..)
    [Hint] WyRegFile, WyChrFile/WyTerminal, WySockFile, WyFifoFIle affected
 
  2.Class defined a protected constructor WyByteFlow(int), application function
    argument using type int becomes ambiguous
    [Hint] function argument(int) need to be expressed explicitly for WyFileHandle
           e.g. reset(int) -> reset( WyFileHandle(int) )
                Wy_FdSet::is_set(int) -> is_set( WyFileHandle(int) )
                Wy_FdSet::set(int) -> set( WyFileHandle(int) )
                Wy_FdSet::clr(int) -> clr( WyFileHanlde(int) )

   3.Removal: Removed WYM_E2BIG (read/write functions)

   4.Polymorphism is in general better supported

 .WyRegFile
  1.Rename: get_pos() renamed to pos()

 .WyFifoFile
  1.Bugfix: mkpipe(..)

 ,WySockFile
  1.Bugfix: sockpair(..)

  2.Bugfix: ::getsockname(..)/::getpeername(..) found to return z-string 
            with the trailing 0 counted. This member rescan sun_path

 .WyMath
  1.Rename: _fsci renamed to _scif

 .Wy_Thread
  1.Bugfix: _cancel_point() renamed to cancel_point()

 .Wy
  1.Add: Wy::select(Wy_FdSet*,Wy_FdSet*,Wy_FdSet*,WyTImeSpec&)

 .WyTimeSpec:
  1.Add: added members mul/div(long) for evaluation

+-------+
| v0.21 |
+-------+
 .Removed std::ostream& operator<< (std::ostream& os, const WyStr& str)
  (note: this is an undocumented internal function)
  1. source file may need to add include <iostream> or others missed
  2. change 'cout<< str' to 'cout<< str.c_str()'
     change 'cout<< Wy::what_is(e)' to 'cout<< Wy::what_is(e).c_str()'
     
 .WyReply member modified
  1. u_errstr(size_t*) changed to u_errstr(size_t&)
     [Hint] change em(*x) to em(x)
            change em(0) to em()

 .WySockAddrLocal members modified
  1. WYM_ENOMEM removed, default/copy constructor become nothrow
  2. family() changed to static function
  3. get_notation(WyStr&) changed to _path()
     [Hint] change a.get_notation(x) to x.reset(a._path())

 .WySockAddrINet renamed to WySockAddrINet4
  [Hint] change WySockAddrINet to WySockAddrINet4
         change include 'wysockaddrinet.h' to 'wysockaddrinet4.h'
  1. family() changed to static function
  2. ip() changed to return WySockAddrINet4::IPAddr
     [Hint] catch type may need change to WySockAddrINet4::IPAddr
            see wyipaddr4(3wy) and wysockaddrinet4(3wy)
  3. WySockAddrINet(unsigned long,unsigned short) changed to 
     WySockAddrInet4(uint32_t,uint16_t) and constructors changed to nothrow
  4. get_notation(WyStr&) removed
     [Hint] change ff.get_notation(str) to ff.ip().notation(str)
  
 .Add WySockAddrINet6 for IPv6 support

 .WySockFile member changes
  1. get_addr(..) renamed to sockname(..)
  2. get_peer_addr(..) renamed to peername(..)
  3. added static function sockpair(..)

 .WyDirEnt member changes
  1.filename() changed to 'const char* _name(void) throw()'
    [Hint] change f.filename() to f._name()
           change f1._name()!=f2._name() to Wy::_strcmp(f1._name(),f2._name())!=0
                  (there may be more to update)
           change f._name().is_default() to f._name()[0]==0
  2.constructor changed to nothrow

 .Wy_FdSet added WyFileHandle support

 .WyStr added function overload
   operator==(const char*)
   operator!=(const char*)
   bool operator==(const char*,const WyStr&)
   bool operator!=(const char*,const WyStr&)

 .WyFileStat constructor changed to nothrow

 .Wy_Thread::begin() added failure WYM_ENFILE

 .WyCond changed to nothrow
  1. return code of wait functions WY_EFAULT changed to WY_EINVAL
  2. return code of wait(WyLock&) WY_EINTR changed to OK

 .WyMutex changed member's throw type to Fault
  [Hint] examine catch type

 .WyLock constructor throw type changed to Fault, other members to nothrow
  [Hint] examine catch type