X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=doc%2Ffuncref.sgml;h=ccb15df9b6945406d3f5802699b42c639805dd53;hb=c70af3a36b86a926add81128b47870bfd633a50d;hp=f9be402e0ddf6aa2869fe28b6862eafbed804017;hpb=1faaf6f4bfab330eae060fd66fe89c9829b9bc50;p=cc65 diff --git a/doc/funcref.sgml b/doc/funcref.sgml index f9be402e0..ccb15df9b 100644 --- a/doc/funcref.sgml +++ b/doc/funcref.sgml @@ -7,7 +7,7 @@ cc65 is a C compiler for 6502 based systems. This function reference describes -the available C functions supplied by the library. +the C functions available in the standard library. @@ -55,10 +55,31 @@ function. - - - - + + + + + + + +

+ + +_dos_type + +rebootafterexit + + + +

+ + +_dos_type + +rebootafterexit +textframe +textframexy + @@ -69,6 +90,63 @@ function. +

+ + + + + +(incomplete) + + +

+ +(incomplete) + + +

+ + + + + + + + + + +

+ +(incomplete) + + +

+ + + + + + +

+ + + + + + + + + +

+ + + + + + + + +

@@ -80,11 +158,11 @@ function. - - - - - + + + + + @@ -95,7 +173,7 @@ function. - + @@ -122,1465 +200,4303 @@ function. +

+ +(incomplete) + + +

+ +(incomplete) + +

+ + +

+ +(incomplete) + + +

+ + + + + + + + +

+ +(incomplete) + + +

+ + + + + + + + + + + +

+ + + + + + + +

+ + + + + + + +

+ + + + + + + + + + + + + + + + + +(incomplete) + + +

+ +(incomplete) + + +

+ +The . +It does not declare any functions. + + +

+ + + + + + + + + +

+ +(incomplete) + + +

+ +(incomplete) + + +

+ + + +(incomplete) + + +

+ + + + + + + +

+ + + + + + + +

+ +(incomplete) + + +

+ +(incomplete) + + +

+ + + + + + +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +(incomplete) + +

+ + + + + + + + + + + + + + + - + + + + + + + + + +

+ + + + + + + + + + + + + + + + + + + +(incomplete) + + +

+ +(incomplete) + + +

+ + + + + + + + + + + + + +(incomplete) + + +

+ + + + + + + + + + + + + +(incomplete) + + +

+ +(incomplete) +

+ +(incomplete) + Alphabetical function reference

-BRK

+_heapadd

-/ - -The function is actually a macro. -The inserted instruction may lead to unexpected results if no debugger -is present. +/ + +The minimum blocksize that can be added is 6 bytes; the function will +ignore smaller blocks. , - +, +, +, +, +, +, + -CLI

+_heapblocksize

-/ - -The function is actually a macro. -Disabling interrupts may lead to unexpected results. +/ +/, / or /. + +Passing a pointer to a block that was is not the result of one of the +allocation functions, or that has been free'd will give unpredicable results. , - +, +, +, +, +, +, + -SEI

+_heapmaxavail

-/ - -The function is actually a macro. - +/ +/. , - +, +, +, +, +, +, + -abort

+_heapmemavail

-/ - +This function is of less use than usually assumed, since the returned +heap space may be available but not in one block. So even if this function +says that several times more heap space is available than needed, may still return +, - +, +, +, +, +, +, + -abs

+_poserror

-/ - -The return value is undefined if The function is only available as fastcall function, so it may only be -used in presence of a prototype. +/ +/ with an +argument of +Since operating system specific error code are - you guessed it - +operating system specific, the value in The function is only available as fastcall function, so it may only +be used in presence of a prototype. - +, + -assert

+_randomize

-/ -/ + -The function is actually a macro. +The randomness of the seed depends on the machine hardware. -, - +, + -atexit

+_stroserror

-/ -/ + -A maximum of 5 exit functions can be registered. -There is no way to unregister an exit function. +Since operating system specific error code are - you guessed it - +operating system specific, the parameter and the string returned depend on the +cc65 target. The function is only available as fastcall function, so it may only be used in presence of a prototype. -, - + -bgcolor

+_swap

-/ -/ + -Background colors are system dependent. The function may have no effect -on systems where the background color cannot be changed. +The memory areas may not overlap, otherwise the results are undefined. The function is only available as fastcall function, so it may only be used in presence of a prototype. , - +, + -bordercolor

