【免费】curlpp-0.7.2.tar.gz资源-CSDN文库

5星 · 超过95%的资源需积分: 0 94 浏览量 2009-12-03 08:37:42 上传评论收藏 462KB GZ 举报

共143个文件

hpp：43个

cpp：36个

inl：16个

资源推荐

资源详情

资源评论

收起资源包目录

curlpp-0.7.2.tar.gz （143个子文件）

configure.ac 4KB

Makefile.am 3KB

Makefile.am 1KB

Makefile.am 806B

Makefile.am 699B

Makefile.am 214B

Makefile.am 158B

Makefile.am 22B

AUTHORS 381B

ChangeLog 12KB

CHANGES 7KB

configure 712KB

COPYING 1KB

OptionSetter.cpp 8KB

CurlHandle.cpp 6KB

Form.cpp 5KB

Exception.cpp 4KB

example07.cpp 4KB

example14.cpp 4KB

example01.cpp 4KB

example06.cpp 4KB

Multi.cpp 3KB

example13.cpp 3KB

example05.cpp 3KB

example18.cpp 3KB

example17.cpp 3KB

example11.cpp 3KB

OptionList.cpp 3KB

example10.cpp 3KB

example21.cpp 3KB

example02.cpp 3KB

example04.cpp 2KB

example19.cpp 2KB

example08.cpp 2KB

example09.cpp 2KB

example16.cpp 2KB

example12.cpp 2KB

example03.cpp 2KB

Easy.cpp 2KB

example22.cpp 2KB

example20.cpp 2KB

example15.cpp 2KB

SList.cpp 2KB

LifetimeLibrary.cpp 2KB

cURLpp.cpp 2KB

OptionBase.cpp 2KB

Options.cpp 1KB

PrivateMembers.cpp 1KB

Info.cpp 970B

depcomp 16KB

config.guess 44KB

config.h 2KB

autolink.h 2KB

config.win32.h 2KB

dllfct.h 2KB

global.h 1KB

TypeTrait.hpp 29KB

Options.hpp 12KB

OptionSetter.hpp 8KB

cURLpp.hpp 8KB

Exception.hpp 8KB

MemFunHandler.hpp 7KB

FunctorHandler.hpp 7KB

Functor.hpp 7KB

FunctorImpl.hpp 7KB

TypeList.hpp 7KB

Option.hpp 7KB

Binder.hpp 6KB

Form.hpp 6KB

CurlHandle.hpp 5KB

SmartPtr.hpp 4KB

Infos.hpp 4KB

OptionContainerType.hpp 3KB

Easy.hpp 3KB

OptionList.hpp 3KB

Info.hpp 3KB

LifetimeLibrary.hpp 3KB

OptionContainer.hpp 3KB

clone_ptr.hpp 3KB

PrivateMembers.hpp 2KB

OptionBase.hpp 2KB

Types.hpp 2KB

SingletonHolder.hpp 2KB

SList.hpp 2KB

CreationStatic.hpp 2KB

LifetimeWithLongevity.hpp 2KB

Multi.hpp 2KB

StorageOptions.hpp 2KB

ThreadingSingle.hpp 2KB

CreationUsingNew.hpp 2KB

TypeTrait.hpp 2KB

ThreadingFactoryMutex.hpp 2KB

LifetimeDefault.hpp 1KB

NonCopyable.hpp 1KB

EmptyType.hpp 1KB

NullType.hpp 1KB

Functors.hpp 1KB

Singleton.hpp 113B

Makefile.in 23KB

共 143 条

Programming with cURLpp

Jean-Philippe Barrette-LaPierre

January 25, 2006

1 About this Document

This document attempts to describe the general principles and some basic

approaches to consider when programming with cURLpp. Don’t forget that

cURLpp is a C++wrapper of libcurl, so cURLpp needs libcurl to be installed

already.

This document will refer to ’the user’ as the person writing the source

code that uses cURLpp. That would probably be you or someone in a similar

position. What will be generally refered to as ’the program’ will b e the

collective source code that you write and that is using cURLpp for transfers.

The program is outside cURLpp and cURLpp is outside of the program.

To get more details on all options and functions described herein, please

refer to their respective man pages. You should always have in mind that this

is a C++wrapper of libcurl. It would be unproductive to duplicate libcurl’s

