mirror of
https://github.com/brain-hackers/u-boot-brain
synced 2024-08-20 00:48:52 +09:00
![Simon Glass](/assets/img/avatar_default.png)
At present this function sits in its own file but it does not really justify it. There are similar string functions in vsprintf.h, so move it there. Also add the missing function comment. Use the vsprintf.h include file explicitly where needed. Signed-off-by: Simon Glass <sjg@chromium.org> Reviewed-by: Tom Rini <trini@konsulko.com>
226 lines
7.7 KiB
C
226 lines
7.7 KiB
C
/* SPDX-License-Identifier: GPL-2.0+ */
|
|
/*
|
|
* (C) Copyright 2000-2009
|
|
* Wolfgang Denk, DENX Software Engineering, wd@denx.de.
|
|
*/
|
|
|
|
#ifndef __VSPRINTF_H
|
|
#define __VSPRINTF_H
|
|
|
|
#include <stdarg.h>
|
|
#include <linux/types.h>
|
|
|
|
ulong simple_strtoul(const char *cp, char **endp, unsigned int base);
|
|
|
|
/**
|
|
* strict_strtoul - convert a string to an unsigned long strictly
|
|
* @param cp The string to be converted
|
|
* @param base The number base to use
|
|
* @param res The converted result value
|
|
* @return 0 if conversion is successful and *res is set to the converted
|
|
* value, otherwise it returns -EINVAL and *res is set to 0.
|
|
*
|
|
* strict_strtoul converts a string to an unsigned long only if the
|
|
* string is really an unsigned long string, any string containing
|
|
* any invalid char at the tail will be rejected and -EINVAL is returned,
|
|
* only a newline char at the tail is acceptible because people generally
|
|
* change a module parameter in the following way:
|
|
*
|
|
* echo 1024 > /sys/module/e1000/parameters/copybreak
|
|
*
|
|
* echo will append a newline to the tail.
|
|
*
|
|
* simple_strtoul just ignores the successive invalid characters and
|
|
* return the converted value of prefix part of the string.
|
|
*
|
|
* Copied this function from Linux 2.6.38 commit ID:
|
|
* 521cb40b0c44418a4fd36dc633f575813d59a43d
|
|
*
|
|
*/
|
|
int strict_strtoul(const char *cp, unsigned int base, unsigned long *res);
|
|
unsigned long long simple_strtoull(const char *cp, char **endp,
|
|
unsigned int base);
|
|
long simple_strtol(const char *cp, char **endp, unsigned int base);
|
|
|
|
/**
|
|
* trailing_strtol() - extract a trailing integer from a string
|
|
*
|
|
* Given a string this finds a trailing number on the string and returns it.
|
|
* For example, "abc123" would return 123.
|
|
*
|
|
* @str: String to exxamine
|
|
* @return training number if found, else -1
|
|
*/
|
|
long trailing_strtol(const char *str);
|
|
|
|
/**
|
|
* trailing_strtoln() - extract a trailing integer from a fixed-length string
|
|
*
|
|
* Given a fixed-length string this finds a trailing number on the string
|
|
* and returns it. For example, "abc123" would return 123. Only the
|
|
* characters between @str and @end - 1 are examined. If @end is NULL, it is
|
|
* set to str + strlen(str).
|
|
*
|
|
* @str: String to exxamine
|
|
* @end: Pointer to end of string to examine, or NULL to use the
|
|
* whole string
|
|
* @return training number if found, else -1
|
|
*/
|
|
long trailing_strtoln(const char *str, const char *end);
|
|
|
|
/**
|
|
* panic() - Print a message and reset/hang
|
|
*
|
|
* Prints a message on the console(s) and then resets. If CONFIG_PANIC_HANG is
|
|
* defined, then it will hang instead of resetting.
|
|
*
|
|
* @param fmt: printf() format string for message, which should not include
|
|
* \n, followed by arguments
|
|
*/
|
|
void panic(const char *fmt, ...)
|
|
__attribute__ ((format (__printf__, 1, 2), noreturn));
|
|
|
|
/**
|
|
* panic_str() - Print a message and reset/hang
|
|
*
|
|
* Prints a message on the console(s) and then resets. If CONFIG_PANIC_HANG is
|
|
* defined, then it will hang instead of resetting.
|
|
*
|
|
* This function can be used instead of panic() when your board does not
|
|
* already use printf(), * to keep code size small.
|
|
*
|
|
* @param fmt: string to display, which should not include \n
|
|
*/
|
|
void panic_str(const char *str) __attribute__ ((noreturn));
|
|
|
|
/**
|
|
* Format a string and place it in a buffer
|
|
*
|
|
* @param buf The buffer to place the result into
|
|
* @param fmt The format string to use
|
|
* @param ... Arguments for the format string
|
|
*
|
|
* The function returns the number of characters written
|
|
* into @buf.
|
|
*
|
|
* See the vsprintf() documentation for format string extensions over C99.
|
|
*/
|
|
int sprintf(char *buf, const char *fmt, ...)
|
|
__attribute__ ((format (__printf__, 2, 3)));
|
|
|
|
/**
|
|
* Format a string and place it in a buffer (va_list version)
|
|
*
|
|
* @param buf The buffer to place the result into
|
|
* @param fmt The format string to use
|
|
* @param args Arguments for the format string
|
|
* @return the number of characters which have been written into
|
|
* the @buf not including the trailing '\0'.
|
|
*
|
|
* If you're not already dealing with a va_list consider using scnprintf().
|
|
*
|
|
* See the vsprintf() documentation for format string extensions over C99.
|
|
*/
|
|
int vsprintf(char *buf, const char *fmt, va_list args);
|
|
char *simple_itoa(ulong i);
|
|
|
|
/**
|
|
* Format a string and place it in a buffer
|
|
*
|
|
* @param buf The buffer to place the result into
|
|
* @param size The size of the buffer, including the trailing null space
|
|
* @param fmt The format string to use
|
|
* @param ... Arguments for the format string
|
|
* @return the number of characters which would be
|
|
* generated for the given input, excluding the trailing null,
|
|
* as per ISO C99. If the return is greater than or equal to
|
|
* @size, the resulting string is truncated.
|
|
*
|
|
* See the vsprintf() documentation for format string extensions over C99.
|
|
*/
|
|
int snprintf(char *buf, size_t size, const char *fmt, ...)
|
|
__attribute__ ((format (__printf__, 3, 4)));
|
|
|
|
/**
|
|
* Format a string and place it in a buffer
|
|
*
|
|
* @param buf The buffer to place the result into
|
|
* @param size The size of the buffer, including the trailing null space
|
|
* @param fmt The format string to use
|
|
* @param ... Arguments for the format string
|
|
*
|
|
* The return value is the number of characters written into @buf not including
|
|
* the trailing '\0'. If @size is == 0 the function returns 0.
|
|
*
|
|
* See the vsprintf() documentation for format string extensions over C99.
|
|
*/
|
|
int scnprintf(char *buf, size_t size, const char *fmt, ...)
|
|
__attribute__ ((format (__printf__, 3, 4)));
|
|
|
|
/**
|
|
* Format a string and place it in a buffer (base function)
|
|
*
|
|
* @param buf The buffer to place the result into
|
|
* @param size The size of the buffer, including the trailing null space
|
|
* @param fmt The format string to use
|
|
* @param args Arguments for the format string
|
|
* @return The number characters which would be generated for the given
|
|
* input, excluding the trailing '\0', as per ISO C99. Note that fewer
|
|
* characters may be written if this number of characters is >= size.
|
|
*
|
|
* This function follows C99 vsnprintf, but has some extensions:
|
|
* %pS output the name of a text symbol
|
|
* %pF output the name of a function pointer
|
|
* %pR output the address range in a struct resource
|
|
*
|
|
* The function returns the number of characters which would be
|
|
* generated for the given input, excluding the trailing '\0',
|
|
* as per ISO C99.
|
|
*
|
|
* Call this function if you are already dealing with a va_list.
|
|
* You probably want snprintf() instead.
|
|
*/
|
|
int vsnprintf(char *buf, size_t size, const char *fmt, va_list args);
|
|
|
|
/**
|
|
* Format a string and place it in a buffer (va_list version)
|
|
*
|
|
* @param buf The buffer to place the result into
|
|
* @param size The size of the buffer, including the trailing null space
|
|
* @param fmt The format string to use
|
|
* @param args Arguments for the format string
|
|
* @return the number of characters which have been written into
|
|
* the @buf not including the trailing '\0'. If @size is == 0 the function
|
|
* returns 0.
|
|
*
|
|
* If you're not already dealing with a va_list consider using scnprintf().
|
|
*
|
|
* See the vsprintf() documentation for format string extensions over C99.
|
|
*/
|
|
int vscnprintf(char *buf, size_t size, const char *fmt, va_list args);
|
|
|
|
/**
|
|
* print_grouped_ull() - print a value with digits grouped by ','
|
|
*
|
|
* This prints a value with grouped digits, like 12,345,678 to make it easier
|
|
* to read.
|
|
*
|
|
* @val: Value to print
|
|
* @digits: Number of digiits to print
|
|
*/
|
|
void print_grouped_ull(unsigned long long int_val, int digits);
|
|
|
|
bool str2off(const char *p, loff_t *num);
|
|
bool str2long(const char *p, ulong *num);
|
|
|
|
/**
|
|
* strmhz() - Convert a value to a Hz string
|
|
*
|
|
* This creates a string indicating the number of MHz of a value. For example,
|
|
* 2700000 produces "2.7".
|
|
* @buf: Buffer to hold output string, which must be large enough
|
|
* @hz: Value to convert
|
|
*/
|
|
char *strmhz(char *buf, unsigned long hz);
|
|
#endif
|