+_sys

-/ -/ + -Border colors are system dependent. The function may have no effect -on systems where the border color cannot be changed. -The function is only available as fastcall function, so it may only -be used in presence of a prototype. +Bits 4 and 5 of the flags value in the The function is only available as fastcall function, so it may only be +used in presence of a prototype. , - -cclear

+BRK

-/ -/ + -The function is only available as fastcall function, so it may -only be used in presence of a prototype. +The function is actually a macro. +The inserted instruction may lead to unexpected results if no debugger +is present. , - +, + -cclearxy

+CLI

-/ -/ + -The function is only available as fastcall function, so it may -only be used in presence of a prototype. +The function is actually a macro. +Disabling interrupts may lead to unexpected results. , - +, + -cgetc

+PEEK

-/ -/ + -If the system supports a keyboard buffer, The function is actually a macro. +This function depends highly on the platform and environment. , - +, + -chline

+PEEKW

-/ -/ + -The character used to draw the horizontal line is system dependent. -If available, a line drawing character is used. Drawing a line that is partially -off screen leads to undefined behaviour. -The function is only available as fastcall function, so it may only be -used in presence of a prototype. +The function is actually a macro. +This function depends highly on the platform and environment. +The order in which the two bytes are read is unspecified and may +depend of the address expression used. , -, - +, + -chlinexy

+POKE

-/ -/ + -The character used to draw the horizontal line is system dependent. -If available, a line drawing character is used. Drawing a line that is partially -off screen leads to undefined behaviour. -The function is only available as fastcall function, so it may only be -used in presence of a prototype. +The function is actually a macro. +This function depends highly on the platform and environment. +Careless use will cause the program to act strange or may crash the +machine. , -, - +, + -clrscr

+POKEW

-/ -/ + +The function is actually a macro. +This function depends highly on the platform and environment. +Careless use will cause the program to act strange or may crash the +machine. +The order in which the two bytes are written is unspecified and may +depend of the address expression used. + , - +, + -cursor

+SEI

-/ -/ + -The function is only available as fastcall function, so it may only -be used in presence of a prototype. +The function is actually a macro. +Disabling interrupts may lead to unexpected results. , - +, + -cvline

+abort

-/ - -The character used to draw the vertical line is system dependent. -If available, a line drawing character is used. Drawing a line that is partially -off screen leads to undefined behaviour. -The function is only available as fastcall function, so it may only be -used in presence of a prototype. - -/ +, -, - +, +, + -cvlinexy

+abs

-/ -/ + -The character used to draw the vertical line is system dependent. -If available, a line drawing character is used. Drawing a line that is partially -off screen leads to undefined behaviour. +The return value is undefined if The function is only available as fastcall function, so it may only be used in presence of a prototype. -, -, - + -em_commit

+assert

-/ -/, /, -/ or / are called without calling / + -Calling The function is only available as fastcall function, so it may only be -used in presence of a prototype. -The function produces undefined results if no extended memory driver is -loaded. +The function is actually a macro. -, -, - +, + -em_copyfrom

+atexit

-/ -/ + -Calling / first, or the changes are lost. +A maximum of 5 exit functions can be registered. +There is no way to unregister an exit function. The function is only available as fastcall function, so it may only be used in presence of a prototype. -The function produces undefined results if no extended memory driver is -loaded. -, -, - +, + -em_copyto

+atoi

-/ -/ + -Calling / first, or the changes are lost. +There is no way to detect any conversion errors. +The function does not check for an numerical overflow when converting. The function is only available as fastcall function, so it may only be used in presence of a prototype. -The function produces undefined results if no extended memory driver is -loaded. -, -, - +, +, +, +, + -em_load_driver

+atol

-/ -/ + -Not all drivers are able to detect if the supported hardware is really -present. +There is no way to detect any conversion errors. +The function does not check for an numerical overflow when converting. The function is only available as fastcall function, so it may only be used in presence of a prototype. -The driver is loaded by name, so currently you must know the type of -extended memory that should be supported. There is no autodetect capability. - +, +, +, +, + -em_map

+bgcolor

-/ -/ instead. / + -Calling / first, or the changes are lost. +Background colors are system dependent. The function may have no effect +on systems where the background color cannot be changed. The function is only available as fastcall function, so it may only be used in presence of a prototype. -The function produces undefined results if no extended memory driver is -loaded. , -, - +, + -em_pagecount

