---

C Library Functions  - filename_generator (3)

---

NAME

notopen(3f) - [M_io:FILENAME] generate a filename containing a number (LICENSE:PD)

CONTENTS

Synopsis
Description
Options
Examples
Author
License

SYNOPSIS

Usage

      function filename_generator(head,tail,num,lenlimit) result(filename)
      character(len=*),intent(in)  :: head
      character(len=*),intent(in)  :: tail
      integer,intent(in) :: num
      integer,intent(in) :: lenlimit
      character(len=:),allocatable :: filename

DESCRIPTION

Generate a filename containing a representation of the specified whole number. This is useful for generating a series of filenames differing by a number such as "file1.txt", "file2.txt", ... .

OPTIONS

head	filename prefix.
tail	filename suffix.
num	number to represent as a string between HEAD and TAIL.
lenlimit
	number of digits up to which to zero-pad the string representing NUM.

EXAMPLES

Sample program:

      program demo_filename_generator
      use,intrinsic::iso_fortran_env,only:int8,int16,int32,int64
      use M_io, only : filename_generator
      implicit none

          ! no zero-fill
          write(*,*) filename_generator("file_",".dat",11)
          ! zero-fill till 3 digits
          write(*,*) filename_generator("file_",".dat",11,3)
          ! zero-fill till 9 digits
          write(*,*) filename_generator("file_",".dat",11,9)
          ! same as default (no zero-fill)
          write(*,*) filename_generator("file_",".dat",11,0)

      end program demo_filename_generator

Results

      > file_11.dat
      > file_011.dat
      > file_000000011.dat
      > file_11.dat

AUTHOR

Zh, Niu; with modifications by John S. Urban

LICENSE

Public Domain

---

Nemo Release 3.1

filename_generator (3)

February 23, 2025

Generated by manServer 1.08 from f9a5d3ce-6e62-45b0-bf3a-a0a5a886e06e using man macros.