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

通讯编程

开发平台:

Visual C++

  1. '"
  2. '" Copyright (c) 1993 The Regents of the University of California.
  3. '" Copyright (c) 1994-1996 Sun Microsystems, Inc.
  4. '" Copyright (c) 2001 Kevin B. Kenny.  All rights reserved.
  5. '"
  6. '" See the file "license.terms" for information on usage and redistribution
  7. '" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
  8. '" 
  9. '" RCS: @(#) $Id: lrange.n,v 1.6.4.1 2004/10/27 12:52:40 dkf Exp $
  10. '" 
  11. .so man.macros
  12. .TH lrange n 7.4 Tcl "Tcl Built-In Commands"
  13. .BS
  14. '" Note:  do not modify the .SH NAME line immediately below!
  15. .SH NAME
  16. lrange - Return one or more adjacent elements from a list
  17. .SH SYNOPSIS
  18. fBlrange fIlist first lastfR
  19. .BE
  20. .SH DESCRIPTION
  21. .PP
  22. fIListfR must be a valid Tcl list.  This command will
  23. return a new list consisting of elements
  24. fIfirstfR through fIlastfR, inclusive.
  25. fIFirstfR or fIlastfR
  26. may be fBendfR (or any abbreviation of it) to refer to the last
  27. element of the list.
  28. If fIfirstfR is less than zero, it is treated as if it were zero.
  29. If fIlastfR is greater than or equal to the number of elements
  30. in the list, then it is treated as if it were fBendfR.
  31. If fIfirstfR is greater than fIlastfR then an empty string
  32. is returned.
  33. Note: ``fBlrange fIlist first firstfR'' does not always produce the
  34. same result as ``fBlindex fIlist firstfR'' (although it often does
  35. for simple fields that aren't enclosed in braces); it does, however,
  36. produce exactly the same results as ``fBlist [lindex fIlist firstfB]fR''
  37. .SH EXAMPLES
  38. Selecting the first two elements:
  39. .CS
  40. % fBlrangefR {a b c d e} 0 1
  41. a b
  42. .CE
  43. .PP
  44. Selecting the last three elements:
  45. .CS
  46. % fBlrangefR {a b c d e} end-2 end
  47. c d e
  48. .CE
  49. .PP
  50. Selecting everything except the first and last element:
  51. .CS
  52. % fBlrangefR {a b c d e} 1 end-1
  53. b c d
  54. .CE
  55. .PP
  56. Selecting a single element with fBlrangefR is not the same as doing
  57. so with fBlindexfR:
  58. .CS
  59. % set var {some {elements to} select}
  60. some {elements to} select
  61. % lindex $var 1
  62. elements to
  63. % fBlrangefR $var 1 1
  64. {elements to}
  65. .CE
  66. .SH "SEE ALSO"
  67. .VS 8.4
  68. list(n), lappend(n), lindex(n), linsert(n), llength(n), lsearch(n), 
  69. lset(n), lreplace(n), lsort(n)
  70. .VE
  71. .SH KEYWORDS
  72. element, list, range, sublist