+bordercolor

-/ -/ + -The function returns zero if no extended memory driver is loaded. -The function may return zero if the supported hardware was not detected. +Border colors are system dependent. The function may have no effect +on systems where the border color cannot be changed. +The function is only available as fastcall function, so it may only +be used in presence of a prototype. +, + -em_unload

+bsearch

-/ - -The function does nothing if no driver is loaded. +/ + +The contents of the array must be sorted in ascending order according to +the compare function given. +If there are multiple members that match the key, the function will +return one of the members. +The function is only available as fastcall function, so it may only +be used in presence of a prototype. - + -em_use

+bzero

-/ -/, but will not transfer data into the -actual memory window in the assumption that the existing data is wrong or -will get overwritten. - -Calling / first, or the changes are lost. -The function is only available as fastcall function, so it may only be -used in presence of a prototype. -The function produces undefined results if no extended memory driver is -loaded. +/ + +The function is non standard and therefore only available in non ANSI +mode. You should use / instead. +The function is only available as fastcall function, so it may only +be used in presence of a prototype. , -, - +, +, +, +, -exit

+c64mode

-/ -/ are called. Common values for status are /. +/ + +The function is specific to the C128. +The function will not return to the caller. + + + + + +calloc

+ + + +/ + +Clearing the memory may not have the expected effect on all platforms: +pointers in the block may not be The function is only available as fastcall function, so it may only be used in presence of a prototype. -It depends on the host machine if the program return code can be -evaluated or is ignored. , - +, +, +, +, +, +, + -gotox

+cclear

-/ - The function is only available as fastcall function, so it may only be used in presence of a prototype. -Invalid values for the X position (out of screen coordinates) may -lead to undefined behaviour. , -, -, - +, + -gotoxy

+cclearxy

-/ - -The function is only available as fastcall function, so it may only be -used in presence of a prototype. -Invalid values for any of both coordinates (out of screen positions) may -lead to undefined behaviour. +The function is only available as fastcall function, so it may +only be used in presence of a prototype. , -, -, - +, + -gotoy

+cgetc

-/ - -The function is only available as fastcall function, so it may -only be used in presence of a prototype. -Invalid values for the Y position (out of screen coordinates) may lead -to undefined behaviour. +If the system supports a keyboard buffer, , -, -, - +, + -isalnum

+chline

-/ -/ + -When compiling with When compiling without The character used to draw the horizontal line is system dependent. +If available, a line drawing character is used. Drawing a line that is partially +off screen leads to undefined behaviour. +The function is only available as fastcall function, so it may only be +used in presence of a prototype. -, -, -, -, -, -, -, -, -, -, -, - +, +, + -isalpha

+chlinexy

-/ -/ + -When compiling with When compiling without The character used to draw the horizontal line is system dependent. +If available, a line drawing character is used. Drawing a line that is partially +off screen leads to undefined behaviour. +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, +, + + + + + +clearerr

+ + + +/ + +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, + + + + + +clrscr

+ + + +/ +, + + + + + +close

+ + + +/ + +The function is only available as fastcall function, so it may only +be used in presence of a prototype. + +, + + + + + +creat

+ + + +/ + +/ with +The function is only available as fastcall function, so it may only +be used in presence of a prototype. + +, + + + + + +cprintf

+ + + +/ +/. --> + +Like all other +, +, +, +, + + + + + +cputc

+ + + +/ + +Like all other The function is only available as fastcall function, so it may only +be used in presence of a prototype. + +, +, +, +, + + + + + +cputcxy

+ + + +/ + +Like all other The function is only available as fastcall function, so it may only +be used in presence of a prototype. + +, +, +, +, + + + + + +cputs

+ + + +/ + +Like all other The function is only available as fastcall function, so it may only +be used in presence of a prototype. + +, +, +, +, + + + + + +cputsxy

+ + + +/ + +Like all other The function is only available as fastcall function, so it may only +be used in presence of a prototype. + +, +, +, +, + + + + + +cursor

+ + + +/ + +The function is only available as fastcall function, so it may only +be used in presence of a prototype. + +, + + + + + +cvline

+ + + +/ + +The character used to draw the vertical line is system dependent. +If available, a line drawing character is used. Drawing a line that is partially +off screen leads to undefined behaviour. +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, +, + + + + + +cvlinexy

