From 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Sun, 7 Apr 2024 13:41:34 -0500 Subject: new repository --- devdocs/c/io%2Fputchar.html | 57 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 devdocs/c/io%2Fputchar.html (limited to 'devdocs/c/io%2Fputchar.html') diff --git a/devdocs/c/io%2Fputchar.html b/devdocs/c/io%2Fputchar.html new file mode 100644 index 00000000..aa070ceb --- /dev/null +++ b/devdocs/c/io%2Fputchar.html @@ -0,0 +1,57 @@ +

putchar

Defined in header <stdio.h> 
int putchar( int ch );
+

Writes a character ch to stdout. Internally, the character is converted to unsigned char just before being written.

+

Equivalent to putc(ch, stdout).

+

Parameters

+ +
ch - character to be written

Return value

On success, returns the written character.

+

On failure, returns EOF and sets the error indicator (see ferror()) on stdout.

+

Example

+

Shows putchar with error checking

+
#include <stdio.h>
+#include <stdlib.h>
+ 
+int main(void)
+{
+    int ret_code = 0;
+    for (char c = 'a'; (ret_code != EOF) && (c != 'z'); c++)
+        ret_code = putchar(c);
+ 
+    // Test whether EOF was reached.
+    if (ret_code == EOF && ferror(stdout))
+    {
+        fprintf(stderr, "putchar() failed in file %s at line # %d\n",
+                __FILE__, __LINE__ - 6);
+        perror("putchar()");
+        exit(EXIT_FAILURE);
+    }
+    putchar('\n');
+ 
+    // putchar return value is not equal to the argument
+    int r = 0x1070;
+    printf("\n0x%x\n", r);
+    r = putchar(r);
+    printf("\n0x%x\n", r);
+}

Output:

+
abcdefghijklmnopqrstuvwxy
+ 
+0x1070
+p
+0x70

References

See also

+ +
writes a character to a file stream
(function)
C++ documentation for putchar
+

+ © cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
+ https://en.cppreference.com/w/c/io/putchar +

+
-- cgit v1.2.3