dcstringcprintf.f90 File Reference

Go to the source code of this file.

Functions/Subroutines
character(len=string) function	dcstringcprintf (fmt, i, r, d, l, n, c1, c2, c3, ca, maxlen)
	Formatted output conversion (function version).
character(len=token) function	dcstringcprintft (fmt, i, r, d, l, n, c1, c2, c3, ca, maxlen)

Function/Subroutine Documentation

dcstringcprintf()

character(len = string) function dcstringcprintf	(	character(*), intent(in)	fmt,
		integer, dimension(:), intent(in), optional	i,
		real(sp), dimension(:), intent(in), optional	r,
		real(dp), dimension(:), intent(in), optional	d,
		logical, dimension(:), intent(in), optional	l,
		integer, dimension(:), intent(in), optional	n,
		character(*), intent(in), optional	c1,
		character(*), intent(in), optional	c2,
		character(*), intent(in), optional	c3,
		character(*), dimension(:), intent(in), optional	ca,
		integer, intent(in), optional	maxlen )

Formatted output conversion (function version).

Author

Yasuhiro MORIKAWA, Eizi TOYODA

Copyright

Copyright (C) GFD Dennou Club, 2000-2026. All rights reserved.
License is BSD-2-Clause. see COPYRIGHT in detail

Format a string like C sprintf(3) and return it. Note that the implementation is quite different from C sprintf(3).

Format string and return result

Return a formatted string according to format string fmt. Use specifiers starting with '' in fmt. Use '%' to output a literal ''. See dcstringsprintf.f90 for specifier details and examples.

Parameters

[in]	fmt	Format string with specifiers
[in]	i	Integer array data for d, o, x
[in]	r	Single precision real array data for r
[in]	d	Double precision real array data for f
[in]	L	Logical array data for b, y
[in]	n	Repeat counts for %* specifier
[in]	c1	First character string for c
[in]	c2	Second character string for c
[in]	c3	Third character string for c
[in]	ca	Character array for a

Returns

Formatted string

Definition at line 65 of file dcstringcprintf.f90.

 
  use dc_types, only: string, dp, sp
  use dc_string, only: printf
  implicit none
  character(len = STRING):: result
  character(*), intent(in):: fmt
  integer, intent(in), optional:: i(:), n(:)
  real(SP), intent(in), optional:: r(:)
  real(DP), intent(in), optional:: d(:)
  logical, intent(in), optional:: L(:)
  character(*), intent(in), optional:: c1, c2, c3
  character(*), intent(in), optional:: ca(:)
  integer, intent(in), optional:: maxlen
  integer:: out_len
  continue
  call printf(result, fmt, i=i, r=r, d=d, l=l, n=n, c1=c1, c2=c2, c3=c3, ca=ca)
  if (present(maxlen)) then
    out_len = max(0, min(len(result), maxlen))
    if (out_len == 0) then
      result = ''
    else if (out_len < len(result)) then
      result = result(1:out_len)
    end if
  end if

References dc_types::dp, dc_types::sp, and dc_types::string.

dcstringcprintft()

character(len = token) function dcstringcprintft	(	character(*), intent(in)	fmt,
		integer, dimension(:), intent(in), optional	i,
		real(sp), dimension(:), intent(in), optional	r,
		real(dp), dimension(:), intent(in), optional	d,
		logical, dimension(:), intent(in), optional	l,
		integer, dimension(:), intent(in), optional	n,
		character(*), intent(in), optional	c1,
		character(*), intent(in), optional	c2,
		character(*), intent(in), optional	c3,
		character(*), dimension(:), intent(in), optional	ca,
		integer, intent(in), optional	maxlen )

Definition at line 92 of file dcstringcprintf.f90.

 
  use dc_types, only: string, token, dp, sp
  use dc_string, only: cprintf
  implicit none
  character(len = TOKEN):: result
  character(*), intent(in):: fmt
  integer, intent(in), optional:: i(:), n(:)
  real(SP), intent(in), optional:: r(:)
  real(DP), intent(in), optional:: d(:)
  logical, intent(in), optional:: L(:)
  character(*), intent(in), optional:: c1, c2, c3
  character(*), intent(in), optional:: ca(:)
  integer, intent(in), optional:: maxlen
  character(len = STRING):: tmp
  integer:: out_len
  continue
  if (present(maxlen)) then
    tmp = cprintf(fmt, i=i, r=r, d=d, l=l, n=n, c1=c1, c2=c2, c3=c3, ca=ca, maxlen=maxlen)
    out_len = max(0, min(len(result), maxlen))
  else
    tmp = cprintf(fmt, i=i, r=r, d=d, l=l, n=n, c1=c1, c2=c2, c3=c3, ca=ca)
    out_len = len(result)
  end if
  result = ''
  if (out_len > 0) then
    result(1:out_len) = tmp(1:out_len)
  end if

References dc_types::dp, dc_types::sp, dc_types::string, and dc_types::token.