+ + + +/ + +The character used to draw the vertical line is system dependent. +If available, a line drawing character is used. Drawing a line that is partially +off screen leads to undefined behaviour. +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, +, + + + + + +div

+ + + +/ + +The function is only available as fastcall function, so it may only +be used in presence of a prototype. + + + + + +em_commit

+ + + +/ +/, /, +/ or / are called without calling +Calling The function is only available as fastcall function, so it may only be +used in presence of a prototype. +The function produces undefined results if no extended memory driver is +loaded. + +, +, + + + + + +em_copyfrom

+ + + +/ + +Calling / first, or the changes are lost. +The function is only available as fastcall function, so it may only be +used in presence of a prototype. +The function produces undefined results if no extended memory driver is +loaded. + +, +, + + + + + +em_copyto

+ + + +/ + +Calling / first, or the changes are lost. +The function is only available as fastcall function, so it may only be +used in presence of a prototype. +The function produces undefined results if no extended memory driver is +loaded. + +, +, + + + + + +em_install

+ + + +/ + +Not all drivers are able to detect if the supported hardware is really +present. +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, +, + + + + + +em_load_driver

+ + + +/ + +Not all drivers are able to detect if the supported hardware is really +present. +The function is only available as fastcall function, so it may only be +used in presence of a prototype. +The driver is loaded by name, so currently you must know the type of +extended memory that should be supported. There is no autodetect capability. + + + + + + +em_map

+ + + +/ +/ instead. +Calling / first, or the changes are lost. +The function is only available as fastcall function, so it may only be +used in presence of a prototype. +The function produces undefined results if no extended memory driver is +loaded. + +, +, + + + + + +em_pagecount

+ + + +/ + +The function returns zero if no extended memory driver is loaded. +The function may return zero if the supported hardware was not detected. + + + + + + +em_uninstall

+ + + +/ + +If the driver has been loaded using /, / +should be used instead of The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, +, + + + + + +em_unload

+ + + +/ + +The function does nothing if no driver is loaded. + + + + + + +em_use

+ + + +/ +/, but will not transfer data into the +actual memory window in the assumption that the existing data is wrong or +will get overwritten. + +Calling / first, or the changes are lost. +The function is only available as fastcall function, so it may only be +used in presence of a prototype. +The function produces undefined results if no extended memory driver is +loaded. + +, +, + + + + + +exit

+ + + +/ +/ are called. Common values for status are /. + +The function is only available as fastcall function, so it may only +be used in presence of a prototype. +It depends on the host machine if the program return code can be +evaluated or is ignored. + +, + + + + + +fast

+ + + +/ + +The function is specific to the C128. +2MHz clock will not work in 40 column mode. + +, +, + + + + + +feof

+ + + +/ + +The indicator is set only after a read past the end of a file is +attempted. +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, + + + + + +ferror

+ + + +/ + +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, + + + + + +fileno

+ + + +/ + +The function is only available as fastcall function, so it may only be +used in presence of a prototype. +Mixing C file I/O functions and POSIX file I/O functions for the same +file may have unpredictable results. + +, + + + + + + + +free

+ + + +/ +/, / +or /. As an exception, if the passed +pointer is +Passing an already free'd block to The function is only available as fastcall function, so it may only +be used in presence of a prototype. + +, +, +, +, +, +, + + + + + +get_ostype

+ + + +, +, / + +The function does not exist on all platforms. +The return codes are platform dependent. + + + + + +getenv

+ + + +/ + +What exactly is stored in the environment depends on the machine the +program is running on. +The function is only available as fastcall function, so it may only +be used in presence of a prototype. + + + + + +getcpu

+ + + +/ + + + +Other, more exotic CPU types are not disinguished. + + + + + +gotox

+ + + +/ + +The function is only available as fastcall function, so it may +only be used in presence of a prototype. +Invalid values for the X position (out of screen coordinates) may +lead to undefined behaviour. + +, +, +, + + + + + +gotoxy

+ + + +/ + +The function is only available as fastcall function, so it may only be +used in presence of a prototype. +Invalid values for any of both coordinates (out of screen positions) may +lead to undefined behaviour. + +, +, +, + + + + + +gotoy

+ + + +/ + +The function is only available as fastcall function, so it may +only be used in presence of a prototype. +Invalid values for the Y position (out of screen coordinates) may lead +to undefined behaviour. + +, +, +, + + + + + +isalnum

