"
COPYRIGHT (c) 1997 by eXept Software AG / Claus Gittinger
All Rights Reserved
This software is furnished under a license and may be used
only in accordance with the terms of that license and with the
inclusion of the above copyright notice. This software may not
be provided or otherwise made available to, or used by, any
other person. No title to or ownership of the software is
hereby transferred.
"
"{ Package: 'stx:libbasic' }"
Block variableSubclass:#VarArgBlock
instanceVariableNames:''
classVariableNames:''
poolDictionaries:''
category:'Kernel-Methods'
!
!VarArgBlock class methodsFor:'documentation'!
copyright
"
COPYRIGHT (c) 1997 by eXept Software AG / Claus Gittinger
All Rights Reserved
This software is furnished under a license and may be used
only in accordance with the terms of that license and with the
inclusion of the above copyright notice. This software may not
be provided or otherwise made available to, or used by, any
other person. No title to or ownership of the software is
hereby transferred.
"
!
documentation
"
VarArgBlocks are much like blocks, but can accept a variable
number of arguments. They must be defined as a regular block,
with 1 argument. When executed, the actual argument list is
passed in that single argument (as a collection).
Create a variableArgument block by sending #asVarArgBlock to a regular
block.
This is a goody add-on, which may not be available/possible in other
smalltalk implementations. Do not use it if cross-platform
portability is required.
[author:]
Claus Gittinger
[see also:]
Block
"
!
examples
"
the same block, evaluated with 2 or 5 arguments:
[exBegin]
|b|
b := [:args | Transcript show:'wow: '; showCR:args] asVarArgBlock.
b value:'hi' value:'there'.
b value:'hello' value:'there' value:'how' value:'about' value:'this'.
[exEnd]
does it accept a variable number of arguments ?:
[exBegin]
|b|
b := [:args | Transcript showCR:args].
Transcript showCR:(b isVarArgBlock).
b := [:args | Transcript showCR:args] asVarArgBlock.
Transcript showCR:(b isVarArgBlock)
[exEnd]
"
"Created: 23.1.1997 / 04:57:26 / cg"
! !
!VarArgBlock class methodsFor:'initialization'!
initialize
"must clear the is-block flag bit in the class
(otherwise, the VM might try to inline value-messages)"
|newFlags|
newFlags := (self flags
bitClear:(Behavior flagBlock))
bitOr:(Behavior flagBlockLike).
self flags:newFlags.
"
self flags.
self initialize.
self flags.
"
! !
!VarArgBlock methodsFor:'evaluation'!
value
"evaluate the receiver with no block args."
^ super value:#()
"Created: 23.1.1997 / 04:57:49 / cg"
!
value:arg
"evaluate the receiver with a single argument."
^ super value:(Array with:arg)
"Created: 23.1.1997 / 04:57:57 / cg"
!
value:arg1 value:arg2
"evaluate the receiver with two arguments."
^ super value:(Array with:arg1 with:arg2)
"Created: 23.1.1997 / 04:58:03 / cg"
!
value:arg1 value:arg2 value:arg3
"evaluate the receiver with three arguments."
^ super value:(Array with:arg1 with:arg2 with:arg3)
"Created: 23.1.1997 / 04:58:09 / cg"
!
value:arg1 value:arg2 value:arg3 value:arg4
"evaluate the receiver with four arguments."
^ super value:(Array
with:arg1
with:arg2
with:arg3
with:arg4)
"Modified: 22.1.1997 / 19:41:22 / cg"
"Created: 23.1.1997 / 04:58:14 / cg"
!
value:arg1 value:arg2 value:arg3 value:arg4 value:arg5
"evaluate the receiver with five arguments."
^ super value:(Array
with:arg1
with:arg2
with:arg3
with:arg4
with:arg5)
"Modified: 22.1.1997 / 19:41:26 / cg"
"Created: 23.1.1997 / 04:58:18 / cg"
!
value:arg1 value:arg2 value:arg3 value:arg4 value:arg5 value:arg6
"evaluate the receiver with six arguments."
^ super value:(Array
with:arg1
with:arg2
with:arg3
with:arg4
with:arg5
with:arg6)
"Modified: 22.1.1997 / 19:41:29 / cg"
"Created: 23.1.1997 / 04:58:22 / cg"
!
value:arg1 value:arg2 value:arg3 value:arg4 value:arg5 value:arg6 value:arg7
"evaluate the receiver with seven arguments."
^ super value:(Array
with:arg1
with:arg2
with:arg3
with:arg4
with:arg5
with:arg6
with:arg7)
"Modified: 22.1.1997 / 19:41:33 / cg"
"Created: 23.1.1997 / 04:58:26 / cg"
!
value:arg1 value:arg2 value:arg3 value:arg4 value:arg5 value:arg6 value:arg7 value:arg8
"evaluate the receiver with eight arguments."
^ super value:(Array
with:arg1
with:arg2
with:arg3
with:arg4
with:arg5
with:arg6
with:arg7
with:arg8)
"Created: 23.1.1997 / 04:58:30 / cg"
!
valueWithArguments:argArray
"evaluate the receiver with all arguments in argArray."
^ super value:argArray
"Created: 23.1.1997 / 04:59:16 / cg"
! !
!VarArgBlock methodsFor:'testing'!
isVarArgBlock
"return true, if this block accepts a variable number of arguments"
^ true
"Created: 23.1.1997 / 05:00:18 / cg"
! !
!VarArgBlock class methodsFor:'documentation'!
version
^ '$Header: /cvs/stx/stx/libbasic/VarArgBlock.st,v 1.8 2013-04-16 12:44:14 cg Exp $'
! !
VarArgBlock initialize!