涓婁紶鍙戝竷
禄 index.html
index.html ( 鏂囦欢娴忚? )
&!DOCTYPE HTML PUBLIC &-//W3C//DTD HTML 4.0 Transitional//EN&&
&html&&head&&meta http-equiv=&Content-Type& content=&text/charset=iso-8859-1&&
&title&Portable Windows Library&/title&
&link href=&doxygen.css& rel=&stylesheet& type=&text/css&&
&/head&&body&
&!-- Generated by Doxygen 1.2.18 --&
&a class=&qindex& href=&index.html&&Main Page&/a& & &a class=&qindex& href=&namespaces.html&&Namespace List&/a& & &a class=&qindex& href=&hierarchy.html&&Class Hierarchy&/a& & &a class=&qindex& href=&annotated.html&&Compound List&/a& & &a class=&qindex& href=&files.html&&File List&/a& & &a class=&qindex& href=&functions.html&&Compound Members&/a& & &a class=&qindex& href=&globals.html&&File Members&/a& & &/center&
&hr&&h1&Portable Windows Library&/h1&
&h3 align=&center&&1.8.0&/h3&
&h2&&a name=&contents&&Table of Contents&/a&
&li& &a href=&index.html#intro&&Introduction&/a& &li& &a href=&index.html#overview&&Overview&/a& &li& &a href=&index.html#using&&Using PWLib&/a& &li& &a href=&index.html#base&&Base Classes&/a& &li& &a href=&index.html#components&&Console Components&/a& &li& &a href=&index.html#history&&History&/a&&/ul&
&h2&&a name=&intro&&Introduction&/a&
This document provides reference information for the PWLib C++ class library. It is not intended as a tutorial document.
Last updated 17 May, 2004
Copyright (C)
Equivalence Pty Ltd, All right reserved
Portions Copyright (C) 2004 Post Increment, All Rights Reserved
&h2&&a name=&overview&&Overview&/a&
PWLib is a moderately large C++ class library that originated many years ago as a method to produce applications that run on both Microsoft Windows and Unix X-Windows systems. It also was to have a Macintosh port as well, but this never eventuated.
Since then, the availability of multi-platform GUI toolkits such as KDE and wxWindows, and the development of the OpenH323 project as primary user of the library,
has emphasised the focus on networking, I/O portability, multi-threading and portability. Mostly, the library is used to create high performance and highly portable network-centric applications.
In addition to these high level functions, basic &container& classes such as arrays, linear lists, sorted lists (RB Tree) and dictionaries (hash tables) are available. These were created before the emergence of STL as a standard, so unfortunately these
constructs are incompatible with iterators and generic algorithms. Development continues in this area, and future versions of PWLIB will see increased use of, and compatibility with, STL
The library is used extensively by many companies for both commercial and Open Source products. The motivation in making PWLib available as Open Source was primarily to support the OpenH323 project, but it is definitely useful as a stand-alone library.
The classes within PWLib are seperated into two types: &a href=&index.html#base&&Base Classes&/a&
and &a href=&index.html#components&&Console Components&/a&
The &a href=&index.html#base&&Base Classes&/a&
contain all of the essential support for constructs such as containers, threads and sockets that are dependent on platform specific features. All PWLib programs will require the &a href=&index.html#base&&Base Classes&/a&
The &a href=&index.html#components&&Console Components&/a& implement functionality that is usually platform independent, and may not be required for all programs. On some platforms (notably Windows) the &a href=&index.html#base&&Base Classes&/a& and &a href=&index.html#components&&Console Components&/a& may be divided into discrete library archives. Other platforms (notably Unix platforms) combine all of the code into a single library
and rely on the linker to omit code that is not required.
Note that previous versions of PWLib also contained GUI classes and GUI components, but support for these classes has been discontinued.
&h2&&a name=&using&&Using PWLib&/a&
&/h2& Tutorial introductions for PWLib are available elsewhere (see &a href=&http://toncar.cz/openh323/tut&&http://toncar.cz/openh323/tut&/a&), but some
information on how to create a simple program is always useful.
Here is the canonical &Hello world!& program written using the PWLib infrastructure.
&div class=&fragment&&&pre&
// hello.cxx
#include &ptlib.h&
class Hello : public PProcess
PCLASSINFO(Hello, PProcess)
void Main();
PCREATE_PROCESS(Hello)
void Hello::Main()
cout && &Hello world!\n&;
// End of hello.cxx
&/pre&&/div&
The PCREATE_PROCESS macro actually defines the main()# function and creates an instance of Hello. This assures that everything is initialised in the correct order. C++ does initialisation of global statics badly (and destruction is even worse), so try to put everything into your &a class=&el& href=&classPProcess.html&&PProcess&/a& descedent rather than globals.
&h2&&a name=&base&&Base Classes&/a&
&h3&&a name=&object_h&&Base Object Classes&/a&
&/h3& &ul&
&li& &a class=&el& href=&classPObject.html&&PObject&/a& - the base class for all other classes in the PWLib &li& &a class=&el& href=&classPContainer.html&&PContainer&/a& - the base class for all reference-counted classes in PWLib &li& &a class=&el& href=&classPAbstractArray.html&&PAbstractArray&/a& - base class for array of objects. Equivalent to the STL vector template class &li& &a class=&el& href=&classPAbstractList.html&&PAbstractList&/a& - base class for lists of objects. Equivalent to the STL list template class &li& &a class=&el& href=&classPAbstractDictionary.html&&PAbstractDictionary&/a& - base class for dictionaries. Equivalent to the STL map template class &li& &a class=&el& href=&classPString.html&&PString&/a& - base class for the string abstraction. Equivalent to the STL string class.&/ul&
&h3&&a name=&channel&&I/O Channel Classes&/a&
&/h3& Classes that perform general I/O using the &a class=&el& href=&classPChannel.html&&PChannel&/a& abstraction &ul&
&li& &a class=&el& href=&classPChannel.html&&PChannel&/a& - base class for all I/O channels &li& &a class=&el& href=&classPIndirectChannel.html&&PIndirectChannel&/a& - a channel that encapsulates another channel &li& &a class=&el& href=&classPConsoleChannel.html&&PConsoleChannel&/a& - channel for accessing the system console &li& &a class=&el& href=&classPPipeChannel.html&&PPipeChannel&/a& - execute a program and access input and output as a &a class=&el& href=&classPChannel.html&&PChannel&/a& &li& &a class=&el& href=&classPSerialChannel.html&&PSerialChannel&/a& - access a serial communications port as a &a class=&el& href=&classPChannel.html&&PChannel&/a& &li& &a class=&el& href=&classPFile.html&&PFile&/a& - access files on the host operating system using PChannels &li& &a class=&el& href=&classPTextFile.html&&PTextFile&/a& - access text files on the host operating system as PChannels &li& &a class=&el& href=&classPStructuredFile.html&&PStructuredFile&/a& - access files on the host operating system as arrays of structured records &li& &a class=&el& href=&classPFilePath.html&&PFilePath&/a& - access directories on the host operating system &li& &a class=&el& href=&classPVideoChannel.html&&PVideoChannel&/a& - read or write data to a video device as a &a class=&el& href=&classPChannel.html&&PChannel&/a&. See also &a class=&el& href=&classPVideoDevice.html&&PVideoDevice&/a& and &a class=&el& href=&classPColourConverter.html&&PColourConverter&/a& &li& &a class=&el& href=&classPSoundChannel.html&&PSoundChannel&/a& - read or write data to sound device as a &a class=&el& href=&classPChannel.html&&PChannel&/a&&/ul&
&h3&&a name=&socket&&Socket Classes&/a&
&/h3& Implementation of a network sockets abstraction (roughly based on Berkeley sockets) &ul&
&li& &a class=&el& href=&classPSocket.html&&PSocket&/a& - base class for all network sockets &li& &a class=&el& href=&classPIPSocket.html&&PIPSocket&/a& - base class for all sockets using the IP protocol &li& &a class=&el& href=&classPUDPSocket.html&&PUDPSocket&/a& - IP socket using the UDP protocol &li& &a class=&el& href=&classPTCPSocket.html&&PTCPSocket&/a& - IP socket using the TCP/IP protocol &li& &a class=&el& href=&classPICMPSocket.html&&PICMPSocket&/a& - IP socket using the ICMP protocl &li& &a class=&el& href=&classPIPXSocket.html&&PIPXSocket&/a& - base class for sockets using the IPX protocol &li& &a class=&el& href=&classPEthSocket.html&&PEthSocket&/a& - socket interface for raw Ethernet interfaces&/ul&
&h3&&a name=&thread&&Process and Thread Classes&/a&
&/h3& Classes that handle processes, multi-threading and synchronsiation. &ul&
&li& &a class=&el& href=&classPProcess.html&&PProcess&/a& - implements the primary thread of control for a running program &li& &a class=&el& href=&classPServiceProcess.html&&PServiceProcess&/a& - implements a &daemon& or &system process& &li& &a class=&el& href=&classPThread.html&&PThread&/a& - abstracts a thread of control or execution context &li& &a class=&el& href=&classPSemaphore.html&&PSemaphore&/a& - synchronisation primitive based on a counter &li& &a class=&el& href=&classPMutex.html&&PMutex&/a& - synchronisation primitive based on mutual exclusion &li& &a class=&el& href=&classPCriticalSection.html&&PCriticalSection&/a& - synchronisation primitive implementing exclusive access to a critical code section &li& &a class=&el& href=&classPSyncPoint.html&&PSyncPoint&/a& - allows multiple threads to sychronise to a specific code point. See also &a class=&el& href=&classPSyncPointAck.html&&PSyncPointAck&/a& &li& &a class=&el& href=&classPAtomicInteger.html&&PAtomicInteger&/a& - implements an integer counter with atomic increment and decrement operations&/ul&
&h3&&a name=&misc&&Miscellaneous Classes&/a&
&/h3& &ul&
&li& &a class=&el& href=&classPArgList.html&&PArgList&/a& - parse a command line passed to a console program &li& &a class=&el& href=&classPConfig.html&&PConfig&/a& - provide persistent storage for program settings using a platform-appropriate mechanism &li& &a class=&el& href=&classPTime.html&&PTime&/a& - abstracts the notion of a wall-clock time and date &li& &a class=&el& href=&classPTimeInterval.html&&PTimeInterval&
锛堟枃浠惰秴闀匡紝鏈?畬鍏ㄦ樉绀猴紝璇蜂笅杞藉悗闃呰?鍓╀綑閮ㄥ垎锛