v1.0.0.1 update

- removed reliance on include files
- removed unused equates
- added support for assembling UASM64 for Linux x64 (experimental)
- added Array functions (untested)
- added more CPU functions
- added String functions (Ansi and Unicode)
- added Text functions (Ansi and Unicode)
- added File functions (Ansi and Unicode)
- added Memory functions
- updated mapping of older MASM32 library function names to UASM64 function names
- added CPU constants for CPU_Features and other functions
- updated api text files for RadASM and WinASM IDEs
- updated source code documentation to allow for auto-gen of sphinx .rst files for readthedocs.
- updated rst index files to include a table of functions for each category
- added BuildForWindows.bat and BuildForLinux.bat

Author: mrfearless

.gitattributes

@@ -1,5 +1,6 @@
 * text eol=crlf
 *.exe binary
+*.a binary
 *.dll binary
 *.zip binary
 *.obj binary
@@ -16,8 +17,10 @@
 *.bat linguist-language=Text
 *.tpl linguist-language=Text
 *.rap linguist-language=Text
+*.bat linguist-language=Text
 *.asm linguist-language=Assembly
 *.inc linguist-language=Assembly
+*.rc linguist-language=Text
 *.hsl linguist-language=Text
 makefile linguist-language=Text
 conf.py linguist-language=Python

.gitignore

@@ -1,6 +1,7 @@
 docs/build*/
 *.chm
 package_releases.bat
+gendocs.bat
 *.old
 *.obj
 *.used

.readthedocs.yaml

@@ -15,7 +15,7 @@ python:
 build:
   os: ubuntu-22.04
   tools:
-    python: "3.12"
+    python: "3.10"
 
 sphinx:
   builder: html

Arg_GetArgument.asm

@@ -11,12 +11,11 @@
 .x64
 
 option casemap : none
+IF @Platform EQ 1
 option win64 : 11
-option frame : auto
-option stackbase : rsp
+ENDIF
 
-_WIN64 EQU 1
-WINVER equ 0501h
+option frame : auto
  
 include UASM64.inc
 
@@ -96,6 +95,10 @@ UASM64_ALIGN
 ; the parser in this algorithm return an empty destination buffer that has an 
 ; ascii zero as it first character.
 ;
+; See Also:
+;
+; Arg_GetCommandLine, Arg_GetCommandLineEx
+; 
 ;------------------------------------------------------------------------------
 Arg_GetArgument PROC FRAME USES RBX RCX RDX RDI RSI lpszArgumentList:QWORD,lpszDestination:QWORD,nArgument:QWORD,qwArgumentListReadOffset:QWORD
 

Arg_GetCommandLine.asm

@@ -11,15 +11,19 @@
 .x64
 
 option casemap : none
+IF @Platform EQ 1
 option win64 : 11
+ENDIF
 option frame : auto
-option stackbase : rsp
 
-_WIN64 EQU 1
-WINVER equ 0501h
-
-include windows.inc
-includelib kernel32.lib
+IF @Platform EQ 1 ; Win x64
+    GetCommandLineA PROTO
+    includelib kernel32.lib
+ENDIF
+IF @Platform EQ 3 ; Linux x64
+; https://baturin.org/blog/hello-from-a-compiler-free-x86-64-world/
+; https://gist.github.com/Gydo194/730c1775f1e05fdca6e9b0c175636f5b
+ENDIF
 
 include UASM64.inc
 
@@ -58,9 +62,12 @@ UASM64_ALIGN
 ; The buffer for the returned argument should be set at 128 bytes in length 
 ; which is the maximum allowable
 ;
+; See Also:
+;
+; Arg_GetCommandLineEx, Arg_GetArgument
+; 
 ;------------------------------------------------------------------------------
 Arg_GetCommandLine PROC FRAME USES RCX RDI RSI nArgument:QWORD, lpszArgumentBuffer:QWORD
-
   ; -------------------------------------------------
   ; arguments returned in "lpszArgumentBuffer"
   ;
@@ -80,7 +87,15 @@ Arg_GetCommandLine PROC FRAME USES RCX RDI RSI nArgument:QWORD, lpszArgumentBuff
     LOCAL cmdBuffer[192] :BYTE
     LOCAL tmpBuffer[192] :BYTE
 
-    Invoke GetCommandLine
+    IF @Platform EQ 3 ; Linux x64
+        mov rax, 0 ; maybe we can get command line later with
+        ; ; https://baturin.org/blog/hello-from-a-compiler-free-x86-64-world/
+        ret
+    ENDIF
+    
+    IF @Platform EQ 1 ; Win x64
+        Invoke GetCommandLineA
+    ENDIF
     mov lpCmdLine, rax        ; address command line
 
   ; -------------------------------------------------

Arg_GetCommandLineEx.asm

@@ -11,22 +11,25 @@
 .x64
 
 option casemap : none
+IF @Platform EQ 1
 option win64 : 11
+ENDIF
 option frame : auto
-option stackbase : rsp
 
-_WIN64 EQU 1
-WINVER equ 0501h
-
-include windows.inc
-includelib kernel32.lib
-
-;EXTERNDEF ArgByNumber :PROTO ,,,:QWORD
+IF @Platform EQ 1 ; Win x64
+    GetCommandLineA PROTO
+    includelib kernel32.lib
+ENDIF
+IF @Platform EQ 3 ; Linux x64
+; https://baturin.org/blog/hello-from-a-compiler-free-x86-64-world/
+; https://gist.github.com/Gydo194/730c1775f1e05fdca6e9b0c175636f5b
+ENDIF
 
 include UASM64.inc
 
 .CODE
 
