Proposal for a reference string to number

example/strings/CMakeLists.txt

@@ -10,3 +10,4 @@ ADD_EXAMPLE(starts_with)
 ADD_EXAMPLE(strip)
 ADD_EXAMPLE(to_string)
 ADD_EXAMPLE(zfill)
+ADD_EXAMPLE(str2num)

example/strings/example_str2num.f90

@@ -0,0 +1,22 @@
+program example_str2num
+    use stdlib_kinds, only: dp
+    use stdlib_str2num
+    character(:), allocatable, target :: chain
+    character(len=:), pointer :: cptr
+    real(dp), allocatable :: r(:), p(:)
+    integer :: i 
+
+    chain = " 1.234   1.E1 1e0     0.1234E0  12.21e+001 -34.5E1"
+    allocate( r(6), p(6) )
+    !> Example for streamline conversion using `str2float_p`
+    cptr => chain
+    do i =1, 6
+        r(i) = str2float_p( cptr ) !> the pointer is shifted within the function
+    end do
+    read(chain,*) p
+    print *, "Reading with str2num"
+    print *, r
+    print *, "Reading with formatted read"
+    print *, p
+
+end program