bank_get_address.c

Go to the documentation of this file.

/*****************************************************************************
 * ugBASIC - an isomorphic BASIC language compiler for retrocomputers        *
 *****************************************************************************
 * Copyright 2021-2026 Marco Spedaletti (asimov@mclink.it)
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *----------------------------------------------------------------------------
 * Concesso in licenza secondo i termini della Licenza Apache, versione 2.0
 * (la "Licenza"); è proibito usare questo file se non in conformità alla
 * Licenza. Una copia della Licenza è disponibile all'indirizzo:
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Se non richiesto dalla legislazione vigente o concordato per iscritto,
 * il software distribuito nei termini della Licenza è distribuito
 * "COSÌ COM'È", SENZA GARANZIE O CONDIZIONI DI ALCUN TIPO, esplicite o
 * implicite. Consultare la Licenza per il testo specifico che regola le
 * autorizzazioni e le limitazioni previste dalla medesima.
 ****************************************************************************/
 
/****************************************************************************
 * INCLUDE SECTION 
 ****************************************************************************/
 
#include "../../../ugbc.h"
 
#if defined(__atari__) || defined(__atarixl__) || defined(__plus4__) || defined(__vic20__) || defined(__c16__)

/* <usermanual>
@keyword BANK ADDRESS
 
@english
 
The ''BANK ADDRESS'' function allows you to know the memory address where the swap 
window with the expanded memory appears, for the given bank. In the case of 
expansion memories with DMA access, this area does not exist and therefore the
function returns zero. Exactly the same value returned in case there are no memory expansions.
 
@italian
 
La funzione ''BANK ADDRESS'' consente di conoscere l'indirizzo di memoria dove 
appare la finestra di scambio con la memoria espansa, per il dato banco. Nel caso di memorie di 
espansione con accesso DMA, questa zona non esiste e quindi la funzione restituisce 
zero. Esattamente lo stesso valore restituito in caso che non vi siano espansioni 
di memoria.
 
@syntax = BANK ADDRESS(id)
 
@example x = BANK ADDRESS(1)
 
@seeAlso BANK
@seeAlso BANK COUNT (constant)
@target all
</usermanual> */
Variable * bank_get_address( Environment * _environment, int _bank ) {
 
    Variable * result = variable_temporary( _environment, VT_ADDRESS, "(bank address)" );
 
    char * address = banks_get_address( _environment, _bank );
 
    cpu_addressof_16bit( _environment, address, result->realName );
 
    return result;
    
}

Variable * bank_get_address_var( Environment * _environment, char * _bank ) {
 
    return banks_get_address_var( _environment, _bank );
 
}
 
#endif