Friday, May 23, 2008

Boost.Asio vs Asio

Sometimes I am asked what the difference is between the (non-Boost) Asio and Boost.Asio packages I provide. Here is the definitive word on the subject, presented as a series of questions and answers.

What are the differences in the source code?

— Asio is in a namespace called asio::, whereas Boost.Asio puts everything under boost::asio::.

— The main Asio header file is called asio.hpp. The corresponding header in Boost.Asio is boost/asio.hpp. All other headers are similarly changed.

— Any macros used by or defined in Asio are prefixed with ASIO_. In Boost.Asio they are prefixed with BOOST_ASIO_.

— Asio includes a class for launching threads, asio::thread. Boost.Asio does not include this class, to avoid overlap with the Boost.Thread library

— Boost.Asio uses the Boost.System library to provide support for error codes (boost::system::error_code and boost::system::system_error). Asio includes these under its own namespace (asio::error_code and asio::system_error). The Boost.System version of these classes currently supports better extensibility for user-defined error codes.

— Asio is header-file-only and for most uses does not require linking against any Boost library. Boost.Asio always requires that you link against the Boost.System library, and also against Boost.Thread if you want to launch threads using boost::thread.

Where do I get a release package?

Asio is available for download from sourceforge, in a package named asio-X.Y.Z.tar.gz (or .tar.bz2 or .zip).

Boost.Asio is included in the Boost 1.35 distribution. It is also available as a separate package on sourceforge, named boost_asio_X_Y_Z.tar.gz. The latter is intended to be copied over the top of an existing Boost source code distribution.

Where are the source code repositories?

Asio uses a sourceforge-hosted CVS repository. Details of how to access it may be found here. It may also be browsed via the web.

Boost.Asio is checked into Boost's subversion repository.

How do you maintain both versions?

All development is done in the Asio CVS repository. I periodically convert the source into Boost format using a script called boostify.pl, and merge the changes into the Boost subversion repository.

Will Asio be discontinued now that Boost.Asio is included with Boost?

No. There are projects using Asio and they will continue to be supported. I also prefer to use Asio over Boost.Asio in my own projects, for the convenience of header-file-only and shorter namespaces.

Should I use Asio or Boost.Asio?

It depends. Here are some things to consider:

— If you (like me) prefer the convenience of header-file-only libraries then I'd suggest using Asio over Boost.Asio.

— If you must use a version of Boost older than 1.35 then Boost.Asio is not included. You can use Boost.Asio by copying it over the top of your Boost distribution (see above), but not everyone is comfortable doing this. In that case, I would suggest using Asio over Boost.Asio.

— I will be creating new versions of both the Asio and Boost.Asio packages on a faster release cycle than that followed by Boost. If you want to use the latest features you can still use Boost.Asio as long as you are happy to copy it over the top of your Boost distribution. If you don't want to do this, use Asio rather than Boost.Asio.

Can Asio and Boost.Asio coexist in the same program?

Yes. Since they use different namespaces there should be no conflicts, although obviously the types themselves are not interchangeable. (In case you're wondering why you might want to do this, consider a situation where a program is using third party libraries that are also using Asio internally.)

11 comments:

Anonymous said...

Chris,

Can you get us an example code to do two-way Handshaking in ssl. The example code in boost.org has only server authentication. How to do both server and client authentication.

Thanks and Regards,
Brown

Andy Webber said...

It seems that think-async.com is down at this point. Are you removing support for the non-boost library?

Anna Schafer said...

We are offering an elo boost service for the game league of legends, so we help our customers to get an higher elo on this game by playiing with them or by playing on their account.elo boost

Unknown said...

I would but say to you all "impressive information" ELO Job

daren sammy said...

Recent times when net has so often gossip mongering and clog; your proportion really refreshes me. wp themes

Victor Vaden said...

Why hello there ?! A cheap but professional pay for essay writing service, has been offering essay writers for hire to busy and exhausted students since approximately 2017. There you could always count on a cheap service that can live up to all your expectations.

Bob Heist said...

Finest plus Least expensive Jabodetabek Personal Instruction, all of our workers in addition to educators can come home, arranged your very own analysis program and might pick out virtually any arena with review ... go to https://kursus-akuntansi.netlify.app/kursus-akuntansi-pejaten.html for more information

goldyyy said...

No matter what you are up to, a huge party your friend throws, a movie night or a date, you can have it all essay proofreader online. We’ll take care of your assignment.

idadalton said...

Writing articles describing the advantages of playing at immersive roulette review casinos is one approach to establish a website as the finest in its industry. When people read this kind of content, they are more likely to go to casinos since they are aware of how the https://ratemycasino.ca/reviews/kahuna/ website may meet their demands.

Elmo Curro said...

Jabodetabek private tutoring services with teachers visiting the house. Above hundreds of active tutors are prepared to teach various skills and lessons for kids to adults ... visit https://kursus-jerman.vercel.app/kursus-bahasa-jerman-tangerang-selatan.html for more details

zbznfrpufl said...

In an try to draw gamers to their on line casino in Homburg, Germany, Francois and Louis Blanc remodeled the sport of roulette in 1843. They devised the single-zero set-up, which is still relevant within the French and European layouts, by eliminating the customary double-zero pocket and thereby enhancing the gambler’s possibilities. After taking control of the Monte Carlo Casino, Francois brought the sport to Monaco, and the rest is historical past. It may seem quite apparent, if a visit pin is well-made, it could be be} really troublesome to identify. As 카지노 사이트 the trip pin is situated on the aspect of the wheel, which is closest to the betting structure, it cannot be instantly observed by gamers at the table. The gap within the ball observe wall is usually minuscule, whereas the pin seems to be thinner than a six-inch sewing needle.