documentation here, so this document will show you how to interact with

cURLpp, but you should read the libcurl programming tutorial, which this

document is strongly inspired from, and the libcurl man pages.

2 Building

There are many diﬀerent ways to build C++ programs. This chapter will

assume a unix-style build process. If you use a diﬀerent build system, you can

still read this to get general information that may apply to your environment

as well. Note that cURLpp need libcurl to be already installed.

2.1 Compiling the Program

Your compiler needs to know where cURLpp’s and libcurl’s headers are lo-

cated. Therefore you must set your compiler’s include path to point to the

directory where you installed them. The ’curlpp-conﬁg’

tool can be used to

get this information:

# curlpp-config --cflags

If pkg-conﬁg is installed, you can use it this way:

# pkg-config --cflags curlpp

But, if you’re using autoconf for your project you can use pkg-config

macros. See pkg-config man pages for more details.

2.2 Linking the Program with cURLpp

When having compiled the program, you need to link your object ﬁles to

create a single executable. For that to succeed, you need to link with cURLpp

and possibly also with other libraries that cURLpp itself de pends on (such

as libcurl). This may include OpenSSL libraries and even some standard OS

libraries may be needed on the command line. To ﬁgure out which ﬂags to

use, the ’curlpp-conﬁg’ tool comes to the rescue once again:

# curlpp-config --libs

Again, if pkg-conﬁg is installed, you can use it this way:

# pkg-config --libs curlpp

The curlpp-conﬁg tool, which wraps all functions of curl-conﬁg, is generated at build-

time (on unix-like systems) and should be installed with the ’make install’ or similar

instruction that installs the library, header ﬁles, man pages etc.

2.3 SSL or Not

cURLpp, like libcurl, can be built and customized in many ways. One of

the things that varies between diﬀerent libraries and builds is the support

for SSL-based transfers, like HTTPS and FTPS. If OpenSSL was detected

properly by libcurl at build-time, cURLpp will be built with SSL support. To

ﬁgure out if an installed cURLpp has been built with SSL support enabled,

use ’curlpp-conﬁg’ like this:

# curlpp-config --feature

If SSL is supported, the keyword ’SSL’ will be written to stdout, possi-

bly together with a few other f eatures that can be on and oﬀ on diﬀerent

cURLpps.

2.4 Por tabl e Code in a Portable World

The people behind libcurl have put a considerable eﬀort to make libcurl work

on a large number of diﬀerent operating systems and environments.

You program cURLpp the same way on all platforms that cURLpp runs

on. There are only very few minor considerations that diﬀer. If you make sure

just to write your code portably enough, you may very well create yourself a

very portable program. cURLpp shouldn’t stop you from that.

3 Global Preparation

The program must initialize some of the cURLpp functionality globally. That

means it should be done exactly once, no matter how many times you intend

to use the library. Once for your program’s entire lifetime. This is done using

cURLpp::initialize( long flags = cURLpp::CURL_GLOBAL_ALL )

and it takes one parameter which is a bit pattern that tells cURLpp what

to intialize. Check the man page of curl_global_init for more details on

ﬂags.

When the program no longer uses cURLpp, it should call cURLpp::terminate(),

which is the opposite of the init call. It will then do the op erations needed

to cleanup the resources that the cURLpp::initialize() call initialized.

Repeated calls to cURLpp::initialize() and cURLpp::terminate()

must not be made. They must only be called once each. The cURLpp::Cleanup

class can be used to do this. It w ill call the cURLpp::initialize() func-

tion in its constructor and cURLpp::terminate() in its destructor. Check

example01.cpp in the examples/ directory of the source distribution for an

example.

4 Handle the Easy cURLpp

To use the easy interface, you must ﬁrst create yourself an easy handle. You

need one handle for each easy session you want to perform. Basically, you

should use one handle for every thread you plan to use for transferring. You

must never share the same handle in multiple threads.

Get an easy handle with

cURLpp::Easy easyhandle;

This creates an easy handle. Using that you proceed to the next step:

setting up your preferred actions. A handle is just a logic entity for the

upcoming transfer or series of transfers. You can use it to do HTTP or FTP

requests.

You set properties and options for this handle using cURLpp::Options,

or cURLpp::OptionList classes; we will discuss cURLpp::OptionList later.

