Lines Matching +full:read +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
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.
222 /** @brief Append read-write strings from source package to destination package.
226 * is set, list of read-write strings is examined and if they are not determined
227 * to be read-only, they are copied into the destination package.
229 * are considered as pointing to read-only location and they are copy to the
236 /** @brief Keep read-only location indexes in the package.
238 * If it is set read-only string pointers are kept in the package after copy. If
247 * Static packaging is done based only on types of arguments used for a format
359 * string is in the read only memory.
374 * -ENOSPC.
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
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
493 * @param cb callback called with portions of the converted package. If null only
503 * copying so that string length is calculated only once (at length calculation
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
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.
644 * @note Memory indicated by @p packaged will be modified in a non-destructive
655 /** @brief *printf-like output through a callback.
658 * character-by-character using the provided @p out function. This allows
684 /** @brief varargs-aware *printf-like output through a callback.
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.
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.
753 * character-by-character using the provided @p out function. This allows
759 * @note This function is available only when
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
855 * @note This function is available only when
874 * @note This function is available only when
893 * @note This function is available only when
910 * @note This function is available only when
936 * @note This function is available only when