+ + + +/ + +When compiling with When compiling without +, +, +, +, +, +, +, +, +, +, +, + + + + + +isalpha

+ + + +/ + +When compiling with When compiling without +, +, +, +, +, +, +, +, +, +, +, + + + + + +isascii

+ + + +/ + +When compiling with When compiling without +, +, +, +, +, +, +, +, +, +, +, + + + + + +isblank

+ + + +/ + +When compiling with When compiling without +, +, +, +, +, +, +, +, +, +, +, + + + + + +iscntrl

+ + + +/ + +When compiling with When compiling without +, +, +, +, +, +, +, +, +, +, +, + + + + + +isdigit

+ + + +/ + +When compiling with When compiling without +, +, +, +, +, +, +, +, +, +, +, + + + + + +isgraph

+ + + +/ + +When compiling with When compiling without +, +, +, +, +, +, +, +, +, +, +, + + + + + +islower

+ + + +/ + +When compiling with When compiling without +, +, +, +, +, +, +, +, +, +, +, + + + + + +isprint

+ + + +/ + +When compiling with When compiling without +, +, +, +, +, +, +, +, +, +, +, + + + + + +ispunct

+ + + +/ + +When compiling with When compiling without +, +, +, +, +, +, +, +, +, +, +, + + + + + +isspace

+ + + +/ + +When compiling with When compiling without +, +, +, +, +, +, +, +, +, +, +, + + + + + +isupper

+ + + +/ + +When compiling with When compiling without +, +, +, +, +, +, +, +, +, +, +, + + + + + +isxdigit

+ + + +/ + +When compiling with When compiling without +, +, +, +, +, +, +, +, +, +, +, + + + + + +itoa

+ + + +/ + +There are no provisions to prevent a buffer overflow. +If The function is non standard, so it is not available in strict ANSI mode. +You should probably use The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, +, +, +, + + + + + +joy_count

+ + + +/ + +A joystick driver must be loaded using before calling this function. +The function returns the number of joysticks supported by the driver. +There's no way to check for the number of actually connected joysticks. +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, + + + + + +joy_install

+ + + +/ + +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, +, + + + + + +joy_load_driver

+ + + +/ + +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, +, + + + + + +joy_read

+ + + +/ +. + +A joystick driver must be loaded using before calling this function. +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, +, + + + + + +joy_uninstall

+ + + +/ + +A joystick driver must be installed using before calling this function. +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, +, + + + + + +joy_unload

+ + + +/ + +A joystick driver must be loaded using before calling this function. +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + + + + + + +kbhit

+ + + +/ + +If the system does not support a keyboard buffer (most systems +do), the function is rather useless. + +, + + + + + +labs

+ + + +/ + +The return value is undefined if The function is only available as fastcall function, so it may only be +used in presence of a prototype. + + + + + + +ltoa

+ + + +/ + +There are no provisions to prevent a buffer overflow. +If The function is non standard, so it is not available in strict ANSI mode. +You should probably use The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, +, +, +, + + + + + +localeconv

+ + + +/ + +cc65 supports only the "C" locale, so even after setting a new locale +using /, the structure returned will +always be the same. + + + + + + +longjmp

+ + + +/ +/. Program execution continues as if the +call to / has just returned the value + +If the parameter The function is only available as fastcall function, so it may only +be used in presence of a prototype. + + + + + + +malloc

+ + + +/ + +The function is only available as fastcall function, so it may only +be used in presence of a prototype. + +, +, +, +, +, +, +, + + + + + +memchr

+ + + +/ + +The function is only available as fastcall function, so it may only +be used in presence of a prototype. + + + + + + +memcpy

+ + + +/ + +The result is undefined if the memory areas do overlap. Use +/ to copy overlapping memory areas. +The function is only available as fastcall function, so it may only +be used in presence of a prototype. + +, +, + + + + + +memmove

+ + + +/ + +While /. +The function is only available as fastcall function, so it may only +be used in presence of a prototype. + +, +, + + + + + +memset

+ + + +/ + +The function is only available as fastcall function, so it may only +be used in presence of a prototype. + +, +, +, + + + + + +mod_free

+ + + +/ +/ function. + +The pointer passed as parameter is the pointer to the module memory, +not the pointer to the control structure. + + + + + + +mod_load

+ + + +/ + + + +The linker is needed to create +relocatable o65 modules for use with this function. + + + + + + +mouse_setbox

