summaryrefslogtreecommitdiffstats
path: root/ast/plot.f
blob: 27e83b4b347773a022a1831729b4029d0ef40ac5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
      CHARACTER * ( * ) FUNCTION AST_STRIPESCAPES( THIS, ATTRIB )
*+
* Name:
*     AST_STRIPESCAPES

*  Purpose:
*     Wrap up the C AST_STRIPESCAPES_A function.

*  Language:
*     Fortran 77

*  Invocation:
*     RESULT = AST_STRIPESCAPES( THIS, ATTRIB )

*  Description:
*     This function is a wrap-up of the C ast_stripescapes_a function. It
*     will rarely need to be used, but is provided for use on platforms
*     where the normal mechanism for returning character strings as
*     function results from C to Fortran (as defined in the f77.h
*     include file) doesn't work.
*
*     If this problem is encountered, the C macro NO_CHAR_FUNCTION
*     should be defined (in CFLAGS) during C compilation. This will
*     cause the function ast_stripescapes_a to be built (instead of
*     ast_stripescapes) and this returns its the result via an additional
*     initial argument. This Fortran function is then used simply to
*     transfer the argument value to the function result.

*  Arguments:
*     As for the C version of the Fortran-callable function ast_stripescapes.

*  Returned Value:
*     AST_STRIPESCAPES = CHARACTER * ( * )
*        The character return value required.

*  Notes:
*     - The length of the returned result is limited to 300 characters
*     by a local buffer. This length can be increased if necessary.

*  Authors:
*     DSB: David S Berry (JAC)
*     {enter_new_authors_here}

*  History:
*     10-JUL-2006 (DSB):
*        Original version.
*     {enter_changes_here}

*  Bugs:
*     {note_any_bugs_here}

*-

*  Type Definitions:
      IMPLICIT NONE              ! No implicit typing

*  Arguments Given:
      INTEGER THIS
      CHARACTER * ( * ) ATTRIB

*  Local Variables:
      CHARACTER * ( 300 ) BUFF   ! Local buffer for result
*.

*  Invoke the C function (with the additional argument).
      CALL AST_STRIPESCAPES_A( BUFF, THIS, ATTRIB )

*  Return the argument value as the function result.
      AST_STRIPESCAPES = BUFF

      END