【C++】POCO学习总结（十三）：类型和字节序、错误处理和调试、获取系统信息

【C++】郭老二博文之：C++目录

1、类型

POCO为固定大小的整数定义了类型
头文件：#include “Poco/Types.h”

• Poco::Int8
• Poco::Int16,
• Poco::Int32,
• Poco::Int64
• Poco::UInt8
• Poco::UInt16
• Poco::UInt32
• Poco::UInt64
• Poco::IntPtr, Poco::UIntPtr:与指针大小相同的整数(32 or 64 bits)

2、long类型和指针类型

POCO有两个宏来确定long类型和指针类型的大小。
如果指针为64位，则有宏定义：POCO_PTR_IS_64_BIT，否则无
如果long为64位，则有宏定义：POCO_LONG_IS_64_BIT，否则无

3、Poco::ByteOrder 字节序

3.1 本机字节序

POCO使用宏来确定当前主机的字节顺序:

• POCO_ARCH_LITTLE_ENDIAN：如果本机是小端序
• POCO_ARCH_BIG_ENDIAN：如果本机是大端序

3.2 字节序转换

类Poco::ByteOrder提供了字节顺序转换的静态方法。
所有功能均可用于：Int16, UInt16, Int32, UInt32, Int64, UInt64

• IntXX flipBytes(IntXX value)：将字节顺序从大端改为小端，反之亦然
• IntXX toBigEndian(IntXX value)：将主机字节序转换为大端
• IntXX toLittleEndian(IntXX value)：将主机字节序转换为小端
• IntXX fromBigEndian(IntXX value)：从大端字节序转换为主机字节序
• IntXX fromLittleEndian(IntXX value)：将小端字节序转换为主机字节序
• IntXX tonnetwork (IntXX值)：将主机字节序转换为网络字节序
• IntXX fromNetwork(IntXX value)：将网络字节顺序转换为主机字节顺序
• 网络字节顺序为大端

3.3 示例

vi ByteOrderTest.cpp

#include "Poco/ByteOrder.h"
#include <iostream>
using Poco::ByteOrder;
using Poco::UInt16;
int main(int argc, char** argv)
{
	#ifdef POCO_ARCH_LITTLE_ENDIAN
	std::cout << "little endian" << std::endl;
	#else
	std::cout << "big endian" << std::endl;
	#endif
	UInt16 port = 80;
	UInt16 networkPort = ByteOrder::toNetwork(port);
	return 0;
}

编译：

g++ ByteOrderTest.cpp -I ~/git/poco/install/include -L ~/git/poco/install/lib -lPocoFoundationd

输出：（大部分电脑都是小端）

little endian

4、Poco::Any 任意类型

4.1 说明

Poco::Any的实例可以保存任何内置或用户定义类型的值。
Poco: Any支持值语义。
该值可以通过类型安全的方式提取。
必须知道值的类型才能提取它。
Poco::AnyCast()和Poco::RefAnyCast()函数模板用于提取值。

4.2 示例

vi any.cpp

#include "Poco/Any.h"
#include "Poco/Exception.h"
#include <iostream>

using Poco::Any;
using Poco::AnyCast;
using Poco::RefAnyCast;

int main(int argc, char** argv)
{
	Any any(42);
	int i = AnyCast<int>(any); // okay
	int& ri = RefAnyCast<int>(any); // okay
	std::cout << "i = " << i << "; ri = " << ri << std::endl;

	try
	{
		short s = AnyCast<short>(any); // throws BadCastException
	}
	catch (Poco::BadCastException&)
	{
		std::cout << "BadCastException" << std::endl;
	}
	return 0;
}

编译：

g++ any.cpp -I ~/git/poco/install/include -L ~/git/poco/install/lib -lPocoFoundationd

输出：

i = 42; ri = 42
BadCastException

5、Poco::DynamicAny 动态任意类型

5.1 说明

头文件：#include “Poco/DynamicAny.h”
Poco::DynamicAny的实例可以保存动态任意类型的值。
Poco::DynamicAny支持值语义。
该值可以通过类型安全的方式提取。
支持各种类型(标准类型，std::string)的安全隐式和显式转换(检查范围)。

注意事项：（禁止数字值的数据丢失）

• value < 0永远不会转换为unsigned类型
• value需要x位，永远不会转换为更小的位范围(例如:value = 2000，需要16位，禁止转换为8位)
• 允许从int到float再返回的精度损失
• 允许字符串截断(字符串为单个字符)

5.2 示例

vi dany.cpp

#include "Poco/DynamicAny.h"
#include "Poco/Exception.h"
#include <iostream>
using Poco::DynamicAny;

int main(int argc, char** argv)
{
	DynamicAny any(42);
	int i = any;
	std::string s(any.convert<std::string>());
	std::cout << "i = " << i << "; s = " << s << std::endl;
	any.convert(s); // or without the need to cast
	const int& ri(any.extract<int>());
	short ss = any;
	std::cout << "ri = " << ri << "; ss = " << ss << std::endl;

	try
	{
		short s = any.extract<short>(); // throws BadCastException
	}
	catch (Poco::BadCastException&)
	{
		std::cout << "BadCastException" << std::endl;
	}
	return 0;
}

编译：

g++ dany.cpp -I ~/git/poco/install/include -L ~/git/poco/install/lib -lPocoFoundationd

输出：

i = 42; s = 42
ri = 42; ss = 42
BadCastException

6、异常

6.1 说明