+ + + +/ + +The function does not check if the mouse cursor is currently within the +given rectangle. Placing the mouse cursor within the bounding box is the +responsibility of the programmer. +While the bounding box may be larger than the actual screen size, the +standard mouse cursor draw routines may fail to set the cursor to coordinates +outside of the screen area. Depending on the platform, you may have to supply +your own mouse cursor routines. +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, + + + + + +mouse_getbox

+ + + +/ + +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, + + + + + +mouse_buttons

+ + + +/ + +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, + + + + + +mouse_geterrormsg

+ + + +/ + +The function will return "Unknown error" for invalid error codes. +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, +, + + + + + +mouse_hide

+ + + +/ +/ and +/ to make the mouse cursor +visible. + +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + + + + + + +mouse_info

+ + + +/ + +The / instead. +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, + + + + + +mouse_install

+ + + +/ + +Not all drivers are able to detect if the supported hardware is really +present. +After installing a driver, the mouse cursor is hidden. +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, +, + + + + + +mouse_ioctl

+ + + +/ + +Calling this function is non portable, because each driver may +implement different ioctl calls (or none at all). +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + + + + + +mouse_load_driver

+ + + +/ + +The driver is loaded by name, so currently you must know the type of +mouse that should be supported. There is no autodetect capability. +Not all drivers are able to detect if the supported hardware is really +present. +After installing a driver, the mouse cursor is hidden. +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, +, + + + + + +mouse_move

+ + + +/ + +The function does not check if the new position is within the bounding +box specified with /. +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, + + + + + +mouse_pos

+ + + +/ + +The / instead. +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, + + + + + +mouse_show

+ + + +/ +/ and +/. + +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + + + + + + +mouse_uninstall

+ + + +/ + +If the driver has been loaded using /, / +should be used instead of The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, +, + + + + + +mouse_unload

+ + + +/ + +The function does nothing if no driver is loaded. + +, +, + + + + + +offsetof

+ + + +/ + +The function is actually a macro. + + + + + +open

+ + + +/ + +POSIX specifies an additional +, + + + + + +peekbsys

+ + + +/, +/ + +The function is only available as fastcall function, so it may only +be used in presence of a prototype. +This function may be a macro depending on the compiler options. The +actual function is accessible by #undef'ing the macro. + +, +, +, +, + + + + + +peekwsys

+ + + +/, +/ + +The function is only available as fastcall function, so it may only +be used in presence of a prototype. +The order in which the two bytes are read is undefined. + +, +, +, +, + + + + + +perror

+ + + +/ +/ with an argument of +The function is only available as fastcall function, so it may only +be used in presence of a prototype. + +, + + + + + +pokebsys

+ + + +/, +/ + +The function is only available as fastcall function, so it may only +be used in presence of a prototype. + +, +, +, +, + + + + + +pokewsys

+ + + +/, +/ + +The function is only available as fastcall function, so it may only +be used in presence of a prototype. +The order in which the two bytes are written is undefined. + +, +, +, +, + + + + + +qsort

+ + + +/ + +If there are multiple members with the same key, the order after calling +the function is undefined. +The function is only available as fastcall function, so it may only +be used in presence of a prototype. + + + + + + +raise

+ + + +/ + +The function is only available as fastcall function, so it may only +be used in presence of a prototype. , -, -, -, -, -, -, -, -, -, -, - +, + -isascii

+rand

-/ -/ + -When compiling with When compiling without Without using , always the same +flow of numbers is generated. +On startup, the function behaves as if +had been used with an argument of 1. , -, -, -, -, -, -, -, -, -, -, - +, + -isblank

+realloc

-/ -/ + +The part of the memory block that is returned will have its contents +unchanged. +This function is somewhat dangerous to use. Be careful to save the +pointer you're passing somewhere else, otherwise + + ptr = realloc (ptr, size); + +will loose your only copy of The function is only available as fastcall function, so it may only +be used in presence of a prototype. + +, +, +, +, +, +, + + + + + +remove

+ + + +/ + +This function is not available on all cc65 targets (depends on the +availability of file I/O). +The function is only available as fastcall function, so it may only +be used in presence of a prototype. + +, + + +#include <stdio.h> + +#define FILENAME "helloworld" + +if (remove (FILENAME) == 0) { + printf ("We deleted %s successfully\n", FILENAME); +} else { + printf ("There was a problem deleting %s\n", FILENAME); +} + + + + + +rename

