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

_toupper.3p (2187B)

    

  1. '\" et
  2. .TH _TOUPPER "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. _toupper
  12. \(em transliterate lowercase characters to uppercase
  13. .SH SYNOPSIS
  14. .LP
  15. .nf
  16. #include <ctype.h>
  17. .P
  18. int _toupper(int \fIc\fP);
  19. .fi
  20. .SH DESCRIPTION
  21. The
  22. \fI_toupper\fR()
  23. macro shall be equivalent to
  24. \fItoupper\fR()
  25. except that the application shall ensure that the argument
  26. .IR c
  27. is a lowercase letter.
  28. .SH "RETURN VALUE"
  29. Upon successful completion,
  30. \fI_toupper\fR()
  31. shall return the uppercase letter corresponding to the argument passed.
  32. .SH ERRORS
  33. No errors are defined.
  34. .LP
  35. .IR "The following sections are informative."
  36. .SH EXAMPLES
  37. None.
  38. .SH "APPLICATION USAGE"
  39. Applications should use the
  40. \fItoupper\fR()
  41. function instead of the obsolescent
  42. \fI_toupper\fR()
  43. function.
  44. .SH RATIONALE
  45. None.
  46. .SH "FUTURE DIRECTIONS"
  47. The
  48. \fI_toupper\fR()
  49. function may be removed in a future version.
  50. .SH "SEE ALSO"
  51. .IR "\fIislower\fR\^(\|)",
  52. .IR "\fItoupper\fR\^(\|)"
  53. .P
  54. The Base Definitions volume of POSIX.1\(hy2017,
  55. .IR "Chapter 7" ", " "Locale",
  56. .IR "\fB<ctype.h>\fP"
  57. .\"
  58. .SH COPYRIGHT
  59. Portions of this text are reprinted and reproduced in electronic form
  60. from IEEE Std 1003.1-2017, Standard for Information Technology
  61. -- Portable Operating System Interface (POSIX), The Open Group Base
  62. Specifications Issue 7, 2018 Edition,
  63. Copyright (C) 2018 by the Institute of
  64. Electrical and Electronics Engineers, Inc and The Open Group.
  65. In the event of any discrepancy between this version and the original IEEE and
  66. The Open Group Standard, the original IEEE and The Open Group Standard
  67. is the referee document. The original Standard can be obtained online at
  68. http://www.opengroup.org/unix/online.html .
  69. .PP
  70. Any typographical or formatting errors that appear
  71. in this page are most likely
  72. to have been introduced during the conversion of the source files to
  73. man page format. To report such errors, see
  74. https://www.kernel.org/doc/man-pages/reporting_bugs.html .