MCPP(1)

💖 MCPP(1) — Matsui CPP, an alternative C preprocessor 💖

🦋 NAME 🦋

Okay bestie, meet mcpp — Matsui CPP, an alternative C preprocessor. 💅

---

💻 SYNOPSIS 💻

mcpp [options] [<infile> [<outfile>]]

---

🌸 DESCRIPTION 🌸

mcpp is a C/C++ preprocessor with the highest conformance, and it implements C90, C99 and C++98. It has plentiful diagnostics and many #pragmas. It is useful to check portability of your program, and it’s also useful to debug a complicated macro. This is a man-page for mcpp of compiler-independent-build. ✨

---

✨ OPTIONS ✨

mcpp expects two file names as arguments, <infile> and <outfile>. If they’re not specified, <infile> defaults to standard input and <outfile> defaults to standard output. 🫶

It takes the following options.

🌟 Commonly used options 🌟

• -@MODE — specify the preprocessing mode. MODE should be one of these 4:
  • -@std — Standard conforming mode. (default)
  • -@poststd, -@post — special 'post-Standard' mode.
  • -@kr — K&R 1st mode.
  • -@oldprep, -@old — "old_preprocessor" mode (i.e. "Reiser model" cpp).
  • -@compat — Standard 'compatible' mode.

yes bestie, it says 4 and then lists five — we are not editing the sacred text 💀

• -C — output also comments.
• -D <macro>[=<value>] — define <macro> as <value> (default:1).
• -D <macro(args)>[=<replace>] — define <macro(args)> as <replace>.
• -e <encoding> — change the default multi-byte character encoding to one of: euc_jp, gb2312, ksc5601, big5, sjis, iso2022_jp, utf8.
• -I <directory> — add <directory> to the #include search list.
• -I- — unset system or site specific include directories.
• -j — do not output the source line in diagnostics.
• -k — keep white spaces of input lines as they are.
• -M, -MM, -MD, -MMD, -MP, -MQ target, -MT target, -MF file — output source file dependency line for makefile.
• -m32 — change target CPU from x86_64, ppc64 to i386, ppc, respectively.
• -m64 — change target CPU from i386, ppc to x86_64, ppc64, respectively.
• -[no-]mmx — (un-)define __MMX__.
• -N — don't predefine any non-standard macros.
• -o <file> — output to <file>.
• -P — don't output #line lines.
• -Q — output diagnostics to "mcpp.err" (default:stderr).
• -U <macro> — undefine <macro>.
• -v — show version of mcpp.
• -W <level> — set warning level to <level> (OR of {0,1,2,4,8,16}, default:1).
• -z — don't output the included file, only defining macros.

🌈 Options available with -@std (default) or -@poststd options 🌈

• -+ — process C++ source.
• -2 — enable digraphs.
• -h <n> — re-define the pre-defined macro __STDC_HOSTED__ as <n>.
• -S <n> — redefine __STDC__ to <n>, undefine old style macros.
• -V <n> — redefine __STDC_VERSION__ or __cplusplus to <n>. C with -V199901L specifies C99 mode. C++ with -V199901L specifies C99 compatible mode.

🧚 Options available with only -@std (default) option 🧚

• -@compat — expand recursive macro more than Standard.
• -3 — enable trigraphs.
• -K — embed macro annotations into comments.

🍓 Options available with -@std (default), -@kr or -@oldprep options 🍓

• -a — process "assembler" source.

---

🪄 PRAGMA 🪄

mcpp has the following #pragma directives.

• #pragma once — read the header file only once even if multiply #included.
• #pragma __setlocale( "encoding") — specify the multibyte character encoding to "encoding". See -e option for the encodings.
• #pragma MCPP put_defines — putout all the macro definitions currently valid.
• #pragma MCPP debug <args> — start to putout debugging informations.
  • <args> should be one or more of: token expand macro_call path if expression memory getc
• #pragma MCPP end_debug <args> — stop to putout debugging informations.
  • <args> are the same with 'debug'.
  • No argument specifies all arguments.
• #pragma MCPP push_macro( "MACRO") — save the macro definition to the stack.
• #pragma MCPP pop_macro( "MACRO") — retrieve the macro definition from the stack.
• #pragma MCPP preprocess — "Pre-preprocess" the following header files for mcpp.
• #pragma MCPP warning any message — putout warning "any message".

---

🎀 VERSION 🎀

MCPP V.2.7 (2008/03) compiler-independent-build

---

🔎 SEE ALSO 🔎

Do man mcpp-gcc for mcpp of GCC-specific-build. The full documentation for mcpp are maintained as html files. Please see mcpp-manual.html. 💜

---

with love from alternative CPP · Mar 2008 · page MCPP(1) — version MCPP V.2.7 (2008/03) compiler-independent-build 💖✨