logo

oasis-root

Compiled tree of Oasis Linux based on own branch at <https://hacktivis.me/git/oasis/> git clone https://anongit.hacktivis.me/git/oasis-root.git

wcslen.3p (2995B)


  1. '\" et
  2. .TH WCSLEN "3P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual"
  3. .\"
  4. .SH PROLOG
  5. This manual page is part of the POSIX Programmer's Manual.
  6. The Linux implementation of this interface may differ (consult
  7. the corresponding Linux manual page for details of Linux behavior),
  8. or the interface may not be implemented on Linux.
  9. .\"
  10. .SH NAME
  11. wcslen, wcsnlen
  12. \(em get length of a fixed-sized wide-character string
  13. .SH SYNOPSIS
  14. .LP
  15. .nf
  16. #include <wchar.h>
  17. .P
  18. size_t wcslen(const wchar_t *\fIws\fP);
  19. size_t wcsnlen(const wchar_t *\fIws\fP, size_t \fImaxlen\fP);
  20. .fi
  21. .SH DESCRIPTION
  22. For
  23. \fIwcslen\fR():
  24. The functionality described on this reference page is aligned with the
  25. ISO\ C standard. Any conflict between the requirements described here and the
  26. ISO\ C standard is unintentional. This volume of POSIX.1\(hy2017 defers to the ISO\ C standard.
  27. .P
  28. The
  29. \fIwcslen\fR()
  30. function shall compute the number of wide-character codes in the
  31. wide-character string to which
  32. .IR ws
  33. points, not including the terminating null wide-character code.
  34. .P
  35. The
  36. \fIwcsnlen\fR()
  37. function shall compute the smaller of the number of wide characters in
  38. the array to which
  39. .IR ws
  40. points, not including any terminating null wide-character code, and the
  41. value of
  42. .IR maxlen .
  43. The
  44. \fIwcsnlen\fR()
  45. function shall never examine more than the first
  46. .IR maxlen
  47. characters of the wide-character array pointed to by
  48. .IR ws .
  49. .SH "RETURN VALUE"
  50. The
  51. \fIwcslen\fR()
  52. function shall return the length of
  53. .IR ws .
  54. .P
  55. The
  56. \fIwcsnlen\fR()
  57. function shall return the number of wide characters preceding the
  58. first null wide-character code in the array to which
  59. .IR ws
  60. points, if
  61. .IR ws
  62. contains a null wide-character code within the first
  63. .IR maxlen
  64. wide characters; otherwise, it shall return
  65. .IR maxlen .
  66. .P
  67. No return values are reserved to indicate an error.
  68. .SH ERRORS
  69. No errors are defined.
  70. .LP
  71. .IR "The following sections are informative."
  72. .SH EXAMPLES
  73. None.
  74. .SH "APPLICATION USAGE"
  75. None.
  76. .SH RATIONALE
  77. None.
  78. .SH "FUTURE DIRECTIONS"
  79. None.
  80. .SH "SEE ALSO"
  81. .IR "\fIstrlen\fR\^(\|)"
  82. .P
  83. The Base Definitions volume of POSIX.1\(hy2017,
  84. .IR "\fB<wchar.h>\fP"
  85. .\"
  86. .SH COPYRIGHT
  87. Portions of this text are reprinted and reproduced in electronic form
  88. from IEEE Std 1003.1-2017, Standard for Information Technology
  89. -- Portable Operating System Interface (POSIX), The Open Group Base
  90. Specifications Issue 7, 2018 Edition,
  91. Copyright (C) 2018 by the Institute of
  92. Electrical and Electronics Engineers, Inc and The Open Group.
  93. In the event of any discrepancy between this version and the original IEEE and
  94. The Open Group Standard, the original IEEE and The Open Group Standard
  95. is the referee document. The original Standard can be obtained online at
  96. http://www.opengroup.org/unix/online.html .
  97. .PP
  98. Any typographical or formatting errors that appear
  99. in this page are most likely
  100. to have been introduced during the conversion of the source files to
  101. man page format. To report such errors, see
  102. https://www.kernel.org/doc/man-pages/reporting_bugs.html .