GetUid.3
上传用户:rrhhcc
上传日期:2015-12-11
资源大小:54129k
文件大小:2k
源码类别:

通讯编程

开发平台:

Visual C++

  1. '"
  2. '" Copyright (c) 1990 The Regents of the University of California.
  3. '" Copyright (c) 1994-1996 Sun Microsystems, Inc.
  4. '"
  5. '" See the file "license.terms" for information on usage and redistribution
  6. '" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
  7. '" 
  8. '" RCS: @(#) $Id: GetUid.3,v 1.2.26.2 2004/02/17 13:47:18 dkf Exp $
  9. '" 
  10. .so man.macros
  11. .TH Tk_GetUid 3 "" Tk "Tk Library Procedures"
  12. .BS
  13. .SH NAME
  14. Tk_GetUid, Tk_Uid - convert from string to unique identifier
  15. .SH SYNOPSIS
  16. .nf
  17. fB#include <tk.h>fR
  18. .sp
  19. Tk_Uid
  20. fBTk_GetUidfR(fIstringfR)
  21. .SH ARGUMENTS
  22. .AP char *string in
  23. String for which the corresponding unique identifier is
  24. desired.
  25. .BE
  26. .SH DESCRIPTION
  27. .PP
  28. fBTk_GetUidfR returns the unique identifier corresponding
  29. to fIstringfR.
  30. Unique identifiers are similar to atoms in Lisp, and are used
  31. in Tk to speed up comparisons and
  32. searches.  A unique identifier (type Tk_Uid) is a string pointer
  33. and may be used anywhere that a variable of type ``char *''
  34. could be used.  However, there is guaranteed to be exactly
  35. one unique identifier for any given string value.  If fBTk_GetUidfR
  36. is called twice, once with string fIafR and once with string
  37. fIbfR, and if fIafR and fIbfR have the same string value
  38. (strcmp(a, b) == 0), then fBTk_GetUidfR will return exactly
  39. the same Tk_Uid value for each call (Tk_GetUid(a) == Tk_GetUid(b)).
  40. This means that variables of type
  41. Tk_Uid may be compared directly (x == y) without having to call
  42. fBstrcmpfR.
  43. In addition, the return value from fBTk_GetUidfR will have the
  44. same string value as its argument (strcmp(Tk_GetUid(a), a) == 0).
  45. .SH KEYWORDS
  46. atom, unique identifier