+IF @Platform EQ 1 ; Win x64
 UASM64_ALIGN
 ;------------------------------------------------------------------------------
 ; Arg_GetCommandLineEx
@@ -53,16 +56,23 @@ UASM64_ALIGN
 ; 	2 = no argument exists at specified arg number
 ; 	3 = non matching quotation marks
 ; 
+; See Also:
+;
+; Arg_GetCommandLine, Arg_GetArgument
+; 
 ;------------------------------------------------------------------------------
-Arg_GetCommandLineEx PROC FRAME nArgument:QWORD, lpszArgumentBuffer:QWORD
+Arg_GetCommandLineEx PROC FRAME USES RCX nArgument:QWORD, lpszArgumentBuffer:QWORD
+    LOCAL lpszArgsList:QWORD
 
  ; 1 = successful operation
  ; 2 = no argument exists at specified arg number
  ; 3 = non matching quotation marks
 
     add nArgument, 1
-    Invoke GetCommandLine
-    Invoke Arg_GetArgument, rax, lpszArgumentBuffer, nArgument, 0
+    
+    Invoke GetCommandLineA
+    mov lpszArgsList, rax
+    Invoke Arg_GetArgument, lpszArgsList, lpszArgumentBuffer, nArgument, 0
 
     .if rax >= 0
       mov rcx, lpszArgumentBuffer
@@ -78,7 +88,46 @@ Arg_GetCommandLineEx PROC FRAME nArgument:QWORD, lpszArgumentBuffer:QWORD
     ret
 
 Arg_GetCommandLineEx ENDP
+ENDIF
 
+IF @Platform EQ 3 ; Linux x64
+UASM64_ALIGN
+;------------------------------------------------------------------------------
+; Arg_GetCommandLineEx
+;
+; Extended version of Arg_GetCommandLine. This Arg_GetCommandLineEx function 
+; uses the Arg_GetArgument function to obtain the selected argument from a 
+; command line. It differs from the original version in that it will read a 
+; command line of any length and the arguments can be delimited by spaces, tabs, 
+; commas or any combination of the three.
+
+; It is also faster but as the Arg_GetArgument function is table driven, it is 
+; also larger.
+;
+; Parameters:
+; 
+; * nArgument - The argument number to return from a command line.
+; 
+; * lpszArgumentBuffer - The buffer to receive the selected argument.
+;
+; Returns:
+; 
+; There are three (3) possible return values:
+; 	1 = successful operation
+; 	2 = no argument exists at specified arg number
+; 	3 = non matching quotation marks
+; 
+; See Also:
+;
+; Arg_GetCommandLine, Arg_GetArgument
+; 
+;------------------------------------------------------------------------------
+Arg_GetCommandLineEx PROC FRAME nArgument:QWORD, lpszArgumentBuffer:QWORD
+    mov rax, 0 ; maybe we can get command line later with
+    ; ; https://baturin.org/blog/hello-from-a-compiler-free-x86-64-world/
+    ret
+Arg_GetCommandLineEx ENDP
+ENDIF
 
 END
 

Array_Create.asm

@@ -0,0 +1,95 @@
+;==============================================================================
+;
+; UASM64 Library
+;
+; https://github.com/mrfearless/UASM64-Library
+;
+;==============================================================================
+.686
+.MMX
+.XMM
+.x64
+
+option casemap : none
+IF @Platform EQ 1
+option win64 : 11
+ENDIF
+option frame : auto
+
+;GlobalAlloc PROTO uFlags:DWORD, qwBytes:QWORD
+
+;IFNDEF GMEM_FIXED
+;GMEM_FIXED EQU 0000h
+;ENDIF
+
+;includelib kernel32.lib
+
+include UASM64.inc
+
+PUBLIC d_e_f_a_u_l_t__n_u_l_l_$
+
+.DATA
+d_e_f_a_u_l_t__n_u_l_l_$ DQ 0     ; default null string as placeholder
+                         DQ 0,0,0
+
+.CODE
+
+UASM64_ALIGN
+;------------------------------------------------------------------------------
+; Array_Create
+;
+; Create a new array with a specified number of empty items.
+;
+; Parameters:
+; 
+; * nItemCount - Number of items that the array created will hold.
+; 
+; Returns:
+; 
+; A pointer to the newly created array, which is used with the other array 
+; functions, or 0 if an error occurred.
+; 
+; Notes:
+;
+; This function as based on the MASM32 Library function: arralloc
+;
+; See Also:
+;
+; Array_CreateEx, Array_Destroy, Array_Resize
+; 
+;------------------------------------------------------------------------------
+Array_Create PROC FRAME USES RCX RDX RSI nItemCount:QWORD
+
+    mov rax, nItemCount                         ; load the member count into EAX
+    add rax, 1                                  ; correct for 1 based array
+    lea rax, [0+rax*8]                          ; multiply it by 4 for memory size
+    
+    Invoke Memory_Alloc, rax
+    ;Invoke GlobalAlloc, GMEM_FIXED, rax
+    mov rsi, rax
+
+    test rax, rax                               ; if allocation failure return zero
+    jz quit
+
+    mov rax, rsi
+    mov rcx, nItemCount
+    mov QWORD PTR [rax], rcx                    ; write count to 1st member
+
+    xor rdx, rdx
+  @@:
+    add rdx, 1                                  ; write adress of null string to all members
+    lea rax, d_e_f_a_u_l_t__n_u_l_l_$
+    mov [rax+rdx*8], rax ; OFFSET d_e_f_a_u_l_t__n_u_l_l_$
+    cmp rdx, rcx
+    jle @B
+
+    mov rax, rsi                                ; return pointer array handle
+
+  quit:
+
+    ret
+Array_Create ENDP
+
+
+END
+