+ + + +/ + +This function is not available on all cc65 targets (depends on the +capabilities of the storage devices). +The function is only available as fastcall function, so it may only +be used in presence of a prototype. + + + +#include <stdio.h> + +#define OLDNAME "textfile.txt" +#define NEWNAME "textfile.bak" + +if (rename (OLDNAME, NEWNAME) == 0) { + printf ("Renamed %s to %s\n", OLDNAME, NEWNAME); +} else { + printf ("Error renaming %s to %s\n", OLDNAME, NEWNAME); +} + + + + + +reset_brk

+ + + +/ + +Since / installs an exit handler, +it is not strictly necessary to call this function as part of the cleanup when +the program ends. + + + + + + +revers

+ + + +/ + -When compiling with When compiling without The function may not be supported by the hardware, in which case +the call is ignored. +The function is only available as fastcall function, so it may only +be used in presence of a prototype. , -, -, -, -, -, -, -, -, -, -, - + -iscntrl

+screensize

-/ -/ + -When compiling with When compiling without The function is only available as fastcall function, so it may only +be used in presence of a prototype. + +, +, +, +, + + + + + +set_brk

+ + + +/ + +The function is only available as fastcall function, so it may only +be used in presence of a prototype. +The stub saves the zero page registers used by the C runtime and switches +to a small break handler stack. This means that it is safe to execute C code, +even if C code was interrupted. Be careful however not to use too many local +variables, and do not enable stack checks for the handler function or any other +function called from it. +The Since / as part of the cleanup when +the program terminates. + + + + + + +setjmp

+ + + +/ +/ function and +returns zero. + +The function is only available as fastcall function, so it may only +be used in presence of a prototype. + , -, -, -, -, -, -, -, -, -, -, - + -isdigit

+setlocale

-/ - -When compiling with When compiling without / + +The function is only available as fastcall function, so it may only +be used in presence of a prototype. +cc65 supports only the "C" locale, so calling this function to set a +different locale has no effect. , -, -, -, -, -, -, -, -, -, -, - +, + + -isgraph

+signal

-/ - -When compiling with When compiling without / + +The function is only available as fastcall function, so it may only +be used in presence of a prototype. , -, -, -, -, -, -, -, -, -, -, - +, + -islower

+sleep

-/ -/ + -When compiling with When compiling without The function is only available as fastcall function, so it may only +be used in presence of a prototype. -, -, -, -, -, -, -, -, -, -, -, - + -isprint

+slow

-/ -/ + -When compiling with When compiling without The function is specific to the C128. -, -, -, -, -, -, -, -, -, -, -, - +, +, + -ispunct

+srand

-/ -/ + -When compiling with When compiling without The function is only available as fastcall function, so it may only +be used in presence of a prototype. , -, -, -, -, -, -, -, -, -, -, - +, + -isspace

+strcasecmp

-/ -/ + -When compiling with When compiling without The function is only available as fastcall function, so it may only +be used in presence of a prototype. +The function is not available in strict ANSI mode. -, -, -, -, -, -, -, -, -, -, -, - +, +, +, + + -isupper

+strcat

-/ -/ + -When compiling with When compiling without The function is only available as fastcall function, so it may only +be used in presence of a prototype. +If copying takes place between objects that overlap, the behaviour +is undefined. , -, -, -, -, -, -, -, -, -, -, - +, +, + -isxdigit

+strchr

-/ -/ + -When compiling with When compiling without The function is only available as fastcall function, so it may only +be used in presence of a prototype. , -, -, -, -, -, -, -, -, -, -, - +, + -kbhit

+strcmp

-/ -/ + -If the system does not support a keyboard buffer (most systems -do), the function is rather useless. +The function is only available as fastcall function, so it may only +be used in presence of a prototype. -, - +, +, +, + + -labs

+strcoll

-/ -/ +/. It returns a value that is less than zero if -The return value is undefined if The function is only available as fastcall function, so it may only be -used in presence of a prototype. +The function is only available as fastcall function, so it may only +be used in presence of a prototype. +, +, +, +, + + -revers

+strcpy

-/ -/ + -The function may not be supported by the hardware, in which case -the call is ignored. The function is only available as fastcall function, so it may only be used in presence of a prototype. +If copying takes place between objects that overlap, the behaviour +is undefined. - -, +, + + +#include <string.h> + +static char hello[14]; + +strcpy (hello, "Hello world!\n"); + -screensize

