Merge branch 'fortran-lang:master' into activations

Author: jalvesz

CMakeLists.txt

@@ -4,7 +4,7 @@ cmake_minimum_required(VERSION 3.14.0)
 set(CMAKE_USER_MAKE_RULES_OVERRIDE ${CMAKE_CURRENT_SOURCE_DIR}/config/DefaultFlags.cmake)
 
 project(fortran_stdlib
-        LANGUAGES Fortran
+	LANGUAGES Fortran C
         DESCRIPTION "Community driven and agreed upon de facto standard library for Fortran"
 )
 

config/fypp_deployment.py

@@ -105,7 +105,7 @@ def recursive_copy(folder):
         for root, _, files in os.walk(folder):
             for file in files:
                 if file not in prune:
-                    if file.endswith(".f90") or file.endswith(".F90") or file.endswith(".dat") or file.endswith(".npy"):
+                    if file.endswith((".f90", ".F90", ".dat", ".npy", ".c")):
                         shutil.copy2(os.path.join(root, file), base_folder+os.sep+folder+os.sep+file)
     recursive_copy('src')
     recursive_copy('test')

doc/specs/index.md

@@ -17,6 +17,7 @@ This is an index/directory of the specifications (specs) for each new module/fea
  - [constants](./stdlib_constants.html) - Constants
  - [bitsets](./stdlib_bitsets.html) - Bitset data types and procedures
  - [error](./stdlib_error.html) - Catching and handling errors
+ - [state_type](./stdlib_error_state_type.html) - General state and error handling 
  - [hash](./stdlib_hash_procedures.html) - Hashing integer
  vectors or character strings
  - [hashmaps](./stdlib_hashmaps.html) - Hash maps/tables
@@ -37,6 +38,7 @@ This is an index/directory of the specifications (specs) for each new module/fea
  - [string\_type](./stdlib_string_type.html) - Basic string support
  - [stringlist_type](./stdlib_stringlist_type.html) - 1-Dimensional list of strings
  - [strings](./stdlib_strings.html) - String handling and manipulation routines
+ - [system](./stdlib_system.html) - OS and sub-processing routines
  - [version](./stdlib_version.html) - Version information
 
 ## Released/Stable Features & Modules

doc/specs/stdlib_error_state_type.md

@@ -0,0 +1,59 @@
+---
+title: state_type
+---
+
+# State and Error Handling Derived Type
+
+[TOC]
+
+## Introduction
+
+The `stdlib_error` module provides a derived type holding information on the state of operations within the standard library and procedures for expert control of workflows.
+An optional `state_type` variable to hold such information is provided as a form of expert API.
+If the user does not require state information but fatal errors are encountered during execution, the program will undergo a hard stop.
+Instead, if the state argument is present, the program will never stop but will return detailed error information into the state handler.
+
+## Derived types provided
+
+<!-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -->
+### The `state_type` derived type
+
+The `state_type` is defined as a derived type containing an integer error flag and fixed-size character strings to store an error message and the location of the error state change.
+Fixed-size string storage was chosen to facilitate the compiler's memory allocation and ultimately ensure maximum computational performance.  
+
+A similarly named generic interface, `state_type`, is provided to allow the developer to create diagnostic messages and raise error flags easily. 
+The call starts with an error flag or the location of the event and is followed by an arbitrary list of `integer`, `real`, `complex`, or `character` variables. 
+Numeric variables may be provided as either scalars or rank-1 (array) inputs.
+
+#### Type-bound procedures
+
+The following convenience type-bound procedures are provided:
+- `print()` returns an allocatable character string containing state location, message, and error flag;
+- `print_message()` returns an allocatable character string containing the state message;
+- `ok()` returns a `logical` flag that is `.true.` in case of successful state (`flag==STDLIB_SUCCESS`);
+- `error()` returns a `logical` flag that is `.true.` in case of an error state (`flag/=STDLIB_SUCCESS`).
+
+#### Status
+
+Experimental
+
+#### Example
+
+```fortran
+{!example/error/example_error_state1.f90!}
+```
+
+## Error flags provided
+
+The module provides the following state flags:
+- `STDLIB_SUCCESS`: Successful execution
+- `STDLIB_VALUE_ERROR`: Numerical errors (such as infinity, not-a-number, range bounds) are encountered.
+- `STDLIB_LINALG_ERROR`: Linear Algebra errors are encountered, such as non-converging iterations, impossible operations, etc.
+- `STDLIB_INTERNAL_ERROR`: Provided as a developer safeguard for internal errors that should never occur.
+- `STDLIB_IO_ERROR`: Input/Output-related errors, such as file reading/writing failures.
+- `STDLIB_FS_ERROR`: File system-related errors, such as directory access issues.
+
+## Comparison operators provided
+
+The module provides overloaded comparison operators for all comparisons of a `state_type` variable with an integer error flag: `<`, `<=`, `==`, `>=`, `>`, `/=`.
+