Variables are little stores of data, some are implicitly created for you, and some you can create for yourself<\/p>\n\n\n\n
var <variable name> <value><\/strong><\/code><\/pre>\n\n\n\nFor example, to create the variable MYVAR, with the value “Today is Friday” (the quotes are important if you have spaces).<\/p>\n\n\n\n
CapCLI> var MYVAR \"Today is Friday\"<\/strong><\/code><\/pre>\n\n\n\nTo display a variable<\/h4>\n\n\n\necho <variable name><\/strong><\/code><\/pre>\n\n\n\nFor example;<\/p>\n\n\n\n
CapCLI> echo $MYVAR<\/strong>\nToday is Friday<\/code><\/pre>\n\n\n\nTo create a variable from data in your current ROM<\/h4>\n\n\n\n
You can grab chunks of the ROM and it will store the data in the variable as a hexadecimal string<\/p>\n\n\n\n
CapCLI> <\/em>var <aliasname> romdata <start> <size><\/em><\/strong><\/code><\/pre>\n\n\n\nFor example, to grab four bytes from the ROM at position 0x0C (position 12 holds the kickstart version; you can use hex start\/size or decimal numbers)
Note: the start position starts at zero (i.e. the first byte is byte 0).<\/p>\n\n\n\n
CapCLI> loadrom \"ROMs\/TOSEC.Firmware\/Kickstart v2.05 r37.350 (1992-04)(Commodore)(A600HD)[!].rom\"<\/strong>\nCapCLI> var FRED romdata 0x0C 4<\/strong>\nCapCLI> echo $FRED<\/strong>\n0x0025015E<\/code><\/pre>\n\n\n\nTo take chunks out of a variable: midstring()<\/h4>\n\n\n\nvar <varname> mid <start> <size><\/em><\/strong> <\/code><\/pre>\n\n\n\nFor example, reduce the variable FRED to just two bytes starting from position three, this command changes the actual variable<\/em>
Note: string positions start at 0<\/p>\n\n\n\nCapCLI> var FRED 0x0025012c<\/strong> \nCapCLI> var FRED mid 3 2<\/strong> \nCapCLI> echo $FRED<\/strong>\n02<\/code><\/pre>\n\n\n\nTo add\/subtract from variables<\/h4>\n\n\n\nvar <varname> add <value><\/em><\/strong>\nvar <varname> subtract <value><\/em><\/strong><\/code><\/pre>\n\n\n\nThese commands will directly affect the variable value, you can change number variables or hex values, if you’re using hex values it will treat it as a four-byte integer, so numbers will wrap round from 0xffffffff to 0x00000000 if you add 1 (and from 0x00000000 to 0xffffffff if you subtract 1), if will also pad the result to four bytes, and if you attempt to use a longer hex number it will only take the first four bytes, e.g. if you add 1 to 0x112233445566 will be taken as 0x11223344 and result in 0x11223345 – and it will do it without any warning, attempting maths on invalid numbers will give unpredictable results.<\/p>\n\n\n\n
CapCLI> var FRED 77<\/strong>\nCapCLI> var FRED add 0xD<\/strong>\nCapCLI> echo $FRED<\/strong>\n90\nCapCLI> var FRED 0x0025<\/strong>\nCapCLI> var FRED subtract 16<\/strong>\nCapCLI> echo $FRED<\/strong>\n0x00000015<\/code><\/pre>\n\n\n\nTo convert variables<\/h4>\n\n\n\n
You can convert the representation of variables, by default, all variables are strings, even though some are implicitly numbers or hex strings, you cannot store binary values in a variable unless you store it as the hex representation – so converting between them may lose data!
Using one of these functions on a variable will change the variable<\/p>\n\n\n\n
var <varname> stringtohex<\/strong>\nCapCLI> var MYVAR \"Hello World\"\nCapCLI> var MYVAR stringtohex\nCapCLI> echo $MYVAR\n0x48656c6c6f20576f726c64\nNote: No end-of-line markers are added (i.e. 0x00 is not added to the string).<\/code><\/pre>\n\n\n\nvar <varname> hextostring<\/strong><\/strong>\nCapCLI> var MYVAR 0x3238205965617273204c61746572\nCapCLI> var MYVAR hextostring\nCapCLI> echo $MYVAR\n28 Years Later\nNote: If you have a null byte in the middle of the hex, the string will truncate there.<\/code><\/pre>\n\n\n\nvar <varname> inttohex\n<\/strong>CapCLI> var MYVAR 300\nCapCLI> var MYVAR inttohex\nCapCLI> echo $MYVAR\n0x0000012c\nNote: The output is always a four-byte hex number (UINT), you can convert a negative number, but it will assume the resulting hex value is positive.<\/code><\/pre>\n\n\n\nvar <varname> hextoint<\/strong>\nCapCLI> var MYVAR 0x0ff\nCapCLI> var MYVAR hextoint\nCapCLI> echo $MYVAR\n255\nNote: The output is always a positive number (assumes unsigned hex value)<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"Variables are little stores of data, some are implicitly created for you, and some you can create for yourself To create a variable For example, to create the variable MYVAR, with the value “Today is Friday” (the quotes are important if you have spaces). To display a variable For example; To create a variable from …<\/p>\n