Spec and example update.

Author: chuckyvt

doc/specs/stdlib_io.md

@@ -17,7 +17,7 @@ Loads a rank-2 `array` from a text file.
 
 ### Syntax
 
-`call ` [[stdlib_io(module):loadtxt(interface)]] `(filename, array [, skiprows] [, max_rows])`
+`call ` [[stdlib_io(module):loadtxt(interface)]] `(filename, array [, skiprows] [, max_rows] [, fmt])`
 
 ### Arguments
 
@@ -29,6 +29,10 @@ Loads a rank-2 `array` from a text file.
 
 `max_rows` (optional): Read `max_rows` lines of content after `skiprows` lines. A negative value results in reading all lines. A value of zero results in no lines to be read. The default value is -1.
 
+`fmt` (optional): Fortran format specifier for the text read.  Defaults to the write format for the data type.  Setting fmt='*' will specify list directed read.   
+
+
+
 ### Return value
 
 Returns an allocated rank-2 `array` with the content of `filename`.

example/io/example_loadtxt.f90

@@ -3,4 +3,7 @@ program example_loadtxt
   implicit none
   real, allocatable :: x(:, :)
   call loadtxt('example.dat', x)
+  
+  ! Can also use list directed format if the default read fails.
+  call loadtxt('example.dat', x, fmt='*')
 end program example_loadtxt