BSTRING.3
上传用户:jnzhq888
上传日期:2007-01-18
资源大小:51694k
文件大小:2k
源码类别:

操作系统开发

开发平台:

WINDOWS

  1. ." Copyright (c) 1983 Regents of the University of California.
  2. ." All rights reserved.  The Berkeley software License Agreement
  3. ." specifies the terms and conditions for redistribution.
  4. ."
  5. ." @(#)bstring.3 6.1 (Berkeley) 5/15/85
  6. ."
  7. .TH BSTRING 3  "May 15, 1985"
  8. .UC 5
  9. .SH NAME
  10. bstring, bcopy, bcmp, bzero, ffs - bit and byte string operations
  11. .SH SYNOPSIS
  12. .nf
  13. .ft B
  14. #include <sys/types.h>
  15. #include <string.h>
  16. #include <unistd.h>
  17. void bcopy(const void *fIsrcfP, void *fIdstfP, size_t fIlengthfP)
  18. int bcmp(const void *fIb1fP, const void *fIb2fP, size_t fIlengthfP)
  19. void bzero(void *fIdstfP, size_t fIlengthfP)
  20. int ffs(int fIifP)
  21. .ft R
  22. .fi
  23. .SH DESCRIPTION
  24. The functions
  25. .BR bcopy ,
  26. .BR bcmp ,
  27. and
  28. .B bzero
  29. operate on variable length strings of bytes.
  30. They do not check for null bytes as the routines in
  31. .BR string (3)
  32. do.
  33. .PP
  34. .B Bcopy
  35. copies 
  36. .I length
  37. bytes from string
  38. .I src
  39. to the string
  40. .IR dst .
  41. .PP
  42. .B Bcmp
  43. compares byte string
  44. .I b1
  45. against byte string
  46. .IR b2 ,
  47. returning zero if they are identical,
  48. non-zero otherwise.  Both strings are
  49. assumed to be
  50. .I length
  51. bytes long.
  52. .PP
  53. .B Bzero
  54. places
  55. .I length
  56. 0 bytes in the string
  57. .IR b1 .
  58. .PP
  59. .B Ffs
  60. find the first bit set in the argument passed it and
  61. returns the index of that bit.  Bits are numbered
  62. starting at 1.  A return value of 0 indicates the
  63. value passed is zero.
  64. .SH BUGS
  65. The
  66. .BR bcopy ,
  67. .BR bcmp ,
  68. and
  69. .BR bzero
  70. functions are obsolete; new code should use
  71. .BR memmove ,
  72. .BR memcmp ,
  73. and
  74. .BR memset
  75. respectively.
  76. .PP
  77. The
  78. .B bcopy
  79. routine takes parameters backwards from
  80. .BR memcpy ,
  81. .BR memmove ,
  82. and
  83. .BR strcpy .