proc name[, arg1, arg2, ...]
[type frame/noframe, stdcall/cdecl]
[uses reg1, reg2, ...]
[var variable1] ; Works for frame and noframe types
[.variable1 dd ?] ; This works only with frame type.
begin
  return [val]
endp

[preserve reg1, reg2, ...] ; pushs and pops matching registers
invoke name[, arg1, arg2, ...] ; You can invoke your own functions and api functions with or without parameters
    

.import
%fasminc%\StdMacLib\windows.inc [9] .import [3]:
     library \
%fasminc%\StdMacLib\windows.inc [95] library [3]:
       if ~ name#.needed
error: undefined symbol.
    

format PE GUI 4.0
entry Start

OS fix Windows ; Use windows version of StdMacLib and StdLib

include '%fasminc%\stdmaclib.inc'

.code

proc foo
uses edx
begin
    mov edx, 100    
    return 2
endp

Start:
  preserve edx ; proc uses edx so invoke will push and pop edx
        invoke foo
  invoke ExitProcess, 0

.udata ; Uninitialised data section
    NotUsed dd ?

.idata ; Initialised data section
       NotUsed2 dd ?

.cdata ; Constant data section
 NotUsedStr db 'foobar',0

include '%fasminc%\macro\import.inc' ; How to fix this?!?
.import
    

proc mem.copy, source, dest, count
proc str.copy, source, dest    

proc mem.copy, dest, source, count
proc str.copy, dest, source    

;-----------------------------------
; MyLibraryName
; Short description of what MyLibrary does
;-----------------------------------
; copyright note, authors and contributors list
;-----------------------------------
    

Hi Aaro,
I must say that you've done quite impressive job
I would like to help to development of FASM standard library, as I consider it as very important thing. I just hope I will have enough time :////

I think Privalov should tak a look at your macro library - we need to have one common macro library, the same for Fresh and FASM.

1) the function categories:
- memory allocating
- string functions
- console i/o
- (more )

2) names, and namespaces: there are many ways of naming our functions, I think that it would be the best way to name functions like: str.new, str.len, mem.alloc, mem.free, etc.
Another question is whether to use uppercase in names; I like names in lowercase, with '_', so I prefer "my_id" than "MyID".
3) we also have to discuss about some conventions, for example if our functions will look like:

Code:

proc mem.copy, source, dest, count
proc str.copy, source, dest    

or:

Code:

proc mem.copy, dest, source, count
proc str.copy, dest, source    

udata
  MemLib.Var1
enddata
proc MemCopy, pDest, pSource, Count
    

4) some conventions for commenting code - for example common header, it could look like:

p.s. aaro, why did you started writing string library from scratch? In Fresh package there is already one lib for dynamic string handling.

Seriously, if i remember correctly fresh strlib is using string handles that i think is unnecessary, but if fresh team gives me approval of using some of their functions i'll check those out.

format PE GUI 4.0

OS fix Windows
include '%fasminc%\stdmaclib.inc'

.code

Start:
      invoke StrCat, sHello, sWorld
       push eax
    invoke StrRight, eax, 4
     push eax
    invoke MessageBox, 0, eax, eax, MB_OK
       call StrFree
        call StrFree
        
    invoke ExitProcess, 0

.cdata
sWorld           db 'World',0
sHello                db 'Hello',0

include '%fasminc%\macro\import.inc'

.end Start
    

Added:
StrCompCs
StrCopy
StrAlloc and StrFree      (Linux and Menuet)
.end macro (Windows.inc)
FileSetPos (Windows)

Changed:
StrAlloc and StrFree (Windows)
MemMove -> MemCopy

Fixed:
push and pop macros (Proc.inc)
StrMid

Updated:
proc macro to align procedures (Proc.inc)
StdLibApi.txt
TODO.txt
    

Added:
pushd, pushw, pushf, pushfd, pusha, pushad, popd, popw, popf, popfd, popa and popad macros (Proc.inc)
StrRepeat
StrInsert
StrDelMid
StrReplaceAt
ConInit, ConUninit, ConRead, ConWrite (Windows)

Changed:
pop macro to pop in same order that fasm does (Proc.inc)
push and pop macros to check for argument size (Proc.inc)
invoke and proc macros to use pushd and popd (Proc.inc)

Updated:
TODO.txt
    

Added:
StrToNum
StrFromNum
enumflags (StdMacLib.inc)
stackcheck and endcheck (StdMacLib.inc)

Changed:
return and endp macros not to halt on push/pop miscount (Proc.inc)
    

format PE GUI 4.0

OS fix Windows
include '%fasminc%\stdmaclib.inc'

.code

Start:
   invoke StrToNum, sTestNum, 16
       invoke StrFromNum, eax, 16, STR_UPPER+STR_SIGNED;+STR_PREFIX
        push eax
    invoke MessageBox, 0, eax, eax, MB_OK
       call StrFree

    invoke ExitProcess, 0

.idata
sTestNum db '-0xFA09afh',0

include '%fasminc%\macro\import.inc'

.end Start
    

Added:
FileSetPos (Windows)
FileGetPos (Windows)
FileGetSize (Windows)
FileGetTime (Windows)
FileSetAttributes (Windows)
FileGetAttributes (Windows)
FileMove (Windows)

Changed:
FileDelete
FileClose

Updated:
StdLibApi.txt
TODO.txt
    

Added:
ConFlush, ConSetPos, ConGetPos, ConSetColor, ConGetColor (Windows)
LF equ 13, 10 (Windows.inc)

Changed:
FileOpen (Windows)
FileSetAttributes -> FileSetAttribs
FileGetAttributes -> FileGetAttribs
var so now you can specify size of buffer allocated (Proc.inc)

Removed:
FileCreate (Windows)

Updated:
library, import and export macros with ones by Kevin_Zheng (Windows.inc)
FileRead (Windows)
FileSetPos (Windows)
StdLipApi.txt
TODO.txt
    

I have one problem with the macro library: i have defined import macros in StdMacLib\Windows.inc and fasm is complaining:

code:
.import
%fasminc%\StdMacLib\windows.inc [9] .import [3]:
library \
%fasminc%\StdMacLib\windows.inc [95] library [3]:
if ~ name#.needed
error: undefined symbol.



So if at the moment you have to include '%fasminc%\macro\import.inc' before your import section.. Any ideas how to fix this?

include '%fasminc%\stdlib.win.inc'

.idata
  Tmp     db 'FooBar',0

.udata
       hStr    dd ?

.code
Start:
     invoke ConInit
      invoke StrReverse, Tmp
      mov [hStr], eax 
    invoke ConWrite, eax, 0
     invoke ConRead, Tmp, 7
      invoke StrFree, [hStr]
      invoke ConUninit
    invoke ExitProcess, 0
       
.end Start