这是储存字符串的一组 API.
通过 AddAtom 储存一个字符串, 返回一个 ID;
GetAtomName 通过这个 ID 可返回储存的字符串;
还可以用 FindAtom 查找、用 DeleteAtom 删除已储存的字符串.

这个储存区有分本地(程序级)和全局(系统级)两种, 带 Global 前缀的是全局的[但在 Win32 下它们是否还有区别还有待考究].

表中的字符串不分大小写, 如果重名过来, 会增加一个 ID 引用, 但会使用最先来的字符串.
//声明:
AddAtom(
  lpString: PChar {串指针}
): ATOM;          {返回串ID}

DeleteAtom(
  nAtom: ATOM     {串ID}
): ATOM;          {返回串ID; 失败返回0}

FindAtom(
  lpString: PChar {串指针}
): ATOM;          {返回串ID; 失败返回0}

GetAtomName(
  nAtom: ATOM;    {串ID}
  lpBuffer: PChar;{缓冲区}
  nSize: Integer  {缓冲区大小}
): UINT;          {返回串实际长度; 失败返回0}

GlobalAddAtom(
  lpString: PChar {串指针}
): ATOM;          {返回串ID}

GlobalDeleteAtom(
  nAtom: ATOM     {串ID}
): ATOM;          {返回串ID; 失败返回0}

GlobalFindAtom(
  lpString: PChar {串指针}
): ATOM;          {返回串ID; 失败返回0}

GlobalGetAtomName(
  nAtom: ATOM;    {串ID}
  lpBuffer: PChar;{缓冲区}
  nSize: Integer  {缓冲区大小}
): UINT;          {返回串实际长度; 失败返回0}

//举例: var n1,n2: ATOM; ps: array[0..254] of Char; begin n1 := AddAtom('万一的 Delphi 博客'); n2 := AddAtom('万一的 DELPHI 博客'); GetAtomName(n1, ps, 255); ShowMessage(ps); {万一的 Delphi 博客} GetAtomName(n2, ps, 255); ShowMessage(ps); {万一的 Delphi 博客} end;
posted on 2008-02-28 16:57 万一 阅读(472) 评论(4)  编辑 收藏 网摘 所属分类: API 未归类函数


FeedBack:
#1楼  2008-02-28 18:14 迷惑 [未注册用户]
atom到底是什么东东,为什么要用“原子”这个词呀
  回复  引用    
#2楼 [楼主] 2008-02-28 18:22 万一      
在 Windows 中指针可以指向的东西很多, 指针指向的最小的东西可能就是一串字符了吧. 
或许因此微软就叫它原子, 这有序的一组就叫原子表. 
我猜的, 别当真.
  回复  引用  查看    
#3楼  2008-05-29 14:54 wen_jie [未注册用户]
求教楼主 
ATOM用在那些地方? 
比如? 

  回复  引用    
#4楼 [楼主] 2008-05-29 15:16 万一      
@wen_jie: 
Delphi 的 TStringList、THashedStringList 或者数组, 可以完成同样的工作, 且功能强大, 所以在 Delphi 中一般不会用到 Atom. 
不过 Atom 是可以支持双字节的, 譬如: AddAtomW(); GetAtomNameW();
  回复  引用  查看