1 /* do not edit automatically generated by mc from FormatStrings. */
2 /* FormatStrings.def provides a pseudo printf capability.
4 Copyright (C) 2005-2024 Free Software Foundation, Inc.
5 Contributed by Gaius Mulley <gaius.mulley@southwales.ac.uk>.
7 This file is part of GNU Modula-2.
9 GNU Modula-2 is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3, or (at your option)
14 GNU Modula-2 is distributed in the hope that it will be useful, but
15 WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 General Public License for more details.
19 Under Section 7 of GPL version 3, you are granted additional
20 permissions described in the GCC Runtime Library Exception, version
21 3.1, as published by the Free Software Foundation.
23 You should have received a copy of the GNU General Public License and
24 a copy of the GCC Runtime Library Exception along with this program;
25 see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
26 <http://www.gnu.org/licenses/>. */
29 #if !defined (_FormatStrings_H)
30 # define _FormatStrings_H
38 # if !defined (PROC_D)
40 typedef void (*PROC_t
) (void);
41 typedef struct { PROC_t proc
; } PROC
;
45 # include "GDynamicStrings.h"
47 # if defined (_FormatStrings_C)
50 # define EXTERN extern
55 Sprintf0 - returns a String containing, fmt, after it has had its
56 escape sequences translated.
59 EXTERN DynamicStrings_String
FormatStrings_Sprintf0 (DynamicStrings_String fmt
);
62 Sprintf1 - returns a String containing, fmt, together with
63 encapsulated entity, w. It only formats the
64 first %s or %d with n.
67 EXTERN DynamicStrings_String
FormatStrings_Sprintf1 (DynamicStrings_String fmt
, const unsigned char *w_
, unsigned int _w_high
);
70 Sprintf2 - returns a string, fmt, which has been formatted.
73 EXTERN DynamicStrings_String
FormatStrings_Sprintf2 (DynamicStrings_String fmt
, const unsigned char *w1_
, unsigned int _w1_high
, const unsigned char *w2_
, unsigned int _w2_high
);
76 Sprintf3 - returns a string, fmt, which has been formatted.
79 EXTERN DynamicStrings_String
FormatStrings_Sprintf3 (DynamicStrings_String fmt
, const unsigned char *w1_
, unsigned int _w1_high
, const unsigned char *w2_
, unsigned int _w2_high
, const unsigned char *w3_
, unsigned int _w3_high
);
82 Sprintf4 - returns a string, fmt, which has been formatted.
85 EXTERN DynamicStrings_String
FormatStrings_Sprintf4 (DynamicStrings_String fmt
, const unsigned char *w1_
, unsigned int _w1_high
, const unsigned char *w2_
, unsigned int _w2_high
, const unsigned char *w3_
, unsigned int _w3_high
, const unsigned char *w4_
, unsigned int _w4_high
);
88 HandleEscape - translates \a, \b, \e, \f,
89 , \r, \x[hex] \[octal]
90 into their respective ascii codes. It also converts
91 \[any] into a single [any] character.
94 EXTERN DynamicStrings_String
FormatStrings_HandleEscape (DynamicStrings_String s
);