tree: 166ff2e0b793ebb4c50c12c4f899ff1101732355 [path history] [tgz]
  1. CMakeLists.txt
  2. Kconfig
  3. lib_asprintf.c
  4. lib_clearerr.c
  5. lib_dprintf.c
  6. lib_dtoa_data.c
  7. lib_dtoa_engine.c
  8. lib_dtoa_engine.h
  9. lib_fclose.c
  10. lib_feof.c
  11. lib_ferror.c
  12. lib_fflush.c
  13. lib_fgetc.c
  14. lib_fgetpos.c
  15. lib_fgets.c
  16. lib_fgetwc.c
  17. lib_fileno.c
  18. lib_fmemopen.c
  19. lib_fopen.c
  20. lib_fopencookie.c
  21. lib_fprintf.c
  22. lib_fputc.c
  23. lib_fputs.c
  24. lib_fputwc.c
  25. lib_fputws.c
  26. lib_fread.c
  27. lib_freopen.c
  28. lib_fscanf.c
  29. lib_fseek.c
  30. lib_fseeko.c
  31. lib_fsetpos.c
  32. lib_ftell.c
  33. lib_ftello.c
  34. lib_fwrite.c
  35. lib_getc.c
  36. lib_getchar.c
  37. lib_getdelim.c
  38. lib_gets.c
  39. lib_gets_s.c
  40. lib_getwc.c
  41. lib_libbsprintf.c
  42. lib_libdgets.c
  43. lib_libfflush.c
  44. lib_libfgets.c
  45. lib_libfilelock.c
  46. lib_libflushall.c
  47. lib_libfread_unlocked.c
  48. lib_libfwrite.c
  49. lib_libgetstreams.c
  50. lib_libsprintf.c
  51. lib_libvscanf.c
  52. lib_libvsprintf.c
  53. lib_open_memstream.c
  54. lib_perror.c
  55. lib_printf.c
  56. lib_putc.c
  57. lib_putchar.c
  58. lib_puts.c
  59. lib_putwc.c
  60. lib_putwchar.c
  61. lib_rdflush_unlocked.c
  62. lib_remove.c
  63. lib_renameat.c
  64. lib_rewind.c
  65. lib_scanf.c
  66. lib_setbuf.c
  67. lib_setbuffer.c
  68. lib_setvbuf.c
  69. lib_snprintf.c
  70. lib_sprintf.c
  71. lib_sscanf.c
  72. lib_tempnam.c
  73. lib_tmpfile.c
  74. lib_tmpnam.c
  75. lib_ultoa_invert.c
  76. lib_ultoa_invert.h
  77. lib_ungetc.c
  78. lib_ungetwc.c
  79. lib_vasprintf.c
  80. lib_vdprintf.c
  81. lib_vfprintf.c
  82. lib_vfscanf.c
  83. lib_vprintf.c
  84. lib_vscanf.c
  85. lib_vsnprintf.c
  86. lib_vsprintf.c
  87. lib_vsscanf.c
  88. lib_wrflush_unlocked.c
  89. Make.defs
  90. README.md
libs/libc/stdio/README.md

lib_bsprintf

