Coerce raw
or named list
to an AmigaBasicBMAP()
class object
Arguments
- x
When
x
is avector
ofraw
data, it needs to be structured as it would be when stored in a binary file (seeread.AmigaBasicBMAP()
).x
can also be a namedlist
, where the name of each element corresponds with a routine in the library. Each element should than consist of alist
with 2 elements: The first should be namedlibraryVectorOffset' and should hold the
numericoffset of the routine in the library (see details). The second element should be named
registers' and should contain avector
ofraw
values refering to CPU registers used by the routine (see details).
Value
Returns a AmigaBasicBMAP()
based on x
Details
An Amiga Basic BMAP file maps the offset of routines in Amiga libraries. This
function converts the raw format in which it would be stored as a file into a comprehensive S3 class object. It
can also convert a named list into an S3 class object. See Arguments' and
Examples' sections on how to format
this list.
See also
Other AmigaBasic.operations:
AmigaBasic.reserved()
,
AmigaBasicBMAP
,
AmigaBasic
,
[.AmigaBasic()
,
as.AmigaBasic()
,
as.character()
,
check.names.AmigaBasic()
,
names.AmigaBasic()
,
rawToAmigaBasicBMAP()
,
rawToAmigaBasic()
,
read.AmigaBasicBMAP()
,
read.AmigaBasic()
,
write.AmigaBasic()
Examples
if (FALSE) {
## For the dos.library, the start of the bmap list would look like:
dos.list <- list(
xOpen = list(
libraryVectorOffset = -30,
registers = as.raw(2:3)
),
xClose = list(
libraryVectorOffset = -36,
registers = as.raw(2)
),
xRead = list(
libraryVectorOffset = -42,
registers = as.raw(2:4)
)
)
## Note that the list above is incomplete, the dos.library holds more routines than shown here.
## This merely serves as an example.
## This list can be converted to an S3 class as follows:
dos.bmap <- as.AmigaBasicBMAP(dos.list)
}