Általános üzenetek¶
message( "message text" ...)
Rögzíti a megadott üzenet szövegét a naplóban. Ha egynél több üzenetszöveg van megadva, akkor azokat egyetlen üzenetté fűzi össze, a karakterláncok közötti noseparátorral.
Az opcionális <mode> kulcsszó határozza meg az üzenet típusát, ami befolyásolja az üzenet kezelésének módját:
FATAL_ERROR
Make Error, stop processing and generation.
SEND_ERROR
CMake Error, folytassa a feldolgozást, de hagyja ki a generálást.
WARNING
CMake Warning, folytassa a feldolgozást.
AUTHOR_WARNING
CMake Warning (dev), folytassa a feldolgozást.
DEPRECATION
CMake Deprecation Error vagy Warning, ha a változóCMAKE_ERROR_DEPRECATED vagy CMAKE_WARN_DEPRECATED engedélyezve van, illetve ha a változóCMAKE_ERROR_DEPRECATED vagy CMAKE_WARN_DEPRECATED engedélyezve van, különben nincs üzenet.
(nincs) vagy NOTICE
Fontos üzenet az stderr-re nyomtatva, hogy felhívja a felhasználó figyelmét.
STATUS
A főbb érdekes üzenetek, amelyek a projekt felhasználóit érdekelhetik.ideális esetben ezek tömörek, legfeljebb egy sorosak, de mégis informatívak.
VERBOSE
A projekt felhasználóinak szánt részletes tájékoztató üzenetek. Ezeknek az üzeneteknek további részleteket kell tartalmazniuk, amelyek a legtöbb esetben nem lesznek érdekesek, de hasznosak lehetnek azok számára, akik a projektet építik, amikor mélyebb betekintést szeretnének kapni a történésekbe.
DEBUG
Detektív tájékoztató üzenetek, amelyek magának a projekten dolgozó fejlesztőknek szólnak, szemben azokkal a felhasználókkal, akik csak építeni szeretnék a projektet. Ezek az üzenetek jellemzően nem érdeklik a projektet építő többi felhasználót, és gyakran szorosan kapcsolódnak a belső megvalósítás részleteihez.
TRACE
Finomvonalú üzenetek nagyon alacsony szintű megvalósítási részletekkel. Az ezt a naplószintet használó üzenetek általában csak ideiglenesek, és várhatóan eltávolításra kerülnek a projekt kiadása, a fájlok csomagolása stb. előtt.
Új a 3.15-ös verzióban: Hozzáadva a NOTICE, VERBOSE, DEBUG és TRACE szintek.
A CMake parancssori eszköz STATUS és TRACE közötti üzeneteket jelenít meg az stdouton úgy, hogy az üzenet előtt két kötőjel és egy szóköz áll. Az összes többi üzenettípust az stderr-re küldi, és nincs előtte kötőjel. A CMake GUI minden üzenetet megjelenít a naplótartományában.A curses interface a STATUS és TRACE közötti üzeneteket egyenként jeleníti meg az állapotsoron, a többi üzenetet pedig egy interaktív felugró ablakban. Mindegyik eszköz --log-level parancssori opciójával szabályozható, hogy mely üzenetek jelenjenek meg.
Újdonság a 3.17-es verzióban: Ahhoz, hogy egy naplószint megmaradjon a CMake futtatásai között, a CMAKE_MESSAGE_LOG_LEVEL változót lehet helyette beállítani.Vegye figyelembe, hogy a parancssori opció elsőbbséget élvez a cache változóval szemben.
Újdonság a 3.16-os verzióban: A NOTICE és az alatti naplószintű üzenetek minden egyes sora előtt a CMAKE_MESSAGE_INDENT változó tartalma lesz (a listaelemek összekapcsolásával egyetlen karakterlánccá alakítva). A STATUS és TRACE közötti üzenetek esetében ez a behúzás a kötőjelek után kerül beillesztésre.
Újdonság a 3.17-es verzióban: A NOTICE és annál alacsonyabb szintű naplóüzenetek minden sora elé a formájú kontextus is kerülhet. A szögletes zárójelek közötti tartalmat a CMAKE_MESSAGE_CONTEXTlist változó pontokkal elválasztott karakterlánccá alakításával kapjuk. Az üzenetkörnyezet mindig a behúzott tartalom előtt, de az automatikusan hozzáadott bevezetőjelek után jelenik meg. Alapértelmezés szerint az üzenetkörnyezet nem jelenik meg, azt kifejezetten engedélyezni kell a cmake --log-contextparancssori opció megadásával vagy a CMAKE_MESSAGE_CONTEXT_SHOWváltozó true-ra állításával. A használati példákat lásd a CMAKE_MESSAGE_CONTEXT dokumentációban.
CMake Warning and Error message text displays using a simple markuplanguage. A nem zárójeles szöveg sorközi bekezdésekbe van formázva, újsorral elválasztva. A behúzott szöveg előre formázottnak tekinthető.