From fa1ad00f0059f3a33252a6921079eb40319f16e2 Mon Sep 17 00:00:00 2001
From: Bradley Holt <bradley@php.net>
Date: Fri, 26 Aug 2011 16:53:23 +0000
Subject: [PATCH] Add examples to AMQPQueue::get and AMQPQueue::ack
 documentation.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@315574 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/amqp/amqpqueue/ack.xml | 69 ++++++++++++++++++++++++++++++++
 reference/amqp/amqpqueue/get.xml | 31 ++++++++++++++
 2 files changed, 100 insertions(+)

diff --git a/reference/amqp/amqpqueue/ack.xml b/reference/amqp/amqpqueue/ack.xml
index d787f6073f..b23560c6d8 100644
--- a/reference/amqp/amqpqueue/ack.xml
+++ b/reference/amqp/amqpqueue/ack.xml
@@ -50,6 +50,75 @@
    &return.success;
   </para>
  </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><methodname>AMQPQueue::ack</methodname> example with <methodname>AMQPQueue::get</methodname></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+/* Create a connection using all default credentials: */
+$connection = new AMQPConnection();
+$connection->connect();
+
+/* create a queue object */
+$queue = new AMQPQueue($connection);
+
+//declare the queue
+$queue->declare('myqueue');
+
+//get the next message, but don't mark it as delivered
+$message = $queue->get(AMQP_NOACK);
+
+echo $message['msg'];
+
+//acknowledge the message as received
+$queue->ack($message['delivery_tag']);
+
+?>
+]]>
+    </programlisting>
+   </example>
+   <example>
+    <title><methodname>AMQPQueue::ack</methodname> example with <methodname>AMQPQueue::consume</methodname></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+/* Create a connection using all default credentials: */
+$connection = new AMQPConnection();
+$connection->connect();
+
+/* create a queue object */
+$queue = new AMQPQueue($connection);
+
+//declare the queue
+$queue->declare('myqueue');
+
+$options = array(
+    'min' => 1,
+    'max' => 10,
+    'ack' => false
+);
+
+//get the messages, but don't mark them as delivered
+$messages = $queue->consume($options);
+
+foreach ($messages as $message) {
+    echo $message['message_body'];
+    //acknowledge the message as received
+    $queue->ack($message['delivery_tag']);
+}
+
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
 </refentry>
 
 <!-- Keep this comment at the end of the file
diff --git a/reference/amqp/amqpqueue/get.xml b/reference/amqp/amqpqueue/get.xml
index b1110e019d..1ddc2f28c5 100644
--- a/reference/amqp/amqpqueue/get.xml
+++ b/reference/amqp/amqpqueue/get.xml
@@ -48,6 +48,37 @@
   </para>
  </refsect1>
 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><methodname>AMQPQueue::get</methodname> example</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+/* Create a connection using all default credentials: */
+$connection = new AMQPConnection();
+$connection->connect();
+
+/* create a queue object */
+$queue = new AMQPQueue($connection);
+
+//declare the queue
+$queue->declare('myqueue');
+
+//get the next message
+$message = $queue->get();
+
+echo $message['msg'];
+
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+
 </refentry>
 
 <!-- Keep this comment at the end of the file