开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > Windows编程 > 通讯编程 > 查看源码
seek.n
资源名称：ns-allinone-2.33.tar.gz　[点击查看]
上传用户：rrhhcc
上传日期：2015-12-11
资源大小：54129k
文件大小：3k
源码类别：

通讯编程

开发平台：

Visual C++

seek.n：源码内容
  1. '"
  2. '" Copyright (c) 1993 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: seek.n,v 1.5.8.1 2004/10/27 14:23:58 dkf Exp $
  9. '" 
  10. .so man.macros
  11. .TH seek n 8.1 Tcl "Tcl Built-In Commands"
  12. .BS
  13. '" Note:  do not modify the .SH NAME line immediately below!
  14. .SH NAME
  15. seek - Change the access position for an open channel
  16. .SH SYNOPSIS
  17. fBseek fIchannelId offset fR?fIoriginfR?
  18. .BE
  20. .SH DESCRIPTION
  21. .PP
  22. Changes the current access position for fIchannelIdfR.
  23. .PP
  24. .VS
  25. fIChannelIdfR must be an identifier for an open channel such as a
  26. Tcl standard channel (fBstdinfR, fBstdoutfR, or fBstderrfR),
  27. the return value from an invocation of fBopenfR or fBsocketfR, or
  28. the result of a channel creation command provided by a Tcl extension.
  29. .VE
  30. .PP
  31. The fIoffsetfR and fIoriginfR
  32. arguments specify the position at which the next read or write will occur
  33. for fIchannelIdfR. fIOffsetfR must be an integer (which may be
  34. negative) and fIoriginfR must be one of the following:
  35. .TP 10
  36. fBstartfR
  37. The new access position will be fIoffsetfR bytes from the start
  38. of the underlying file or device.
  39. .TP 10
  40. fBcurrentfR
  41. The new access position will be fIoffsetfR bytes from the current
  42. access position; a negative fIoffsetfR moves the access position
  43. backwards in the underlying file or device.
  44. .TP 10
  45. fBendfR
  46. The new access position will be fIoffsetfR bytes from the end of
  47. the file or device.  A negative fIoffsetfR places the access position
  48. before the end of file, and a positive fIoffsetfR places the access
  49. position after the end of file.
  50. .LP
  51. The fIoriginfR argument defaults to fBstartfR.
  52. .PP
  53. The command flushes all buffered output for the channel before the command
  54. returns, even if the channel is in nonblocking mode.
  55. It also discards any buffered and unread input.
  56. This command returns an empty string.
  57. An error occurs if this command is applied to channels whose underlying
  58. file or device does not support seeking.
  59. .PP
  60. .VS 8.1
  61. Note that fIoffsetfR values are byte offsets, not character
  62. offsets.  Both fBseekfR and fBtellfR operate in terms of bytes,
  63. not characters, unlike fBreadfR.
  64. .VE 8.1
  65. .SH EXAMPLES
  66. Read a file twice:
  67. .CS
  68. set f [open file.txt]
  69. set data1 [read $f]
  70. fBseekfR $f 0
  71. set data2 [read $f]
  72. close $f
  73. # $data1 == $data2 if the file wasn't updated
  74. .CE
  75. .PP
  76. Read the last 10 bytes from a file:
  77. .CS
  78. set f [open file.data]
  79. # This is guaranteed to work with binary data but
  80. # may fail with other encodings...
  81. fconfigure $f -translation binary
  82. fBseekfR $f -10 end
  83. set data [read $f 10]
  84. close $f
  85. .CE
  87. .SH "SEE ALSO"
  88. file(n), open(n), close(n), gets(n), tell(n), Tcl_StandardChannels(3)
  89.  
  90. .SH KEYWORDS
  91. access position, file, seek