Ml functions - Revision history

Admin at 00:50, 31 July 2026

2026-07-31T00:50:40Z

2026-07-28T20:23:20Z

← Older revision		Revision as of 20:23, 28 July 2026
Line 64:		Line 64:
	\|-		\|-
	\| @4		\| @4
	\| <strong>~~Modem~~ GET Character</strong><br>		\| <strong>GET Character (Modem or locally)</strong><br>
	<strong>Format: @4 : STRING</strong><br>		<strong>Format: @4 : STRING</strong><br>
	~~Modem input~~ character (GET-style). Returns one character if available; otherwise returns a null string.<br>		Input character (GET-style). Returns one character if available; otherwise returns a null string.<br>
	Example: <strong>A$=@4</strong>		Example: <strong>A$=@4</strong>
	\|-		\|-

2026-07-28T19:31:43Z

← Older revision		Revision as of 19:31, 28 July 2026
Line 273:		Line 273:
	\| @33		\| @33
	\| <strong>Return Saved Input Color</strong>		\| <strong>Return Saved Input Color</strong>
	~~Returns~~ a one-character string containing the PETSCII foreground-color control byte that was active when the most recent ML line-input operation began. It is used by the message editor to restore the input color after deleting temporary command prompts.		This command accepts no arguments and returns a one-character string containing the PETSCII foreground-color control byte that was active when the most recent ML line-input operation began. It is used by the message editor to restore the input color after deleting temporary command prompts. Useful for character deletion, cursor movement, backward color-state reconstruction, prompt removal, and redisplay of edited text.
	\|}		\|}

2026-07-28T19:26:31Z

← Older revision		Revision as of 19:26, 28 July 2026
Line 270:		Line 270:
	Example: <strong>A=@32(2,2)</strong>		Example: <strong>A=@32(2,2)</strong>
	This discards the first two bytes of a disk-directory record, reads the following two bytes, and returns their numeric value. This is commonly used to obtain the block count from a Commodore disk-directory entry. The same operation could be written as: <strong>A=@6(@29(2,2))</strong>		This discards the first two bytes of a disk-directory record, reads the following two bytes, and returns their numeric value. This is commonly used to obtain the block count from a Commodore disk-directory entry. The same operation could be written as: <strong>A=@6(@29(2,2))</strong>


	\|-		\|-
	\| @33		\| @33
	\| <strong>Return ~~1-Byte Null String~~</strong~~><br~~>		\| <strong>Return Saved Input Color</strong>
	~~<strong>Format: @33 : (Undocumented)</strong><br>~~		Returns a one-character string containing the PETSCII foreground-color control byte that was active when the most recent ML line-input operation began. It is used by the message editor to restore the input color after deleting temporary command prompts.
	~~Newer function (not documented in the v8.0 manuscript).~~ Returns a ~~single~~-byte ~~null string (CHR$(0))~~. ~~See [[Undocumented_8.1_commands#at33\|Undocumented features: @33]]~~.
	\|}		\|}

2026-07-28T18:06:10Z

@@ Line 222: / Line 222: @@
 |-
 | @29
-| <strong>Read N Characters</strong><br>
+| <strong>Read a Fixed-Length String from a File</strong><br>
-<strong>Format: @29( <number> ) : STRING</strong><br>
+Format: <strong><nowiki>@29(<count>[,<skip>])</nowiki></strong>
-Reads <number> characters (GET#-style). Does not stop at EOF and does not stop at the end-of-line character in !04.
+Reads and returns a string containing a fixed number of bytes from the logical file specified by !14.
 |-
 | @30
@@ Line 239: / Line 255: @@
 |-
 | @32
-| <strong>Retrieve File Block Count</strong><br>
+| <strong>Read File Bytes and Convert Them to a Numeric Value</strong><br>
-<strong>Format: @32 : (Undocumented)</strong><br>
+Format: <strong>@32(<nowiki><count>[,<skip>])</nowiki></strong>
-Newer function (not documented in the v8.0 manuscript). See [[Undocumented_8.1_commands#at32|Undocumented features: @32]].
+Performs the same fixed-length file read as @29, then converts the returned byte string to a numeric value using the same internal conversion performed by @6.
 |-
 | @33

2026-03-01T03:37:10Z

2026-02-20T16:17:56Z

← Older revision		Revision as of 16:17, 20 February 2026
Line 278:		Line 278:

	See [[Undocumented_8.1_commands#at32\|Undocumented features/commands: @32]]		See [[Undocumented_8.1_commands#at32\|Undocumented features/commands: @32]]
			\|-
			\| @33
			\| <strong>@33 - Return 1-Byte Null String</strong>

			This is a newer function undocumented in the version 8.0 manuscript. This function returns a single chr$(0).

			See [[Undocumented_8.1_commands#at33\|Undocumented features/commands: @33]]
	\|}		\|}

2026-02-20T15:00:15Z

← Older revision		Revision as of 15:00, 20 February 2026
Line 272:		Line 272:

	See [[Undocumented_8.1_commands#at31\|Undocumented features/commands: @31]]		See [[Undocumented_8.1_commands#at31\|Undocumented features/commands: @31]]
			\|-
			\| @32
			\| <strong>@32 - Retrieve Block Count</strong>
			This is a newer function undocumented in the version 8.0 manuscript. This function retrieves the block count of a selected filename.

			See [[Undocumented_8.1_commands#at32\|Undocumented features/commands: @32]]

	\|}		\|}

2026-02-20T13:52:28Z

← Older revision		Revision as of 13:52, 20 February 2026
Line 265:		Line 265:

	This function is used in conjunction with the variables !49, !50, and !51. It returns the drive init command for one of the three boot drives: 0=Boot drive, 1=Program drive, 2=External drive.		This function is used in conjunction with the variables !49, !50, and !51. It returns the drive init command for one of the three boot drives: 0=Boot drive, 1=Program drive, 2=External drive.
	\|}		\|-
	\| @31		\| @31
	\| <strong>@31 – Sequential Read (Enhanced)</strong>		\| <strong>@31 – Sequential Read (Enhanced)</strong>

2026-02-20T13:51:24Z

← Older revision		Revision as of 13:51, 20 February 2026
Line 265:		Line 265:

	This function is used in conjunction with the variables !49, !50, and !51. It returns the drive init command for one of the three boot drives: 0=Boot drive, 1=Program drive, 2=External drive.		This function is used in conjunction with the variables !49, !50, and !51. It returns the drive init command for one of the three boot drives: 0=Boot drive, 1=Program drive, 2=External drive.
			\|}
			\| @31
			\| <strong>@31 – Sequential Read (Enhanced)</strong>

			This is a newer function undocumented in the version 8.0 manuscript. Similar to #30, this function replaces the @5 function for use with merging messages in the bbs.msgs file.

			See [[Undocumented_8.1_commands#at31\|Undocumented features/commands: @31]]
	\|}		\|}