ne_shave.3 1.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374
  1. '\" t
  2. .\" Title: ne_shave
  3. .\" Author:
  4. .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
  5. .\" Date: 21 January 2023
  6. .\" Manual: neon API reference
  7. .\" Source: neon 0.32.5
  8. .\" Language: English
  9. .\"
  10. .TH "NE_SHAVE" "3" "21 January 2023" "neon 0.32.5" "neon API reference"
  11. .\" -----------------------------------------------------------------
  12. .\" * Define some portability stuff
  13. .\" -----------------------------------------------------------------
  14. .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15. .\" http://bugs.debian.org/507673
  16. .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17. .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18. .ie \n(.g .ds Aq \(aq
  19. .el .ds Aq '
  20. .\" -----------------------------------------------------------------
  21. .\" * set default formatting
  22. .\" -----------------------------------------------------------------
  23. .\" disable hyphenation
  24. .nh
  25. .\" disable justification (adjust text to left margin only)
  26. .ad l
  27. .\" -----------------------------------------------------------------
  28. .\" * MAIN CONTENT STARTS HERE *
  29. .\" -----------------------------------------------------------------
  30. .SH "NAME"
  31. ne_shave \- trim whitespace from a string
  32. .SH "SYNOPSIS"
  33. .sp
  34. .ft B
  35. .nf
  36. #include <ne_string\&.h>
  37. .fi
  38. .ft
  39. .HP \w'char\ *ne_shave('u
  40. .BI "char *ne_shave(char\ *" "str" ", const\ char\ *" "whitespace" ");"
  41. .SH "DESCRIPTION"
  42. .PP
  43. \fBne_shave\fR
  44. returns a portion of
  45. \fIstr\fR
  46. with any leading or trailing characters in the
  47. \fIwhitespace\fR
  48. array removed\&.
  49. \fIstr\fR
  50. may be modified\&. Note that the return value may not be equal to
  51. \fIstr\fR\&.
  52. .SH "EXAMPLES"
  53. .PP
  54. The following code segment will output
  55. "fish":
  56. .sp
  57. .if n \{\
  58. .RS 4
  59. .\}
  60. .nf
  61. char s[] = "\&.!\&.fish!\&.!";
  62. puts(ne_shave(s, "\&.!"));
  63. .fi
  64. .if n \{\
  65. .RE
  66. .\}
  67. .SH "AUTHOR"
  68. .PP
  69. \fBJoe Orton\fR
  70. .RS 4
  71. Author.
  72. .RE
  73. .SH "COPYRIGHT"
  74. .br