https://github.com/urbanjost/m_list

maintain a small array as a list
https://github.com/urbanjost/m_list

fortran-package-manager

Last synced: about 6 hours ago
JSON representation

maintain a small array as a list

• Host: GitHub
• URL: https://github.com/urbanjost/m_list
• Owner: urbanjost
• License: unlicense
• Created: 2021-01-13T03:00:44.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2024-03-29T08:20:52.000Z (7 months ago)
• Last Synced: 2024-03-30T04:37:42.681Z (7 months ago)
• Topics: fortran-package-manager
• Language: Fortran
• Homepage:
• Size: 1.66 MB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![list](docs/images/list.gif)](https://urbanjost.github.io/M_list/fpm-ford/index.html)

# [M_list and associated files](https://urbanjost.github.io/M_list/man3.html)

## Name

   M_list(3f) and M_list__oop(3f) - maintain a sorted intrinsic type

   array in Fortran

## Description

   As shown in the examples the M_list(3f) module contains simple routines

   to add, replace  and delete values from an automatically sorted array,

   which allows for creating simple dictionaries.

   The advantage of this routine over more conventional methods is

   that the dictionary components are simple arrays which can be easily

   accessed with standard routines.

   Each time an entry is added or deleted the array is re-allocated.

   Because of the expense of reallocating the data these routines are best

   suited for maintaining small lists that do not change size frequently.

   For more demanding needs, see linked-list methods for maintaining

   generic dictionaries; several examples of which are available on the

   Fortran Wiki.

## Building the Module Using make(1) ![gmake](docs/images/gnu.gif)

Just download the github repository, enter the src/ directory and run make(1):

     git clone https://github.com/urbanjost/M_list.git

     cd M_list/src

     # change Makefile if not using one of the listed compilers

     

     # for gfortran

     make clean

     make F90=gfortran gfortran

     

     # for ifort

     make clean

     make F90=ifort ifort

     # for nvfortran

     make clean

     make F90=nvfortran nvfortran

     # optionally

     make run  # run all the demo programs from the man-pages

     make help # see other developer options

This will compile the M_list(3f) module.

## Build and Test with fpm  ![fpm](docs/images/fpm_logo.gif)

Alternatively, download the github repository and build it with 

fpm ( as described at [Fortran Package Manager](https://github.com/fortran-lang/fpm) )

```bash

     git clone https://github.com/urbanjost/M_list.git

     cd M_list

     fpm test  # run unit tests

     # optionally run the example programs from the man-pages in the example/ directory

     fpm run --example "*"

```

or just list it as a dependency in your fpm.toml project file.

```toml

     [dependencies]

     M_list        = { git = "https://github.com/urbanjost/M_list.git" ,tag="v1.0.1"}

```

#### (registered at the [fpm(1) registry](https://github.com/fortran-lang/fpm-registry) )

## Documentation   ![docs](docs/images/docs.gif)

### User

 - A single page that uses javascript to combine all the HTML descriptions

   of the man-pages is at

   [BOOK_M_list](https://urbanjost.github.io/M_list/BOOK_M_list.html).

 - An [index](https://urbanjost.github.io/M_list/man3.html) to HTML versions

   of the man-pages 

 - man-pages in 

    + [manpages.zip](https://urbanjost.github.io/M_list/manpages.zip) 

    + [manpages.tgz](https://urbanjost.github.io/M_list/manpages.tgz) 

### Developer

   - [ford(1) output](https://urbanjost.github.io/M_list/fpm-ford/index.html).

   - [github action status](docs/STATUS.md) 

## Demo Programs![demos](docs/images/demo.gif)

   There are demo programs extracted from the man pages in the [example/](example/) directory