+strcspn

-/ -/ +not consist of +characters contained in the string The function is only available as fastcall function, so it may only be used in presence of a prototype. -, -, -, -, - +, +, + -strcat

+strdup

-/ - The function is only available as fastcall function, so it may only be used in presence of a prototype. -If copying takes place between objects that overlap, the behavior -is undefined. +It is up to the caller to free the allocated memory block. - +, + -strchr

+strerror

-/ - The function is only available as fastcall function, so it may only be used in presence of a prototype. +While the return type of the function is a + -strcpy

+stricmp

-/ - The function is only available as fastcall function, so it may only be used in presence of a prototype. -If copying takes place between objects that overlap, the behavior -is undefined. +The function is not available in strict ANSI mode. - - - -#include - -static char hello[14]; - -strcpy (hello, "Hello world!\n"); - +, +, +, + + + @@ -1625,7 +4541,7 @@ be used in presence of a prototype. +, @@ -1639,6 +4555,61 @@ See +strncat

+ + + +/ + +The function is only available as fastcall function, so it may only +be used in presence of a prototype. +If copying takes place between objects that overlap, the behaviour +is undefined. + +, +, + + + + + +strncmp

+ + + +/ + +The function is only available as fastcall function, so it may only +be used in presence of a prototype. + +, +, +, + + + + + + strncpy

@@ -1655,13 +4626,14 @@ written. The function will always return The function is only available as fastcall function, so it may only be used in presence of a prototype. If there is no null byte in the first If copying takes place between objects that overlap, the behavior is +If copying takes place between objects that overlap, the behaviour is undefined. - +, +, + #include @@ -1698,6 +4670,112 @@ be used in presence of a prototype. +strspn

+ + + +/ + +The function is only available as fastcall function, so it may only +be used in presence of a prototype. + +, + + + + + +strstr

+ + + +/ + +The function is only available as fastcall function, so it may only +be used in presence of a prototype. + +, + + + + + +strtok

+ + + +/ + +The function is only available as fastcall function, so it may only +be used in presence of a prototype. + +, + + + + + +strxfrm

+ + + +/ + +If The function is only available as fastcall function, so it may only +be used in presence of a prototype. +Since cc65 doesn't support different charcter sets, . + +, +, +, + + + + strupper

@@ -1754,6 +4832,54 @@ be used in presence of a prototype. +time

+ + + +/ + +The function is only available as fastcall function, so it may +only be used in presence of a prototype. +Many platforms supported by cc65 do not have a realtime clock, so the +returned value may not be valid. + + + + + +toggle_videomode

+ + + +/ + +The function is specific to the C128. +This function is deprecated. Please use instead! + +, +, + + + + + tolower

@@ -1800,6 +4926,161 @@ only be used in presence of a prototype. +ultoa

+ + + +/ + +There are no provisions to prevent a buffer overflow. +The function is non standard, so it is not available in strict ANSI mode. +You should probably use The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, +, +, +, + + + + + +unlink

+ + + +/ + +The use of this function is discouraged. Please use / instead, which is a native ANSI C function and does the same. +This function is not available on all cc65 targets (depends on the +availability of file I/O). +The function is only available as fastcall function, so it may only +be used in presence of a prototype. +Instead of / should be +used, which has the same semantics, but is more portable, because it conforms +to the ISO C standard. + + + +#include <stdio.h> +#include <unistd.h> + +#define FILENAME "helloworld" + +if (unlink (FILENAME) == 0) { + printf ("We deleted %s successfully\n", FILENAME); +} else { + printf ("There was a problem deleting %s\n", FILENAME); +} + + + + + +utoa

+ + + +/ + +There are no provisions to prevent a buffer overflow. +The function is non standard, so it is not available in strict ANSI mode. +You should probably use The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, +, +, +, + + + + + +vcprintf

+ + + +/ +/. --> + +Like all other The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, +, +, +, + + + + + +videomode

+ + + +, +/ + +The function is specific to the C128 and enhanced Apple //e. +This function replaces . +The function is only available as fastcall function, so it may only be +used in presence of a prototype. + +, +, + + + + + wherex

@@ -1841,5 +5122,3 @@ cursor. Zero is returned for the uppermost screen position. - -