oysteikt/mpd
0
0
Fork 0
Code Issues Pull Requests Releases Activity

input_stream: add "nonnull" attributes

Browse Source
This commit is contained in:
Max Kellermann 2011-09-15 22:40:44 +02:00
parent f804a739b1
commit e1efc71ad3
1 changed files with 12 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
src/input_stream.h
View File

@ -21,6 +21,7 @@
#define MPD_INPUT_STREAM_H #define MPD_INPUT_STREAM_H
#include "check.h" #include "check.h"
#include "gcc.h"
#include <glib.h> #include <glib.h>
@ -77,12 +78,15 @@ struct input_stream {
* *
* @return an #input_stream object on success, NULL on error * @return an #input_stream object on success, NULL on error
*/ */
gcc_nonnull(1)
G_GNUC_MALLOC
struct input_stream * struct input_stream *
input_stream_open(const char *uri, GError **error_r); input_stream_open(const char *uri, GError **error_r);
/** /**
* Close the input stream and free resources. * Close the input stream and free resources.
*/ */
gcc_nonnull(1)
void void
input_stream_close(struct input_stream *is); input_stream_close(struct input_stream *is);
@ -90,6 +94,7 @@ input_stream_close(struct input_stream *is);
* Update the public attributes. Call before accessing attributes * Update the public attributes. Call before accessing attributes
* such as "ready" or "offset". * such as "ready" or "offset".
*/ */
gcc_nonnull(1)
void void
input_stream_update(struct input_stream *is); input_stream_update(struct input_stream *is);
@ -101,6 +106,7 @@ input_stream_update(struct input_stream *is);
* @param offset the relative offset * @param offset the relative offset
* @param whence the base of the seek, one of SEEK_SET, SEEK_CUR, SEEK_END * @param whence the base of the seek, one of SEEK_SET, SEEK_CUR, SEEK_END
*/ */
gcc_nonnull(1)
bool bool
input_stream_seek(struct input_stream *is, goffset offset, int whence, input_stream_seek(struct input_stream *is, goffset offset, int whence,
GError **error_r); GError **error_r);
@ -108,6 +114,8 @@ input_stream_seek(struct input_stream *is, goffset offset, int whence,
/** /**
* Returns true if the stream has reached end-of-file. * Returns true if the stream has reached end-of-file.
*/ */
gcc_nonnull(1)
G_GNUC_PURE
bool input_stream_eof(struct input_stream *is); bool input_stream_eof(struct input_stream *is);
/** /**
@ -116,6 +124,8 @@ bool input_stream_eof(struct input_stream *is);
* @return a tag object which must be freed with tag_free(), or NULL * @return a tag object which must be freed with tag_free(), or NULL
* if the tag has not changed since the last call * if the tag has not changed since the last call
*/ */
gcc_nonnull(1)
G_GNUC_MALLOC
struct tag * struct tag *
input_stream_tag(struct input_stream *is); input_stream_tag(struct input_stream *is);
@ -127,6 +137,7 @@ input_stream_tag(struct input_stream *is);
* The semantics of this function are not well-defined, and it will * The semantics of this function are not well-defined, and it will
* eventually be removed. * eventually be removed.
*/ */
gcc_nonnull(1)
int input_stream_buffer(struct input_stream *is, GError **error_r); int input_stream_buffer(struct input_stream *is, GError **error_r);
/** /**
@ -138,6 +149,7 @@ int input_stream_buffer(struct input_stream *is, GError **error_r);
* @param size the maximum number of bytes to read * @param size the maximum number of bytes to read
* @return the number of bytes read * @return the number of bytes read
*/ */
gcc_nonnull(1, 2)
size_t size_t
input_stream_read(struct input_stream *is, void *ptr, size_t size, input_stream_read(struct input_stream *is, void *ptr, size_t size,
GError **error_r); GError **error_r);