List of primitives
Last updated at 10:03 am UTC on 20 September 2022
The list of primitives is found in the VMMaker.oscog package
http://source.squeak.org/VMMaker/
StackInterpreter class>>#initializePrimitiveTable
initializePrimitiveTable
"This table generates a C function address table used in slowPrimitiveResponse along with dispatchFunctionPointerOn:in:"
"self initializePrimitiveTable"
"NOTE: The real limit here is 2047 because of the old method header layout but there is no point in going over the needed size"
MaxPrimitiveIndex := 576.
MaxQuickPrimitiveIndex := 519.
PrimNumberExternalCall := 117.
ExternalCallLiteralModuleNameIndex := 0.
ExternalCallLiteralFunctionNameIndex := 1.
ExternalCallLiteralFlagsIndex := 2.
ExternalCallLiteralTargetFunctionIndex := 3.
PrimNumberFFICall := 120.
PrimNumberDoPrimitive := 118.
PrimNumberDoExternalCall := 218.
PrimNumberNoContextSwitchMarker := 123.
PrimNumberUnwindMarker := 198.
PrimNumberHandlerMarker := 199.
SPURVM
ifTrue: "to allow vmParameterAt: to run on Smalltalk stack"
[PrimNumberVMParameter := 254]
ifFalse: "to implement isCodeCompactingPrimitiveIndex: on V3"
[PrimNumberInstVarAt := 73.
PrimNumberPerform := 83.
PrimNumberPerformWithArgs := 84.
PrimNumberShallowCopy := 148.
PrimNumberSlotAt := 173.
PrimNumberFlushExternalPrimitives := 570.
PrimNumberUnloadModule := 571].
PrimitiveTable := Array new: MaxPrimitiveIndex + 1.
self primitivesClass table: PrimitiveTable from:
#( "Integer Primitives (0-19)"
(0 0 "a.k.a. primitiveFail but faster because primitiveFail won't even be called")
(1 primitiveAdd)
(2 primitiveSubtract)
(3 primitiveLessThan)
(4 primitiveGreaterThan)
(5 primitiveLessOrEqual)
(6 primitiveGreaterOrEqual)
(7 primitiveEqual)
(8 primitiveNotEqual)
(9 primitiveMultiply)
(10 primitiveDivide)
(11 primitiveMod)
(12 primitiveDiv)
(13 primitiveQuo)
(14 primitiveBitAnd)
(15 primitiveBitOr)
(16 primitiveBitXor)
(17 primitiveBitShift)
(18 primitiveMakePoint)
(19 primitiveFail) "Guard primitive for simulation -- *must* fail"
"LargeInteger Primitives (20-37)"
(20 primitiveRemLargeIntegers)
(21 primitiveAddLargeIntegers)
(22 primitiveSubtractLargeIntegers)
(23 primitiveLessThanLargeIntegers)
(24 primitiveGreaterThanLargeIntegers)
(25 primitiveLessOrEqualLargeIntegers)
(26 primitiveGreaterOrEqualLargeIntegers)
(27 primitiveEqualLargeIntegers)
(28 primitiveNotEqualLargeIntegers)
(29 primitiveMultiplyLargeIntegers)
(30 primitiveDivideLargeIntegers)
(31 primitiveModLargeIntegers)
(32 primitiveDivLargeIntegers)
(33 primitiveQuoLargeIntegers)
(34 primitiveBitAndLargeIntegers)
(35 primitiveBitOrLargeIntegers)
(36 primitiveBitXorLargeIntegers)
(37 primitiveBitShiftLargeIntegers)
"Float Primitives (38-59)"
(38 primitiveFloatAt)
(39 primitiveFloatAtPut)
(40 primitiveAsFloat)
(41 primitiveFloatAdd)
(42 primitiveFloatSubtract)
(43 primitiveFloatLessThan)
(44 primitiveFloatGreaterThan)
(45 primitiveFloatLessOrEqual)
(46 primitiveFloatGreaterOrEqual)
(47 primitiveFloatEqual)
(48 primitiveFloatNotEqual)
(49 primitiveFloatMultiply)
(50 primitiveFloatDivide)
(51 primitiveTruncated)
(52 primitiveFractionalPart)
(53 primitiveExponent)
(54 primitiveTimesTwoPower)
(55 primitiveSquareRoot)
(56 primitiveSine)
(57 primitiveArctan)
(58 primitiveLogN)
(59 primitiveExp)
"Subscript and Stream Primitives (60-67)"
(60 primitiveAt)
(61 primitiveAtPut)
(62 primitiveSize)
(63 primitiveStringAt)
(64 primitiveStringAtPut)
"The stream primitives no longer pay their way; normal Smalltalk code is faster."
(65 0 "a.k.a. primitiveFail but faster because primitiveFail won't even be called")"was primitiveNext"
(66 0 "a.k.a. primitiveFail but faster because primitiveFail won't even be called") "was primitiveNextPut"
(67 0 "a.k.a. primitiveFail but faster because primitiveFail won't even be called") "was primitiveAtEnd"
"StorageManagement Primitives (68-79)"
(68 primitiveObjectAt)
(69 primitiveObjectAtPut)
(70 primitiveNew)
(71 primitiveNewWithArg)
(72 primitiveArrayBecomeOneWay) "Blue Book: primitiveBecome"
(73 primitiveInstVarAt)
(74 primitiveInstVarAtPut)
(75 primitiveIdentityHash)
(76 primitiveStoreStackp) "Blue Book: primitiveAsObject"
(77 primitiveSomeInstance)
(78 primitiveNextInstance)
(79 primitiveNewMethod)
"Control Primitives (80-89)"
(80 primitiveFail) "Blue Book: primitiveBlockCopy"
(81 primitiveFail) "Blue Book: primitiveValue"
(82 primitiveFail) "Blue Book: primitiveValueWithArgs"
(83 primitivePerform)
(84 primitivePerformWithArgs)
(85 primitiveSignal)
(86 primitiveWait)
(87 primitiveResume)
(88 primitiveSuspend)
(89 primitiveFlushCache) "See 116 & 119 below"
"Input/Output Primitives (90-109)"
(90 primitiveFail) "Blue Book, Squeak 3.x: primitiveMousePoint)"
(91 primitiveTestDisplayDepth) "Blue Book: primitiveCursorLocPut"
(92 primitiveSetDisplayMode) "Blue Book: primitiveCursorLink"
(93 primitiveInputSemaphore)
(94 primitiveGetNextEvent) "Blue Book: primitiveSampleInterval"
(95 primitiveInputWord)
(96 primitiveFail) "primitiveCopyBits"
(97 primitiveSnapshot)
(98 primitiveStoreImageSegment)
(99 primitiveLoadImageSegment)
(100 primitivePerformInSuperclass) "Blue Book: primitiveSignalAtTick"
(101 primitiveBeCursor)
(102 primitiveBeDisplay)
(103 primitiveScanCharacters)
(104 primitiveFail) "primitiveDrawLoop"
(105 primitiveStringReplace)
(106 primitiveScreenSize)
(107 primitiveFail) "Blue Book, Squeak 3.x: primitiveMouseButtons"
(108 primitiveFail) "Blue Book, Squeak 3.x: primitiveKbdNext"
(109 primitiveFail) "Blue Book, Squeak 3.x: primitiveKbdPeek"
"System Primitives (110-119)"
(110 primitiveIdentical)
(111 primitiveClass)
(112 primitiveBytesLeft)
(113 primitiveQuit)
(114 primitiveExitToDebugger)
(115 primitiveChangeClass) "Blue Book: primitiveOopsLeft"
(116 primitiveFlushCacheByMethod)
(117 primitiveExternalCall)
(118 primitiveDoPrimitiveWithArgs)
(119 primitiveFlushCacheBySelector)
"Squeak 2.2 and earlier use 119. Squeak 2.3 and later use 116.
Spur (Squeak 5 and later) use 119. All use 89 above for coarse-grain flushing.
Both 116 and 119 are supported as both have their uses."
"Miscellaneous Primitives (120-127)"
(120 primitiveCalloutToFFI)
(121 primitiveImageName)
(122 primitiveNoop) "Blue Book: primitiveImageVolume"
(123 0) "PrimNumberNoContextSwitch marker; must fail; was primitiveValueUninterruptably"
(124 primitiveLowSpaceSemaphore)
(125 primitiveSignalAtBytesLeft)
"Squeak Primitives Start Here"
"Squeak Miscellaneous Primitives (128-149)"
(126 primitiveDeferDisplayUpdates)
(127 primitiveShowDisplayRect)
(128 primitiveArrayBecome)
(129 primitiveSpecialObjectsOop)
(130 primitiveFullGC)
(131 primitiveIncrementalGC)
(132 primitiveObjectPointsTo)
(133 primitiveSetInterruptKey)
(134 primitiveInterruptSemaphore)
(135 primitiveMillisecondClock)
(136 primitiveSignalAtMilliseconds)
(137 primitiveSecondsClock)
(138 primitiveSomeObject)
(139 primitiveNextObject)
(140 primitiveBeep)
(141 primitiveClipboardText)
(142 primitiveVMPath)
(143 primitiveShortAt)
(144 primitiveShortAtPut)
(145 primitiveConstantFill)
"NOTE: When removing the obsolete indexed primitives,
the following two should go become #primitiveIntegerAt / atPut"
(146 primitiveFail) "primitiveReadJoystick"
(147 primitiveFail) "primitiveWarpBits"
(148 primitiveClone)
(149 primitiveGetAttribute)
"Were File Primitives (150-169) - NO LONGER INDEXED"
(150 157 primitiveFail)
(158 primitiveCompareWith)
(159 primitiveHashMultiply)
(160 primitiveAdoptInstance)
(161 primitiveSetOrHasIdentityHash)
(162 primitiveFail) "reserved for immutablity primitives"
(163 primitiveGetImmutability)
(164 primitiveSetImmutability)
(165 primitiveIntegerAt) "hacked in here for now"
(166 primitiveIntegerAtPut)
(167 primitiveYield)
(168 primitiveCopyObject)
(169 primitiveNotIdentical)
"SpurMemoryManager primitives"
(170 primitiveAsCharacter)
(171 primitiveImmediateAsInteger)
(172 primitiveFetchNextMourner)
(173 primitiveSlotAt) "c.f. (73 primitiveInstVarAt)"
(174 primitiveSlotAtPut) "c.f. (74 primitiveInstVarAtPut)"
(175 primitiveBehaviorHash)
(176 primitiveMaxIdentityHash)
(177 primitiveAllInstances)
(178 primitiveAllObjects)
(179 primitiveFail) "reserved for primitiveAllInstancesOfAny"
(180 primitiveGrowMemoryByAtLeast)
(181 primitiveSizeInBytesOfInstance)
(182 primitiveSizeInBytes)
(183 primitiveIsPinned)
(184 primitivePin)
"CriticalSection primitives"
(185 primitiveExitCriticalSection) "similar to signal hence index = signal + 100"
(186 primitiveEnterCriticalSection) "similar to wait hence index = wait + 100. was primitiveClosureValue"
(187 primitiveTestAndSetOwnershipOfCriticalSection) "was primitiveClosureValueWithArgs"
"Perform method directly"
(188 primitiveExecuteMethodArgsArray)
(189 primitiveExecuteMethod)
"Sound Primitives (continued) - NO LONGER INDEXED"
(190 194 primitiveFail)
"Unwind primitives"
(195 primitiveFindNextUnwindContext)
(196 primitiveTerminateTo)
(197 primitiveFindHandlerContext)
(198 0 "PrimNumberUnwindMarker; must fail; a.k.a. primitiveMarkUnwindMethod")
(199 0 "PrimNumberHandlerMarker; must fail; a.k.a. primitiveMarkHandlerMethod")
"new closure primitives (were Networking primitives)"
(200 primitiveClosureCopyWithCopiedValues)
(201 primitiveClosureValue) "value"
(202 primitiveClosureValue) "value:"
(203 primitiveClosureValue) "value:value:"
(204 primitiveClosureValue) "value:value:value:"
(205 primitiveClosureValue) "value:value:value:value:"
(206 primitiveClosureValueWithArgs) "valueWithArguments:"
(207 primitiveFullClosureValue) "value[:value:value:value:] et al"
(208 primitiveFullClosureValueWithArgs) "valueWithArguments:"
(209 primitiveFullClosureValueNoContextSwitch) "valueNoContextSwitch[:value:] et al"
(210 primitiveContextAt)
(211 primitiveContextAtPut)
(212 primitiveContextSize)
(213 primitiveContextXray)
(214 primitiveVoidVMState)
(215 primitiveFlushCacheByMethod) "primitiveVoidVMStateForMethod in the CoInterpreter"
(216 217 primitiveFail) "reserved for Cog primitives (see CoInterpreter class>>initializePrimitiveTable)"
(218 primitiveDoNamedPrimitiveWithArgs)
(219 primitiveFail) "reserved for Cog primitives (see CoInterpreter class>>initializePrimitiveTable)"
(220 primitiveGetSetFFIExceptionHandling)
(221 primitiveClosureValueNoContextSwitch) "valueNoContextSwitch"
(222 primitiveClosureValueNoContextSwitch) "valueNoContextSwitch:"
(223 229 primitiveFail) "reserved for Cog primitives (see 228 & 229 in CoInterpreterMT class>>initializePrimitiveTable)"
(230 primitiveRelinquishProcessor)
(231 primitiveForceDisplayUpdate)
(232 primitiveFormPrint)
(233 primitiveSetFullScreen)
(234 primitiveFail) "primBitmapdecompressfromByteArrayat"
(235 primitiveFail) "primStringcomparewithcollated"
(236 primitiveFail) "primSampledSoundconvert8bitSignedFromto16Bit"
(237 primitiveFail) "primBitmapcompresstoByteArray"
(238 primitiveFloatArrayAt) "was serial port primitive"
(239 primitiveFloatArrayAtPut) "was serial port primitive"
(240 primitiveUTCMicrosecondClock) "was serial port primitive"
(241 primitiveLocalMicrosecondClock) "was serial port primitive"
(242 primitiveSignalAtUTCMicroseconds)
(243 primitiveUpdateTimezone) "primStringtranslatefromtotable"
(244 primitiveUtcAndTimezoneOffset)
(245 primitiveCoarseUTCMicrosecondClock) "primStringindexOfAsciiinStringstartingAt"
(246 primitiveCoarseLocalMicrosecondClock) "primStringfindSubstringinstartingAtmatchTable"
(247 primitiveSnapshotEmbedded)
(248 primitiveArrayBecomeOneWayNoCopyHash) "was primitiveInvokeObjectAsMethod"
(249 primitiveArrayBecomeOneWayCopyHashArg)
"VM Implementor Primitives (250-255)"
(250 primitiveClearVMProfile)
(251 primitiveControlVMProfiling "primitiveStartVMProfiling")
(252 primitiveVMProfileSamplesInto "primitiveStopVMProfiling")
(253 primitiveFail "N.B. primitiveCollectCogCodeConstituents in CoInterpreter below")
(254 primitiveVMParameter)
(255 primitiveFail) "RESERVED FOR THE R/Squeak VM. Was primitiveInstVarsPutFromStack. Never used except in Disney tests."
"Quick Push Const Methods"
(256 nil) "primitivePushSelf"
(257 nil) "primitivePushTrue"
(258 nil) "primitivePushFalse"
(259 nil) "primitivePushNil"
(260 nil) "primitivePushMinusOne"
(261 nil) "primitivePushZero"
(262 nil) "primitivePushOne"
(263 nil) "primitivePushTwo"
"Quick Push Inst Var Methods"
(264 519 nil) "primitiveLoadInstVar 0 - 255"
(520 primitiveFail)
(521 529 primitiveFail) "Reserved for Spur primitives"
(530 539 primitiveFail)
(540 primitiveFail)
(541 primitiveSmallFloatAdd)
(542 primitiveSmallFloatSubtract)
(543 primitiveSmallFloatLessThan)
(544 primitiveSmallFloatGreaterThan)
(545 primitiveSmallFloatLessOrEqual)
(546 primitiveSmallFloatGreaterOrEqual)
(547 primitiveSmallFloatEqual)
(548 primitiveSmallFloatNotEqual)
(549 primitiveSmallFloatMultiply)
(550 primitiveSmallFloatDivide)
(551 primitiveSmallFloatTruncated)
(552 primitiveSmallFloatFractionalPart)
(553 primitiveSmallFloatExponent)
(554 primitiveSmallFloatTimesTwoPower)
(555 primitiveSmallFloatSquareRoot)
(556 primitiveSmallFloatSine)
(557 primitiveSmallFloatArctan)
(558 primitiveSmallFloatLogN)
(559 primitiveSmallFloatExp)
(560 567 primitiveFail)
(568 primitiveSuspendBackingUpV1)
(569 primitiveFail)
"External primitive support primitives"
(570 primitiveFlushExternalPrimitives)
(571 primitiveUnloadModule)
(572 primitiveListBuiltinModule)
(573 primitiveListExternalModule)
(574 primitiveFail) "reserved for addl. external support prims"
(575 primitiveHighBit)
"Unassigned Primitives"
(576 577 primitiveFail)
(578 primitiveSuspendBackingUpV2)
(579 primitiveFail))