所有POCO异常都是POCO::Exception的子类，Poco::Exception派生自std:: Exception。
头文件：#include “Poco/Exception.h”
比如：

• Poco::LogicException ：逻辑错误
• Poco::RuntimeException：运行错误
• Poco::ApplicationException：应用级错误

每个Poco::Exception都有一个name名字、message(描述异常的原因)、可选的嵌套异常

6.2 常用函数

• const char* name() const ：返回异常的名称
• std::string& message() const：返回构造函数传递的消息文本
• std::string displayText() const：返回名称和消息文本，以":"分隔
• const Exception* nested() const：返回一个指向嵌套异常的指针，如果没有则返回0
• Exception* clone() const：返回异常的精确副本
• void rethrow() const：重新抛出异常

6.3 自定义异常

POCO_DECLARE_EXCEPTION：声明异常类
POCO_IMPLEMENT_EXCEPTION：实现异常类

// MyException.h
#include “Poco/Exception.h”
POCO_DECLARE_EXCEPTION(MyLib_API, MyException, Poco::Exception)

// MyException.cpp
#include “MyException.h”
POCO_IMPLEMENT_EXCEPTION(MyException, Poco::Exception, “Something really bad happened…”)

7、断言

运行时检查的宏

• poco_assert(cond)：如果cond≠true，抛出AssertionViolationException
• poco_assert_dbg(cond)：类似于poco_assert，但仅在调试版本中使用
• poco_check_ptr(ptr)：如果ptr为空，抛出NullPointerException
• poco_bugcheck(), poco_bugcheck_msg(string)：抛出BugcheckException

8、调试

1）在调试构建中，可以使用宏poco_debugger()和poco_debugger_msg(message)强制设置断点(如果代码在调试器的控制下运行)。
2）poco_assert、poco_check_ptr和poco_bugcheck在调试和发布版本中都是启用的。在调试版本中，如果调试器可用，则在抛出异常之前触发断点。
3）poco_assert_dbg和poco_debugger仅在调试版本中启用。
4）使用bool Debugger::isAvailable()检查是否在调试器下运行。
5）使用void Debugger::enter()强制一个断点。
6）使用void Debugger::message()将消息写入调试器日志或标准输出。

9、编译时获取系统信息

9.1 POCO_OS 平台相关的宏

头文件：Poco/Platform.h
POCO_OS宏可用于确定操作系统。它将有以下值之一:
POCO_OS_AIX
POCO_OS_LINUX
POCO_OS_SOLARIS
POCO_OS_CYGWIN
POCO_OS_MAC_OS_X
POCO_OS_TRU64
POCO_OS_FREE_BSD
POCO_OS_NET_BSD
POCO_OS_VMS
POCO_OS_HPUX
POCO_OS_OPEN_BSD
POCO_OS_VXWORKS
POCO_OS_IRIX
POCO_OS_QNX
POCO_OS_WINDOWS_NT

Windows平台：POCO_OS_FAMILY_WINDOWS
Unix平台：POCO_OS_FAMILY_UNIX

9.2 POCO_ARCH 硬件相关的宏

POCO_ARCH宏可用于确定硬件体系结构。它将有以下值之一:
POCO_ARCH_ALPHA
POCO_ARCH_IA64： Intel 64-bit
POCO_ARCH_AMD64
POCO_ARCH_MIPS
POCO_ARCH_ARM
POCO_ARCH_POWER
POCO_ARCH_HPPA
POCO_ARCH_PPC
POCO_ARCH_IA32 ： Intel 32-bit
POCO_ARCH_SPARC

9.3 大小端

POCO_ARCH_LITTLE_ENDIAN：架构是小端序
POCO_ARCH_BIG_ENDIAN：架构是大端序

10、运行时的系统信息

Poco::Environment的静态函数，用于在运行时确定系统和环境信息。
头文件：#include “Poco/Environment.h”

• std::string get(const Std::string& name)：返回环境变量的值，如果变量未定义，抛出Poco::NotFoundException。
• bool has(const std::string& name)：检查是否定义了环境变量。
• void set(const std::string& name, const std::string& value)：设置环境变量的值。
• std:: string osName ()：返回操作系统的名称(uname)。
• std::string osVersion()：返回操作系统的版本(uname -r)。
• std::string osArchitecture()：返回描述硬件架构的字符串(uname -m)。
• std::string nodeName()：返回计算机名(uname -n)。类似Poco::DNS::hostName()
• std:: string nodeId ()：返回在系统上找到的第一个以太网适配器的以太网地址，格式为xx:xx:xx:xx:xx(如果没有以太网适配器，则返回全零)。

#include "Poco/Environment.h"
#include <iostream>
using Poco::Environment;
int main(int argc, char** argv)
{
	std::cout 
	<< "OS Name: " << Environment::osName() << std::endl
	<< "OS Version: " << Environment::osVersion() << std::endl
	<< "OS Arch: " << Environment::osArchitecture() << std::endl
	<< "Node Name: " << Environment::nodeName() << std::endl
	<< "Node ID: " << Environment::nodeId() << std::endl;
	if (Environment::has("HOME"))
		std::cout << "Home: " << Environment::get("HOME") << std::endl;
	Environment::set("POCO", "foo");
	return 0;
}

编译：

g++ e.cpp -I ~/git/poco/install/include -L ~/git/poco/install/lib -lPocoFoundationd

输出：

OS Name: Linux
OS Version: 6.2.0-37-generic
OS Arch: x86_64
Node Name: laoer-VirtualBox
Node ID: 08:00:27:ad:b1:7a
Home: /home/laoer