Lines Matching +full:output +full:- +full:only
4 * SPDX-License-Identifier: Apache-2.0
52 /** Number of read-only strings, indexes appended to the package */
55 /** Number of read-write strings, indexes appended to the package */
64 * On Xtensa, the first argument needs to be aligned to 8-byte.
65 * With 32-bit pointers, we need another 4 bytes padding so
131 * @defgroup cbprintf_apis Formatted Output APIs
152 /** @brief Assume that const char pointer is pointing to read only (constant) strings.
154 * Flag is valid only for @ref CBPRINTF_STATIC_PACKAGE.
158 /** @brief Append locations (within the package) of read-only string pointers. */
161 /** @brief Append locations (within the package) of read-write string pointers.
163 * When this flag is not used then read-write strings are appended to the package.
172 * read-only location.
176 * @param n Number of string arguments considered as read-only.
181 /** @brief Get number of first format string arguments which are known to be read-only
187 /** @brief Append indexes of read-only string arguments in the package.
189 * When used, package contains locations of read-only string arguments. Package
190 * with that information can be converted to fully self-contain package using
210 /** @brief Append read-only strings from source package to destination package.
214 * string address can be found in the package. When flag is set, read-only strings
215 * are copied into destination package. Address of strings indicated as read-write
216 * are also checked and if determined to be read-only they are also copied.
220 /** @brief Append read-write strings from source package to destination package.
224 * is set, list of read-write strings is examined and if they are not determined
225 * to be read-only, they are copied into the destination package.
227 * are considered as pointing to read-only location and they are copy to the
232 /** @brief Keep read-only location indexes in the package.
234 * If it is set read-only string pointers are kept in the package after copy. If
241 * Static packaging is done based only on types of arguments used for a format
280 * * @p c a character to output. The output behavior should be as if
283 * output operation.
299 /* Create local cbprintf_cb type to make calng-based compilers happy when handles
300 * OUTC() macro (see below). With strict rules (Wincompatible-function-pointer-types-strict)
359 * string is in the read only memory.
374 * -ENOSPC.
390 /** @brief Capture state required to output formatted data later.
394 * done in a different context, e.g. when the output function can block.
398 * not confirmed to be stored in read-only memory (hence assumed to be safe to
425 * @retval -EINVAL if @p format is not acceptable
426 * @retval -EFAULT if @p packaged alignment is not acceptable
427 * @retval -ENOSPC if @p packaged was not null and the space required to store
437 /** @brief Capture state required to output formatted data later.
441 * done in a different context, e.g. when the output function can block.
445 * not confirmed to be stored in read-only memory (hence assumed to be safe to
467 * @retval -EINVAL if @p format is not acceptable
468 * @retval -ENOSPC if @p packaged was not null and the space required to store
485 * @p cb is called with portions of the output package. At the end of the conversion
493 * @param cb callback called with portions of the converted package. If null only
494 * length of the output package is calculated.
503 * copying so that string length is calculated only once (at length calculation
508 * @retval Positive output package size.
509 * @retval -ENOSPC if @p packaged was not null and the space required to store
532 if ((desc->size - desc->off) < len) { in z_cbprintf_cpy()
533 return -ENOSPC; in z_cbprintf_cpy()
536 memcpy(&((uint8_t *)desc->buf)[desc->off], buf, len); in z_cbprintf_cpy()
537 desc->off += len; in z_cbprintf_cpy()
552 * @param[out] packaged Output package. If null only length of the output package
563 * copying so that string length is calculated only once (at length calculation
568 * @retval Positive Output package size.
569 * @retval -ENOSPC if @p packaged was not null and the space required to store
591 /** @brief Convert package to fully self-contained (fsc) package.
594 * Package may be partially self-contained when transient (not read only) strings
595 * are appended to the package. Such package can be decoded only when there is an
596 * access to read-only strings.
598 * Fully self-contained has (fsc) contains all strings used in the package. A package
600 * flag. Such package will contain necessary data to find read only strings in
608 * @param packaged pointer to location where fully self-contained version of the
616 * @retval -ENOSPC if @p packaged was not null and the space required to store
618 * @retval -EINVAL if @p in_packaged is null.
630 /** @brief Generate the output for a previously captured format
640 * @param packaged the data required to generate the formatted output, as
644 * @note Memory indicated by @p packaged will be modified in a non-destructive
655 /** @brief *printf-like output through a callback.
657 * This is essentially printf() except the output is generated
658 * character-by-character using the provided @p out function. This allows
684 /** @brief varargs-aware *printf-like output through a callback.
686 * This is essentially vsprintf() except the output is generated
687 * character-by-character using the provided @p out function. This allows
691 * @note This function is available only when
715 /** @brief varargs-aware *printf-like output through a callback.
717 * This is essentially vsprintf() except the output is generated
718 * character-by-character using the provided @p out function. This allows
722 * @note This function is available only when
750 /** @brief varargs-aware *printf-like output through a callback with tagged arguments.
752 * This is essentially vsprintf() except the output is generated
753 * character-by-character using the provided @p out function. This allows
759 * @note This function is available only when
785 /** @brief Generate the output for a previously captured format
792 * @param packaged the data required to generate the formatted output, as
796 * @note Memory indicated by @p packaged will be modified in a non-destructive
809 if ((hdr->desc.pkg_flags & CBPRINTF_PACKAGE_ARGS_ARE_TAGGED) in cbpprintf()
834 * @note This function is available only when
840 * @param stream the stream to which the output should be written.
855 * @note This function is available only when
861 * @param stream the stream to which the output should be written.
874 * @note This function is available only when
893 * @note This function is available only when
910 * @note This function is available only when
918 * @param size maximum number of chaacters for the formatted output,
936 * @note This function is available only when
944 * @param size maximum number of chaacters for the formatted output, including