This function is mainly used to output the contents of the input structure. Supports standard formats for printf and scanf. For detailed parameters, see:

  1. https://en.cppreference.com/w/c/io/fprintf
  2. https://en.cppreference.com/w/c/io/fscanf
  • special:
    1. Float use %hf, “%f” or “%lf” is double, “%Lf” is long double.
    2. The char array is specified with %.xs. for example: “char t[30]” is specified with “%.30s”, char a [20] - " %.20s "
    3. “%u” is unsigned int.
    4. “%d” is int.
    5. When using %f to format a double data type, the double is truncated to 6 decimal places by default.
    6. It is recommended that the “char[]” array be placed at the end of the structure to prevent parameter configuration errors such as “%.20s” from causing problems in parsing the entire buffer.
  • demo
    1. struct:
    begin_packed_struct
    struct test
    {
      uint8_t a;
      uint16_t b;
      uint32_t c;
      int8_t d;
      int16_t e;
      int32_t f;
      float g;
      double h;
      char i[32];
      uint64_t j;
      int64_t k;
      char l;
      unsigned char m;
      short int n;
      unsigned short int o;
      int p;
      unsigned int q;
      long r;
      unsigned long s;
      long long t;
      unsigned long long u;
      size_t v;
      long double w;
    }end_packed_struct;
    
    1. format string:
    const char* sg = "           uint8_t:[%hhu]\n" \
                     "          uint16_t:[%hu]\n" \
                     "          uint32_t:[%u]\n" \
                     "            int8_t:[%hhd]\n" \
                     "           int16_t:[%hd]\n" \
                     "           int32_t:[%d]\n" \
                     "             float:[%hf]\n" \
                     "            double:[%f]\n" \
                     "            char[]:[%.32s]\n" \
                     "          uint64_t:[%lu]\n" \
                     "           int64_t:[%ld]\n" \
                     "              char:[%hhd]\n" \
                     "     unsigned char:[%hhu]\n" \
                     "         short int:[%hd]\n" \
                     "unsigned short int:[%hu]\n" \
                     "               int:[%d]\n" \
                     "      unsigned int:[%u]\n" \
                     "              long:[%ld]\n" \
                     "     unsigned long:[%lu]\n" \
                     "         long long:[%lld]\n" \
                     "unsigned long long:[%llu]\n" \
                     "            size_t:[%uz]\n" \
                     "       long double:[%Lf]\n";
    
    1. use:
    • output to terminal:
    #ifdef CONFIG_FILE_STREAM
     struct lib_stdoutstream_s stdoutstream;
    
     lib_stdoutstream(&stdoutstream, stdout);
    
     flockfile(stdout);
     lib_bsprintf(&stdoutstream.common, sv, &test_v);
     lib_bsprintf(&stdoutstream.common, sg, &test_g);
     funlockfile(stdout);
    #else
     struct lib_rawoutstream_s rawoutstream;
     struct lib_bufferedoutstream_s outstream;
    
     lib_rawoutstream(&rawoutstream, STDOUT_FILENO);
     lib_bufferedoutstream(&outstream, &rawoutstream.common);
    
     lib_bsprintf(&outstream.common, sv, &test_v);
     lib_bsprintf(&outstream.common, sg, &test_g);
    
     lib_stream_flush(&outstream.common);
    #endif
    

lib_bscanf

This function adds a formatted standard scanf string to the structure(lib_bscanf).

  1. https://zh.cppreference.com/w/c/io/fscanf
  • special:

    1. Please use %lf for double precision, “%hf” or “%f” for float, long double (“%Lf”) is not supported.
    2. Please use %hhd or %hhu for a single char or unsigned char.
    3. Use %hd or %hu for short int or unsigned short int.
    4. When using %s or %c, please specify the length of the char array, such as %32s, %32c.
    5. %s will check the string for spaces. When there are spaces in the string, it will be truncated. If you want to use string with spaces, please use %{length}c, but make sure that the length of the string can fill the array, otherwise an error will occur.
    6. %[] collection and %n are not supported.
  • demo

    1. struct: Same as above
    2. format string:
    #define TOSTR(str)   #str
    #define TONNAME(name) TOSTR(name)
    
    #define v_uint8_t    97
    #define v_uint16_t   19299
    #define v_uint32_t   22155
    
    ......
    
    #define v_l_double   -9299.9299929912122464755474
    
    char bflag[] = "%hhu%hu%u%hhd%hd%d%f%lf%32s%llu%lld%hhd%hhu%hd%hu%d%u%ld%lu%lld%llu%zu%ld";
    
    char binput[] = TONNAME(v_uint8_t) \
                   " " TONNAME(v_uint16_t) \
                   " " TONNAME(v_uint32_t) \
                   " " TONNAME(v_int8_t) \
                   " " TONNAME(v_int16_t) \
                   " " TONNAME(v_int32_t) \
                   " " TONNAME(v_float) \
                   " " TONNAME(v_double) \
                   " " TONNAME(v_char_arr) \
                   " " TONNAME(v_uint64_t) \
                   " " TONNAME(v_int64_t) \
                   " " TONNAME(v_char) \
                   " " TONNAME(v_u_char) \
                   " " TONNAME(v_s_int) \
                   " " TONNAME(v_u_s_int) \
                   " " TONNAME(v_int) \
                   " " TONNAME(v_u_int) \
                   " " TONNAME(v_long) \
                   " " TONNAME(v_u_long) \
                   " " TONNAME(v_l_l) \
                   " " TONNAME(v_u_l_l) \
                   " " TONNAME(v_size_t) \
                   " " TONNAME(v_l_double);
    
    1. use:
    struct test vg;
    ret = lib_bscanf(binput, bflag, &vg);