This converted text file was derived from a Mac HyperTalk - HyperCard Function DA. It's presented for reference use with HyperCard stack conversions needs from the Mac to the IIgs. That's all Folks :) MacProber ------------------------------------------- HyperTalk Functions the abs of number Value returned: A number equal to the absolute value of number. ---------------------------------------- annuity(number1, number2) where number1 represents the interest rate (expressed as a decimal) and number2 represents the number of periods over which you receive annuity payments. Value returned: The total cost of an annuity now that will pay you one unit per period over the specified number of periods, or a number equal to (1 - (1 + rate) ^ -periods) / rate ---------------------------------------- the atan of number Value returned: A number equal to the trigonometric arc tangent of number expressed in radians. Note: There are 2 * pi radians in 360 degrees. ---------------------------------------- average(numberList) Value returned: A number equal to the arithmetic average of the comma- separated list of numbers. ---------------------------------------- the charToNum of char Value returned: A positive integer equal to the ASCII value of the char. ---------------------------------------- the clickChunk Value returned: A word or character chunk expression equal to the word the user has clicked or the longest range of characters with the text style Group around the character that the user clicked (if the text has been grouped). The text style Group allows the clickChunk to extend beyond word boundaries. ---------------------------------------- the clickH the clickV Value returned: ClickH returns an integer equal to the number of horizontal pixels from the left side of the card window to the place the mouse was last clicked. ClickV returns an integer equal to the number of vertical pixels from the top of the card window to the place the mouse was last clicked. ---------------------------------------- the clickLine Value returned: A line chunk expression equal to the line that the user has clicked or the longest range of lines with the text style Group around the character that the user clicked (if the text has been grouped). The text style Group allows the clickLine to extend beyond one line. ---------------------------------------- the clickLoc Value returned: A point equal to the place on the screen where the user most recently clicked. HyperCard does not reset the clickLoc at idle nor once a handler is running. The clickLoc is reset during a handler when you use the wait command: wait until the mouseClick ---------------------------------------- the clickText Value returned: A text string equal to the word the user has clicked or the longest contiguous string of characters with the text style Group around the character that the user clicked (if the text has been grouped). The text style Group allows the clickText to extend beyond word boundaries. ---------------------------------------- the commandKey the cmdKey Value returned: One of the constants up or down indicating whether the key is up or down. ---------------------------------------- compound(number1, number2) where number1 represents theinterest rate (expressed as a decimal) and number2 represents the number of periods over which the interest is compounded. Value returned: The value of one unit of prinicipal invested at the interest rate and compounded over the specified number of periods, or a number equal to (1 + rate) ^ periods. ---------------------------------------- the cos of number Value returned: A number equal to the trigonometric cosine of number expressed in radians. Note: There are 2 * pi radians in 360 degrees. ---------------------------------------- the [adjective ] date date() Value returned: A text string representing the current date set in your Macintosh, in the following date formats: the date -- 7/5/87 date() -- 7/5/87 the abbrev date -- Sun, Jul 5, 1987 the short date -- 7/5/87 the long date -- Sunday, July 5, 1987 ---------------------------------------- the diskSpace Value returned: A positive integer equal to the number of bytes of free space on the disk that contains the current stack. ---------------------------------------- the exp of number the exp1 of number the exp2 of number Value returned: Exp returns a number equal to the constant e raised to the power of number. Exp1 returns a number equal to 1 less than e raised to the power of number. ---------------------------------------- the foundChunk Value returned: A character chunk expression that indicates where the most recent find command located its target string. If nothing was found, it returns empty. The chunk expression returned has the following form: char posInteger to posInteger  of container ---------------------------------------- the foundField Value returned: A field expression that identifies the field in which the most recent find command located its target string. If nothing was found, it returns empty. The field expression returned has one of the following forms: card field N bkgnd field N where N is the number of the field. ---------------------------------------- the foundLine Value returned: A line expression equal to the line of a field where the most recent find command located its target string. If nothing was found, it returns empty. The line expression has the following form: line i of card field N line i of bkgnd field N ---------------------------------------- the foundText Value returned: A string equal to the characters enclosed in the box after the most recent find command has located its target string. If nothing was found, it returns empty. ---------------------------------------- the heapSpace Value returned: A number equal to the amount of working memory HyperCard has left (the number of bytes remaining in HyperCardÕs application heap). The available memory determines whether the user can use the Paint tools, whether HyperCard can open a stack in a new window, and other performance-related factors. ---------------------------------------- the length of expression Value returned: The number of characters in the value of the expression. ---------------------------------------- the ln of number the ln1 of number the log2 of number Value returned: ln returns a number equal to the base-e or natural logarithm of number. ln1 returns a number equal to 1 less than natural logarithm of number. ln2 returns a number equal to the base-2 logarithm of number. ---------------------------------------- max(numberList) Value returned: The highest-valued number from the comma-separated list of numbers. ---------------------------------------- the menus Value returned: A return-separated list of the names of the menus in the current menu bar. Note: The string Apple is a synonym for (Shift-Option-K). ---------------------------------------- min(numberList) Value returned: The number from the comma-separated list of numbers with the lowest value. ---------------------------------------- the mouse Value returned: One of the constants up or down indicating whether the mouse button is up or down. Note: Use the mouse to return the current state of the mouse button and the mouseClick to return whether the mouse has been clicked in the current handler. ---------------------------------------- the mouseClick Value returned: The constant true if the mouse button is down or false if it is up. If the mouse button is down, the mouseClick waits until the mouse button is up before returning true. Note: Use the mouse to return the current state of the mouse button and the mouseClick to return whether the mouse has been clicked in the current handler. ---------------------------------------- the mouseH the mouseV Value returned: mouseH returns an integer equal to the number of pixels from the left of the card window to the current location of the mouse pointer; mouseV returns an integer equal to the number of pixels from the top of the card window to the current location of the mouse pointer. ---------------------------------------- the mouseLoc Value returned: A point equal to the current position of the mouse pointer. ---------------------------------------- the number of [card] buttons the number of bkgnd buttons the number of card fields the number of [bkgnd] fields the number of marked cards the number of cards [in bkgnd ]  [of this stack] the number of bkgnds [of this stack] the number of windows the number of menus the number of menuItems of menu the number of chunks in expression ¥ The number of menus in the menu bar or the number of menu items in a specified menu. ¥ The total number of characters, words, items, or lines in the value of any HyperTalk expression (treated as text). ---------------------------------------- the numToChar of posInteger Value returned: The character whose ASCII equivalent equals posInteger. ---------------------------------------- offset(text1, text2) Value returned: The number 0 if text1 does not appear in text2; otherwise, a positive integer equal to the number of characters from the first character of text2 to the first character of text1 within text2. ---------------------------------------- the optionKey Value returned: One of the constants up or down indicating whether the Option key is up or down. ---------------------------------------- the param of posInteger Value returned: The value (not the name) of a paramater variable in the current handler or empty if the parameter variable does not exist. The param of 0 is the name of the message itself. ---------------------------------------- the paramCount Value returned: A positive integer equal to the total number of parameters passed to the current handler. ---------------------------------------- the params Value returned: A text string equal to the entire parameter list, including the message name, passed to the currently executing handler. ---------------------------------------- the random of posInteger Value returned: A random integer between 1 and posInteger. Random returns values for integers up to 2^31 - 2. ---------------------------------------- the result Value returned: ¥ The value set by a return keyword during the execution of a message or function handler. ¥ empty if an answer, ask, convert, create, export, find, go, icon, import, open, open printing, open report printing, print, or save command succeeds (or is not cancelled by the user); otherwise, a message string. ---------------------------------------- the round of number Value returned: An integer equal to the nearest integer to number. Odd integers plus exactly 0.5 round up; even integers (or 0) plus exactly 0.5 round down. If number is negative, HyperCard internally removes the negative sign, rounds its absolute value, then puts the negative sign back on. ---------------------------------------- the screenRect Value returned: A rectangle equal to the dimensions of the screen in pixels. If there is more than one monitor, the screenRect returns the dimensions of the monitor displaying the current stack as offsets from the top-left corner of the screen that contains the menu bar. ---------------------------------------- the seconds the secs Value returned: An integer equal to the number of seconds between midnight, January 1, 1904, and the current time set in your Macintosh. ---------------------------------------- the selectedChunk Value returned: A character chunk expression that indicates the range of characters currently highlighted. If nothing is highlighted, it returns empty. The chunk expression returned has the following form: char posInteger to posInteger  of container ---------------------------------------- the selectedField Value returned: A field expression that indicates the field in which a range of characters is currently highlighted. If nothing is highlighted, it returns empty. The field expression returned has one of the following forms: card field N bkgnd field N where N is the number of the field. ---------------------------------------- the selectedLine Value returned: A line expression that indicates the line in which a range of characters is currently highlighted. If nothing is highlighted, it returns empty. The line expression returned has the following form: line i of card field N line i of bkgnd field N where i is the line number and N is the number of the field. ---------------------------------------- the selectedLoc Value returned: A point equal to the left and bottom offsets of the insertion point or the current selection in a field. It returns empty if there is no selection or if the insertion point is in the Message box. ---------------------------------------- the selectedText Value returned: A string equal to the range of characters currently highlighted. If nothing is highlighted, it returns empty. ---------------------------------------- the shiftKey Value returned: One of the constants up or down indicating whether the Shift key is up or down. ---------------------------------------- the sin of number Value returned: A number equal to the trigonometric sine of number expressed in radians. Note: There are 2 * pi radians in 360 degrees. ---------------------------------------- the sound Value returned: A text string equal to the name of the sound resource currently playing (such as "boing") or the string "done" if no sound is currently playing. The sound function enables you to synchronize sounds with other actions, because scripts continue to run while sounds are playing. ---------------------------------------- the sqrt of number Value returned: A number equal to the square root of number. If number is negative, sqrt returns NAN(001), which means Ònot a number.Ó ---------------------------------------- the stacks Value returned: A return-separated list of the full pathnames for all the open stacks, in front-to-back order. ---------------------------------------- the tan of number Value returned: A number equal to the trigonometric tangent of number expressed in radians. Note: There are 2 * pi radians in 360 degrees. ---------------------------------------- the [adjective ] target Value returned: A text string that identifies the object that originally receives a message sent by HyperCard or by the send keyword. If an object does not have a name, the target returns its ID. The adjectives abbreviated, long, and short return various forms of an objectÕs name as with the property the name (click Related Topics for more information about name). ---------------------------------------- the ticks Value returned: An integer equal to the number of ticks since the Macintosh was turned on or restarted (one tick equals one-sixtieth of a second). the [adjective ] time time() Value returned: A text string representing the current time set in your Macintosh, in one of the following time formats: the time -- 9:14 AM time() -- 9:14 AM the abbrev time -- 9:14 AM the short time -- 9:14 AM the long time -- 9:14:42 AM ---------------------------------------- the tool Value returned: A text string equal to the name of the currently chosen tool (that is, the toolName ). ---------------------------------------- the trunc of number Value returned: An integer equal to the integer part of number. Any fractional part is disregarded, regardless of the numberÕs sign. Note: trunc only returns correct values for real numbers less than or equal to 2,147,483,647 (the maximum long integer value). ---------------------------------------- the value of expression Value returned: The value of the expression after HyperTalk evaluates it. ---------------------------------------- the version [of HyperCard] the long version [of HyperCard] the version of stack The version property returns the version number of the HyperCard application that is currently running. You canÕt set the version. The long version returns an 8-digit number in the form xxyyzzrr. The version of stack returns a comma-separated list of five numbers in the format of Macintosh version resources: ¥ Item 1 is the version of HyperCard that created the stack. ¥ Item 2 is the version that last compacted the stack. ¥ Item 3 is the oldest version to change the stack since the last Compact Stack. ------------------------------------------ -end of text file conversion-