Changes between Version 3 and Version 4 of LibYAML

Timestamp:

05/16/06 14:32:30 (7 years ago)

Author:

xi

Comment:

--

LibYAML

@@ -2 +2 @@
 
 LibYAML is a YAML 1.1 parser and emitter written in C. It's in an early stage of development.
+
+You may leave your remarks here at the end of the page or post your comments to
+[http://lists.sourceforge.net/lists/listinfo/yaml-core the YAML-core mailing list].
 
 [[PageOutline]]
@@ -147 +150 @@
 do {
     /* Get the next event. */
-    event = yaml_parser_get_event(parser);
+    event = yaml_parser_parse(parser);
 
     if (!event) goto error;
@@ -184 +187 @@
 
 /* Get the error data. */
-yaml_parser_get_error(&error, &context, &context_mark, &problem, &problem_mark);
+yaml_parser_get_error(parser, &error, &context, &context_mark, &problem, &problem_mark);
 
 /*
@@ -195 +198 @@
 yaml_parser_delete(parser);
 }}}
+
+=== Emitter API Synopsis ===
+
+{{{
+#!c
+#include <yaml.h>
+
+yaml_emitter_t *emitter;
+yaml_event_t *event;
+
+/* Create the Emitter object. */
+emitter = yaml_emitter_new();
+
+/* Set a file output. */
+FILE *output = fopen("...", "wb");
+
+yaml_emitter_set_file_output(emitter, output);
+
+/* Set a generic writer. */
+void *ext = ...;
+int write_handler(void *ext, char *buffer, int size) {
+    /*
+       ...
+       Write `size` bytes.
+       ...
+    */
+    return error ? 0 : 1;
+}
+
+yaml_emitter_set_output(emitter, write_handler, ext);
+
+/* Create the STREAM-START event. */
+event = yaml_event_new_stream_start(YAML_UTF8_ENCODING);
+
+/* Emit the event. The application is no longer responsible for the event object. */
+int result = yaml_emitter_emit(emitter, event);
+
+if (!result) goto error;
+
+/*
+  ...
+  Emit more events.
+  ...
+*/
+
+/* Create and emit the STREAM-END event. */
+if (!yaml_emitter_emit(emitter, yaml_event_new_event_end())) goto error;
+
+/* Destroy the Emitter object. */
+yaml_emitter_delete(emitter);
+
+/* On error. */
+error:
+
+/* Error type: YAML_WRITER_ERROR, YAML_EMITTER_ERROR. */
+yaml_error_t error;
+
+/* The problem description. */
+char *problem;
+
+/* Get the error data. */
+yaml_emitter_get_error(emitter, &error, &problem);
+
+/*
+  ...
+  Report the problem to the user.
+  ...
+*/
+
+/* Destroy the Emitter object. */
+yaml_emitter_delete(emitter);
+}}}
+
+== Feedback ==
+
+''Leave your comments here.''