Foxit PDF SDK

Public 成员函数 | 所有成员列表
CFX_CMapByteStringToPtr类 参考
FXCRT

继承自 CFX_Object .

## Public 成员函数
| CFX_CMapByteStringToPtr (IFX_Allocator *pAllocator=0)
| 构造函数。 更多...
| ~CFX_CMapByteStringToPtr ()
| 析构函数。
void | AddValue (FX_BSTR key, void *pValue)
| 向字典添加键值对，假定不存在重复键。 更多...
int | GetCount () const
| 获取键值对的数量。 更多...
void | GetNextAssoc (FX_POSITION &rNextPosition, CFX_ByteString &rKey, void *&rValue) const
| 获取当前关联并将位置设置为下一个关联。 更多...
FX_LPVOID | GetNextValue (FX_POSITION &rNextPosition) const
| 获取当前值并将位置设置为下一个关联。 更多...
FX_POSITION | GetStartPosition () const
| 获取第一个键值对位置。用于遍历所有(键, 值)对。 更多...
FX_BOOL | Lookup (FX_BSTR key, void *&rValue) const
| 通过键查找。 更多...
void | RemoveAll ()
| 移除映射中的所有键值对。 更多...
void | RemoveKey (FX_BSTR key)
| 移除现有的(键, ?)对。 更多...
void | SetAt (FX_BSTR key, void *value)
| 添加新的(键, 值)对。如果不存在则添加，否则修改。 更多...

## 详细描述

从字节字符串到指针的紧凑映射。
在以下情况下使用此类而不是CFX_MapByteStringToPtr：

- 映射数量大多有限，例如几十个映射；
- 映射键的长度大多有限，例如通常少于8个字符。

## 构造及析构函数说明

## ◆ CFX_CMapByteStringToPtr()

CFX_CMapByteStringToPtr::CFX_CMapByteStringToPtr | ( | IFX_Allocator * | pAllocator = `0` | ) |

构造函数。

参数

  [in] | pAllocator | 分配器。默认值：NULL。

## 成员函数说明

## ◆ AddValue()

void CFX_CMapByteStringToPtr::AddValue | ( | FX_BSTR | key,
|  | void * | pValue
| ) |  |

向字典添加键值对，假定不存在重复键。

这是快速构建整个字典的函数，但应谨慎使用。 如果发生重复键，只有第一个值将生效。

参数

  [in] | key | 要添加的键。
  [in] | pValue | 要添加的值。

返回
  无。

## ◆ GetCount()

int CFX_CMapByteStringToPtr::GetCount | ( |  | ) | const

获取键值对的数量。

返回
  映射中键值对的数量。

## ◆ GetNextAssoc()

void CFX_CMapByteStringToPtr::GetNextAssoc | ( | FX_POSITION & | rNextPosition,
|  | CFX_ByteString & | rKey,
|  | void *& | rValue
| ) |  | const

获取当前关联并将位置设置为下一个关联。

参数

  [in,out] | rNextPosition | 输入一个位置，并接收下一个关联位置作为结果。
  [out] | rKey | 接收键。
  [out] | rValue | 接收值。

返回
  无。

## ◆ GetNextValue()

FX_LPVOID CFX_CMapByteStringToPtr::GetNextValue | ( | FX_POSITION & | rNextPosition | ) | const

获取当前值并将位置设置为下一个关联。

参数

  [in,out] | rNextPosition | 输入一个位置，并接收下一个关联位置作为结果。

返回
  当前值。

## ◆ GetStartPosition()

FX_POSITION CFX_CMapByteStringToPtr::GetStartPosition | ( |  | ) | const

获取第一个键值对位置。用于遍历所有(键, 值)对。

返回
  映射中第一个键值对的位置。

## ◆ Lookup()

FX_BOOL CFX_CMapByteStringToPtr::Lookup | ( | FX_BSTR | key,
|  | void *& | rValue
| ) |  | const

通过键查找。

参数

  [in] | key | 要查找的键。
  [out] | rValue | 接收找到值的无类型指针的引用。

返回
  true表示找到键，false表示未找到键。

## ◆ RemoveAll()

void CFX_CMapByteStringToPtr::RemoveAll | ( |  | ) |

移除映射中的所有键值对。

返回
  无。

## ◆ RemoveKey()

void CFX_CMapByteStringToPtr::RemoveKey | ( | FX_BSTR | key | ) |

移除现有的(键, ?)对。

参数

  [in] | key | 要移除的键。

返回
  无。

## ◆ SetAt()

void CFX_CMapByteStringToPtr::SetAt | ( | FX_BSTR | key,
|  | void * | value
| ) |  |

添加新的(键, 值)对。如果不存在则添加，否则修改。

参数

  [in] | key | 指定位置的键。
  [in] | value | 新值。

返回
  无。