---

C Library Functions  - retrev (3)

---

NAME

RETREV(3f) - [ARGUMENTS:M_kracken] get keyword value as a string from a command’s argument list processed by kracken(3f) (LICENSE:PD)

CONTENTS

Synopsis
Description
Options
Examples
See Also
Author
License

SYNOPSIS

SUBROUTINE retrev(name, string, len, ier)

   CHARACTER(len=*),intent(in)  :: name
   CHARACTER(len=*),intent(out) :: string
   INTEGER,intent(out)          :: len
   INTEGER,intent(out)          :: ier

DESCRIPTION

When a command has had its command argument list parsed using the kracken(3f) routine the value associated with any keyword can be retrieved as a string.

OPTIONS

NAME	parameter name of form VERB_KEYWORD
STRING	returned parameter value
LEN	length of returned STRING
IER	error flag. Any non-zero value means an error occurred

EXAMPLES

Sample program:

    program demo_retrev
    use M_kracken, only : kracken, retrev
    use M_kracken, only : IPvalue ! length of keyword value
    implicit none
    character(len=IPvalue) :: val
    integer                :: len, ier

    call kracken(’demo’, ’ -value my default string’)
    call retrev(’demo_value’,val,len,ier)
    write(*,’(a)’)’VALUE IS ’//trim(val)

    end program demo_retrev

Example execution and output:

    $ ./demo_retrev
    VALUE IS my default string

    $ ./demo_retrev -value use this value instead
    VALUE IS use this value instead

SEE ALSO

M_kracken(3f),
	kracken(3f)

dget(3f), dgets(3f), iget(3f), igets(3f), lget(3f), lgets(3f), rget(3f), rgets(3f), sget(3f), sgets(3f), retrev(3f)

parse(3f), dissect(3f), store(3f), setprompts(3f), show(3f)

AUTHOR

John S. Urban

LICENSE

Public Domain

---

Nemo Release 3.1

retrev (3)

February 23, 2025

Generated by manServer 1.08 from 6899223f-4fa2-45cc-b8c2-251f3557345f using man macros.