They control how the subsequent transfer or transfers will be made. Options

remain set in the handle until set again to something diﬀerent. Alas, multiple

requests using the same handle will use the same options.

Many of the informationals you set in cURLpp are C++standard library

strings. Keep in mind that when you set strings with member functions,

cURLpp will copy the data. It will not merely point to the data. You don’t

need to make sure that the data remains available for cURLpp.

One of the most basic properties to set in the handle is the URL. You set

your preferred URL to transfer with a void cURLpp::Options::Url(const char *link)

option class, in a manner similar to:

easyhandle.setOpt(cURLpp::Options::Url("http://example.com/"));

There are of course many more options you can set, and we’ll get back to

a few of them later. Let’s instead continue to the actual transfer:

easyhandle.perform();

The cURLpp::Easy::perform() will connect to the remote site, do the

necessary commands and receive the transfer. Whenever it receives data, it

calls the trait function we previously set. The function may get one byte at

a time, or it may get many kilobytes at once. cURLpp delivers as much as

possible as often as possible. Your trait function should return the number

of bytes it ”took care of”. If that is not the exact same amount of bytes that

was passed to it, cURLpp will abort the operation and throw an exception.

When the transfer is complete, the function throws a cURLpp::Exception

if it doesn’t succeed in its mission. the const char *cURLpp::Exception::what()

will return the human readable reason of failure.

5 Wrapping libcurl

As previously said, cURLpp is just a C++libcurl wrapper. It wouldn’t be a

good idea to reproduce here, in this project, all the libcurl documentation.

This means that when you will be programming with cURLpp, you will refer

more to libcurl’s documentation than to cURLpp’s. We will explain here how

cURLpp wraps libcurl, so you will able to use it, without constantly refering

to its manual.

First, you must know that there are two main things that constitute

cURLpp: There are its options value setting/retrieving behavior and its util-

ities that helps you to use libcurl’s options more easily.

5.1 Option setting/retrieving

The main feature of cURLpp is that you can retrieve options previously set

on handles. cURLpp gives you the opportunity to retrieve options values

that were previously set on a speciﬁc handle and then use them again for

other handles. But ﬁrst, let’s show you how to set an option on a handle, in

comparison to libcurl’s way of setting an option.

libcurl sets options on handles with this function:

curl_easy_setopt(CURL *handle, CURLoption option, parameter)

Here’s a part of the documentation taken from the man pages:

评论收藏

内容反馈

m420092

2012-10-02

代码有效可用

心中有码

粉丝: 6
资源: 106

curlpp-0.7.2.tar.gz

curlpp-开源

curlpp的代码

curl-7.33.0_VC2010编译附加curlpp

PyPI 官网下载 | openmetadata-ingestion-0.7.2.tar.gz

libpcap-0.7.2.tar.gz

pip-0.7.2.tar.gz

Python库 | sfsimodels-0.7.2.tar.gz

dstat-0.7.2.zip

librosa-0.7.2.tar.gz

PDFBox-0.7.2.jar

prettytable-0.7.2.tar.bz2

xlrd-0.7.2.tar.gz

fpconst-0.7.2.tar.gz

requests-0.7.2.tar.gz

PyPI 官网下载 | tsc-auto-0.7.2.tar.gz

Python库 | jirafs-0.7.2.tar.gz

PyPI 官网下载 | logit-0.7.2.tar.gz

PyPI 官网下载 | transifex-0.7.2.tar.gz

PyPI 官网下载 | caffoa-0.7.2.tar.gz

PyPI 官网下载 | tehran-stocks-0.7.2.tar.gz

PyPI 官网下载 | aino-utkik-0.7.2.tar.gz

PyPI 官网下载 | pylustrator-0.7.2.tar.gz

PyPI 官网下载 | gaw-0.7.2.tar.gz

PyPI 官网下载 | grafana_api-0.7.2.tar.gz

PyPI 官网下载 | discretisedfield-0.7.2.tar.gz

PyPI 官网下载 | teamvault-0.7.2.tar.gz

python-prettytable-0.7.2-3.el7.noarch.rpm

PyPI 官网下载 | checkpkgaudit-0.7.2.tar.gz

dstat-0.7.2-1.el6.rfx.noarch.rpm

yasm-0.7.2.tar.gz

最新资源