###########################
cmake_test/set_print_length
###########################

.. module:: cmake_test/set_print_length


.. function:: ct_set_print_length(length)


   .. note:: This is a macro, and so does not introduce a new scope.

   Wrapper macro to set CT_PRINT_LENGTH variable in current scope.
   This length can be overriden by setting `PRINT_LENGTH`
   in `ct_add_test()` or `ct_add_section()`
   
   Priority for print length is as follows (first most important):
    1. Current execution unit's PRINT_LENGTH option
    2. Parent's PRINT_LENGTH option
    3. Length set by ct_set_print_length()
    4. Built-in default of 80.
   
   :param length: Length for pass/fail print lines.
   :type length: int