1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
|
// $Id: puts.c,v 1.1.1.1 2013/12/11 20:49:20 bcbrock Exp $
// $Source: /afs/awd/projects/eclipz/KnowledgeBase/.cvsroot/eclipz/chips/p8/working/procedures/lib/puts.c,v $
//-----------------------------------------------------------------------------
// *! (C) Copyright International Business Machines Corp. 2013
// *! All Rights Reserved -- Property of IBM
// *! *** IBM Confidential ***
//-----------------------------------------------------------------------------
/// \file puts.c
/// \brief Implementation of puts(), fputs(), putchar(), fputc()
///
/// The implementations of these APIs are split out to save code space for
/// applications that do not require them.
#include "ssx_io.h"
/// Put a character to a stream
///
/// The fputc() function writes the byte specified by \a c (converted to an
/// unsigned char) to the stream pointed to by \a stream. On success, fputc()
/// returns the value written, i.e., the \c unsigned \c char form of \a c.
///
/// The POSIX standard fputc() returns EOF on error; this version returns the
/// negative error code of the underlying I/O error, which will also be set in
/// the \a error field of the \a stream. Note that SSX may also be configured
/// to panic in the event of an I/O error.
int
fputc(int c, FILE *stream)
{
unsigned char uc = (unsigned char)c;
int rc = swrite(stream, (void *)(&uc), 1, 0);
if (rc < 0) {
return rc;
} else {
return uc;
}
}
/// Put a string to a stream
///
/// The fputs() function writes the null-terminated string \a s to the stream
/// pointed to by \a stream. The terminating null byte is not written. On
/// success, fputs() returns 0.
///
/// The POSIX standard fputc() returns EOF on error; this version returns the
/// negative error code of the underlying I/O error, which will also be set in
/// the \a error field of the \a stream. Note that SSX may also be configured
/// to panic in the event of an I/O error.
int
fputs(const char *s, FILE *stream)
{
return swrite(stream, s, strlen(s), 0);
}
/// Put a string to \c stdout
///
/// The puts() function writes the null-terminated string \a s followed by a
/// newline to \a stdout. The terminating null byte is not written. On
/// success, puts() returns 0.
///
/// The POSIX standard fputc() returns EOF on error; this version returns the
/// negative error code of the underlying I/O error, which will also be set in
/// the \a error field of the \a stream. Note that SSX may also be configured
/// to panic in the event of an I/O error.
int
puts(const char *s)
{
int rc = fputs(s, stdout);
if (rc < 0) {
return rc;
} else {
rc = fputc('\n', stdout);
if (rc < 0) {
return rc;
} else {
return 0;
}
}
}
/// Put a character to \a stdout.
///
/// \c putchar(c) is equivalent to <c> fputc(c, stdout) </c>.
int
putchar(int c)
{
return fputc(c, stdout);
}
|