libcouchbase 1.3.0 → 1.3.2

data/ext/libcouchbase/example/fts/fts.c

@@ -0,0 +1,142 @@
+/* -*- Mode: C; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*- */
+/*
+ *     Copyright 2018 Couchbase, Inc.
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+
+/**
+
+   CFLAGS="-I$(realpath ../../include) -I$(realpath ../../build/generated)"
+   LDFLAGS="-L$(realpath ../../build/lib) -lcouchbase -Wl,-rpath=$(realpath ../../build/lib)"
+   make fts
+
+   The example assumes the existence of "travel-sample" bucket and three
+   specific Full Text Indexes, defined for it. These are:
+
+   - "travel-sample-index-unstored": Uses only the default settings.
+
+   - "travel-sample-index-stored": Uses default settings, with one exception:
+     dynamic fields are stored, for the whole index.
+
+   - "travel-sample-index-hotel-description": Indexes only the description
+     fields of hotel documents, and disables the default type mapping. The index
+     has a custom analyzer named myUnicodeAnalyzer defined on it: the analyzer's
+     main characteristic is that it uses the unicode tokenizer.
+ */
+
+#include <unistd.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+
+#include <libcouchbase/couchbase.h>
+#include <libcouchbase/cbft.h>
+
+#include "queries.h"
+
+static void fail(const char *msg)
+{
+    printf("[\x1b[31mERROR\x1b[0m] %s\n", msg);
+    exit(EXIT_FAILURE);
+}
+
+static void check(lcb_error_t err, const char *msg)
+{
+    if (err != LCB_SUCCESS) {
+        char buf[1024] = {0};
+        snprintf(buf, sizeof(buf), "%s: %s\n", msg, lcb_strerror_short(err));
+        fail(buf);
+    }
+}
+
+static int err2color(lcb_error_t err)
+{
+    switch (err) {
+        case LCB_SUCCESS:
+            return 49;
+        default:
+            return 31;
+    }
+}
+
+static void ln2space(const void *buf, size_t nbuf)
+{
+    size_t ii;
+    char *str = (char *)buf;
+    for (ii = 0; ii < nbuf; ii++) {
+        if (str[ii] == '\n') {
+            str[ii] = ' ';
+        }
+    }
+}
+
+static void row_callback(lcb_t instance, int type, const lcb_RESPFTS *resp)
+{
+    ln2space(resp->row, resp->nrow);
+    if (resp->rc != LCB_SUCCESS) {
+        printf("\x1b[31m%s\x1b[0m: ", lcb_strerror_short(resp->rc));
+    }
+    printf("%.*s\n", (int)resp->nrow, (char *)resp->row);
+    if (resp->rflags & LCB_RESP_F_FINAL) {
+        printf("\n");
+    }
+}
+
+int main(int argc, char *argv[])
+{
+    lcb_error_t err;
+    lcb_t instance;
+    char *bucket = NULL;
+    size_t ii;
+
+    if (argc < 2) {
+        printf("Usage: %s couchbase://host/bucket [ password [ username ] ]\n", argv[0]);
+        exit(EXIT_FAILURE);
+    }
+
+    {
+        struct lcb_create_st create_options = {0};
+        create_options.version = 3;
+        create_options.v.v3.connstr = argv[1];
+        if (argc > 2) {
+            create_options.v.v3.passwd = argv[2];
+        }
+        if (argc > 3) {
+            create_options.v.v3.username = argv[3];
+        }
+        check(lcb_create(&instance, &create_options), "create couchbase handle");
+        check(lcb_connect(instance), "schedule connection");
+        lcb_wait(instance);
+        check(lcb_get_bootstrap_status(instance), "bootstrap from cluster");
+        check(lcb_cntl(instance, LCB_CNTL_GET, LCB_CNTL_BUCKETNAME, &bucket), "get bucket name");
+        if (strcmp(bucket, "travel-sample") != 0) {
+            fail("expected bucket to be \"travel-sample\"");
+        }
+    }
+
+    for (ii = 0; ii < num_queries; ii++) {
+        lcb_CMDFTS cmd = {0};
+        cmd.callback = row_callback;
+        cmd.query = queries[ii].query;
+        cmd.nquery = queries[ii].query_len;
+        check(lcb_fts_query(instance, NULL, &cmd), "schedule FTS index creation operation");
+        printf("----> \x1b[1m%s\x1b[0m\n", queries[ii].comment);
+        printf("----> \x1b[32m%.*s\x1b[0m\n", (int)queries[ii].query_len, queries[ii].query);
+        lcb_wait(instance);
+    }
+
+    /* Now that we're all done, close down the connection handle */
+    lcb_destroy(instance);
+    return 0;
+}

data/ext/libcouchbase/example/fts/queries.h

@@ -0,0 +1,61 @@
+// This file was generated by queries.rb
+typedef struct fts_query_str { const char *comment; size_t query_len; const char *query; } fts_query_str;
+size_t num_queries = 14;
+fts_query_str queries[15] = {
+{"Simple Text Query on a single word, targeting an index with dynamic fields not stored.",
+ 110,
+ "{\"indexName\":\"travel-sample-index-unstored\",\"size\":10,\"highlight\":{\"style\":\"html\"},\"query\":{\"match\":\"swanky\"}}"},
+
+{"Simple Text Query on Non-Default Index, specifying an index that consists only of content derived from a specific field from a specific document-type.",
+ 90,
+ "{\"indexName\":\"travel-sample-index-hotel-description\",\"size\":10,\"query\":{\"match\":\"swanky\"}}"},
+
+{"Simple Text Query on Stored Field, specifying the field to be searched; targeting an index with dynamic fields stored, to ensure that field-content is included in the return object.",
+ 134,
+ "{\"indexName\":\"travel-sample-index-stored\",\"size\":10,\"highlight\":{\"style\":\"html\"},\"query\":{\"field\":\"destinationairport\",\"match\":\"MDG\"}}"},
+
+{"Match Query with Facet, showing how query-results can be displayed either by row or by hits; and demonstrating use of a facet, which provides aggregation-data.",
+ 211,
+ "{\"indexName\":\"travel-sample-index-stored\",\"highlight\":{\"style\":\"html\"},\"size\":10,\"query\":{\"field\":\"reviews.content\",\"match\":\"La Rue Saint Denis!!\"},\"facets\":{\"Countries Referenced\":{\"size\":5,\"field\":\"country\"}}}"},
+
+{"DocId Query, showing results of a query on two document IDs.",
+ 90,
+ "{\"indexName\":\"travel-sample-index-unstored\",\"query\":{\"ids\":[\"hotel_26223\",\"hotel_28960\"]}}"},
+
+{"Unanalyzed Term Query with Fuzziness Level of 0, demonstrating how to query on a term with no analysis. Zero fuzziness is specified, to ensure that matches are exact.",
+ 132,
+ "{\"indexName\":\"travel-sample-index-stored\",\"size\":50,\"highlight\":{\"style\":\"html\"},\"query\":{\"field\":\"reviews.content\",\"term\":\"sushi\"}}"},
+
+{"Unanalyzed Term Query with Fuzziness Level of 2, which is almost identical to the immediately preceding query; but which this time specifies a fuzziness factor of 2, allowing partial matches to be made. The output from this query can be compared to that of the one immediately preceding.",
+ 146,
+ "{\"indexName\":\"travel-sample-index-stored\",\"size\":50,\"highlight\":{\"style\":\"html\"},\"query\":{\"field\":\"reviews.content\",\"fuzziness\":2,\"term\":\"sushi\"}}"},
+
+{"Match Phrase Query, using Analysis, for searching on a phrase.",
+ 143,
+ "{\"indexName\":\"travel-sample-index-stored\",\"size\":10,\"highlight\":{\"style\":\"html\"},\"query\":{\"field\":\"description\",\"match_phrase\":\"Eiffel Tower\"}}"},
+
+{"Phrase Query, without Analysis, for searching on a phrase without analysis supported.",
+ 138,
+ "{\"indexName\":\"travel-sample-index-stored\",\"size\":10,\"highlight\":{\"style\":\"html\"},\"query\":{\"field\":\"description\",\"terms\":[\"dorm\",\"rooms\"]}}"},
+
+{"Query String Query, showing how a query string is specified as search-input.",
+ 96,
+ "{\"indexName\":\"travel-sample-index-unstored\",\"size\":10,\"query\":{\"query\":\"description: Imperial\"}}"},
+
+{"Conjunction Query, whereby two separate queries are defined and then run as part of the search, with only the matches returned by both included in the result-object.",
+ 207,
+ "{\"indexName\":\"travel-sample-index-stored\",\"size\":10,\"highlight\":{\"style\":\"html\"},\"query\":{\"conjuncts\":[{\"field\":\"reviews.content\",\"match\":\"La Rue Saint Denis!!\"},{\"field\":\"description\",\"match\":\"boutique\"}]}}"},
+
+{"Wild Card Query, whereby a wildcard is used in the string submitted for the search.",
+ 135,
+ "{\"indexName\":\"travel-sample-index-stored\",\"size\":10,\"highlight\":{\"style\":\"html\"},\"query\":{\"field\":\"description\",\"wildcard\":\"bouti*ue\"}}"},
+
+{"Numeric Range Query, whereby minimum and maximum numbers are specified, and matches within the range returned.",
+ 105,
+ "{\"indexName\":\"travel-sample-index-unstored\",\"size\":10,\"query\":{\"field\":\"id\",\"max\":10200.0,\"min\":10100.0}}"},
+
+{"Regexp Query, whereby a regular expression is submitted, to generate the conditions for successful matches.",
+ 130,
+ "{\"indexName\":\"travel-sample-index-stored\",\"size\":10,\"highlight\":{\"style\":\"html\"},\"query\":{\"field\":\"description\",\"regexp\":\"[a-z]\"}}"},
+
+{NULL, 0, NULL}};

data/ext/libcouchbase/example/fts/queries/00-simple-text-query.json

@@ -0,0 +1,12 @@
+// -*- mode: js; -*-
+// Simple Text Query on a single word, targeting an index with dynamic fields not stored.
+{
+    "indexName": "travel-sample-index-unstored",
+    "size": 10,
+    "highlight": {
+        "style": "html"
+    },
+    "query": {
+        "match": "swanky"
+    }
+}

data/ext/libcouchbase/example/fts/queries/01-simple-text-query-on-non-default-index.json

@@ -0,0 +1,9 @@
+// -*- mode: js; -*-
+// Simple Text Query on Non-Default Index, specifying an index that consists only of content derived from a specific field from a specific document-type.
+{
+    "indexName": "travel-sample-index-hotel-description",
+    "size": 10,
+    "query": {
+        "match": "swanky"
+    }
+}

data/ext/libcouchbase/example/fts/queries/02-simple-text-query-on-stored-field.json

@@ -0,0 +1,13 @@
+// -*- mode: js; -*-
+// Simple Text Query on Stored Field, specifying the field to be searched; targeting an index with dynamic fields stored, to ensure that field-content is included in the return object.
+{
+    "indexName": "travel-sample-index-stored",
+    "size": 10,
+    "highlight": {
+        "style": "html"
+    },
+    "query": {
+        "field": "destinationairport",
+        "match": "MDG"
+    }
+}

data/ext/libcouchbase/example/fts/queries/03-match-query-with-facet.json

@@ -0,0 +1,19 @@
+// -*- mode: js; -*-
+// Match Query with Facet, showing how query-results can be displayed either by row or by hits; and demonstrating use of a facet, which provides aggregation-data.
+{
+    "indexName": "travel-sample-index-stored",
+    "highlight": {
+        "style": "html"
+    },
+    "size": 10,
+    "query": {
+        "field": "reviews.content",
+        "match": "La Rue Saint Denis!!"
+    },
+    "facets": {
+        "Countries Referenced": {
+            "size": 5,
+            "field": "country"
+        }
+    }
+}

data/ext/libcouchbase/example/fts/queries/04-docid-query.json

@@ -0,0 +1,11 @@
+// -*- mode: js; -*-
+// DocId Query, showing results of a query on two document IDs.
+{
+    "indexName": "travel-sample-index-unstored",
+    "query": {
+        "ids": [
+            "hotel_26223",
+            "hotel_28960"
+        ]
+    }
+}

data/ext/libcouchbase/example/fts/queries/05-unanalyzed-term-query-with-fuzziness-level-of-0.json

@@ -0,0 +1,13 @@
+// -*- mode: js; -*-
+// Unanalyzed Term Query with Fuzziness Level of 0, demonstrating how to query on a term with no analysis. Zero fuzziness is specified, to ensure that matches are exact.
+{
+    "indexName": "travel-sample-index-stored",
+    "size": 50,
+    "highlight": {
+        "style": "html"
+    },
+    "query": {
+        "field": "reviews.content",
+        "term": "sushi"
+    }
+}

data/ext/libcouchbase/example/fts/queries/06-unanalyzed-term-query-with-fuzziness-level-of-2.json

@@ -0,0 +1,14 @@
+// -*- mode: js; -*-
+// Unanalyzed Term Query with Fuzziness Level of 2, which is almost identical to the immediately preceding query; but which this time specifies a fuzziness factor of 2, allowing partial matches to be made. The output from this query can be compared to that of the one immediately preceding.
+{
+    "indexName": "travel-sample-index-stored",
+    "size": 50,
+    "highlight": {
+        "style": "html"
+    },
+    "query": {
+        "field": "reviews.content",
+        "fuzziness": 2,
+        "term": "sushi"
+    }
+}

data/ext/libcouchbase/example/fts/queries/07-match-phrase-query.json

@@ -0,0 +1,13 @@
+// -*- mode: js; -*-
+// Match Phrase Query, using Analysis, for searching on a phrase.
+{
+    "indexName": "travel-sample-index-stored",
+    "size": 10,
+    "highlight": {
+        "style": "html"
+    },
+    "query": {
+        "field": "description",
+        "match_phrase": "Eiffel Tower"
+    }
+}

data/ext/libcouchbase/example/fts/queries/08-phrase-query.json

@@ -0,0 +1,16 @@
+// -*- mode: js; -*-
+// Phrase Query, without Analysis, for searching on a phrase without analysis supported.
+{
+    "indexName": "travel-sample-index-stored",
+    "size": 10,
+    "highlight": {
+        "style": "html"
+    },
+    "query": {
+        "field": "description",
+        "terms": [
+            "dorm",
+            "rooms"
+        ]
+    }
+}

data/ext/libcouchbase/example/fts/queries/09-query-string-query.json

@@ -0,0 +1,9 @@
+// -*- mode: js; -*-
+// Query String Query, showing how a query string is specified as search-input.
+{
+    "indexName": "travel-sample-index-unstored",
+    "size": 10,
+    "query": {
+        "query": "description: Imperial"
+    }
+}

data/ext/libcouchbase/example/fts/queries/10-conjunction-query.json

@@ -0,0 +1,21 @@
+// -*- mode: js; -*-
+// Conjunction Query, whereby two separate queries are defined and then run as part of the search, with only the matches returned by both included in the result-object.
+{
+    "indexName": "travel-sample-index-stored",
+    "size": 10,
+    "highlight": {
+        "style": "html"
+    },
+    "query": {
+        "conjuncts": [
+            {
+                "field": "reviews.content",
+                "match": "La Rue Saint Denis!!"
+            },
+            {
+                "field": "description",
+                "match": "boutique"
+            }
+        ]
+    }
+}

data/ext/libcouchbase/example/fts/queries/11-wild-card-query.json

@@ -0,0 +1,13 @@
+// -*- mode: js; -*-
+// Wild Card Query, whereby a wildcard is used in the string submitted for the search.
+{
+    "indexName": "travel-sample-index-stored",
+    "size": 10,
+    "highlight": {
+        "style": "html"
+    },
+    "query": {
+        "field": "description",
+        "wildcard": "bouti*ue"
+    }
+}

data/ext/libcouchbase/example/fts/queries/12-numeric-range-query.json

@@ -0,0 +1,11 @@
+// -*- mode: js; -*-
+// Numeric Range Query, whereby minimum and maximum numbers are specified, and matches within the range returned.
+{
+    "indexName": "travel-sample-index-unstored",
+    "size": 10,
+    "query": {
+        "field": "id",
+        "max": 10200.0,
+        "min": 10100.0
+    }
+}

data/ext/libcouchbase/example/fts/queries/13-regexp-query.json

@@ -0,0 +1,13 @@
+// -*- mode: js; -*-
+// Regexp Query, whereby a regular expression is submitted, to generate the conditions for successful matches.
+{
+    "indexName": "travel-sample-index-stored",
+    "size": 10,
+    "highlight": {
+        "style": "html"
+    },
+    "query": {
+        "field": "description",
+        "regexp": "[a-z]"
+    }
+}

data/ext/libcouchbase/example/minimal/.gitignore

@@ -0,0 +1 @@
+query

data/ext/libcouchbase/example/minimal/query.c

@@ -0,0 +1,185 @@
+/* -*- Mode: C; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*- */
+/*
+ *     Copyright 2018 Couchbase, Inc.
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+
+/**
+
+   CFLAGS="-I$(realpath ../../include) -I$(realpath ../../build/generated)"
+   LDFLAGS="-L$(realpath ../../build/lib) -lcouchbase -Wl,-rpath=$(realpath ../../build/lib)"
+   make query
+
+ */
+
+#include <unistd.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <signal.h>
+
+#include <libcouchbase/couchbase.h>
+#include <libcouchbase/n1ql.h>
+#include <libcouchbase/ixmgmt.h>
+
+static void check(lcb_error_t err, const char *msg)
+{
+    if (err != LCB_SUCCESS) {
+        fprintf(stderr, "[\x1b[31mERROR\x1b[0m] %s: %s\n", msg, lcb_strerror_short(err));
+        exit(EXIT_FAILURE);
+    }
+}
+
+static int err2color(lcb_error_t err)
+{
+    switch (err) {
+        case LCB_SUCCESS:
+            return 32;
+        case LCB_KEY_EEXISTS:
+            return 33;
+        default:
+            return 31;
+    }
+}
+
+static void ln2space(const void *buf, size_t nbuf)
+{
+    size_t ii;
+    char *str = (char *)buf;
+    for (ii = 0; ii < nbuf; ii++) {
+        if (str[ii] == '\n') {
+            str[ii] = ' ';
+        }
+    }
+}
+
+static void row_callback(lcb_t instance, int type, const lcb_RESPN1QL *resp)
+{
+    ln2space(resp->row, resp->nrow);
+    fprintf(stderr, "[\x1b[%dmQUERY\x1b[0m] %s, (%d) %.*s\n", err2color(resp->rc), lcb_strerror_short(resp->rc),
+            (int)resp->nrow, (int)resp->nrow, (char *)resp->row);
+    if (resp->rflags & LCB_RESP_F_FINAL) {
+        fprintf(stderr, "\n");
+    }
+}
+
+static void idx_callback(lcb_t instance, int type, const lcb_RESPN1XMGMT *resp)
+{
+    const lcb_RESPN1QL *inner = resp->inner;
+    ln2space(inner->row, inner->nrow);
+    fprintf(stderr, "[\x1b[%dmINDEX\x1b[0m] %s, (%d) %.*s\n", err2color(resp->rc), lcb_strerror_short(resp->rc),
+            (int)inner->nrow, (int)inner->nrow, (char *)inner->row);
+}
+
+static void kv_callback(lcb_t instance, int type, const lcb_RESPBASE *resp)
+{
+    fprintf(stderr, "[\x1b[%dm%-5s\x1b[0m] %s, key=%.*s\n", err2color(resp->rc), lcb_strcbtype(type),
+            lcb_strerror_short(resp->rc), (int)resp->nkey, resp->key);
+}
+
+static int running = 1;
+static void sigint_handler(int unused)
+{
+    running = 0;
+}
+
+int main(int argc, char *argv[])
+{
+    lcb_error_t err;
+    lcb_t instance;
+    char *bucket = NULL;
+    const char *key = "user:king_arthur";
+    const char *val = "{"
+                      "  \"email\": \"kingarthur@couchbase.com\","
+                      "  \"interests\": [\"Holy Grail\", \"African Swallows\"]"
+                      "}";
+
+    if (argc < 2) {
+        fprintf(stderr, "Usage: %s couchbase://host/bucket [ password [ username ] ]\n", argv[0]);
+        exit(EXIT_FAILURE);
+    }
+
+    {
+        struct lcb_create_st create_options = {0};
+        create_options.version = 3;
+        create_options.v.v3.connstr = argv[1];
+        if (argc > 2) {
+            create_options.v.v3.passwd = argv[2];
+        }
+        if (argc > 3) {
+            create_options.v.v3.username = argv[3];
+        }
+        check(lcb_create(&instance, &create_options), "create couchbase handle");
+        check(lcb_connect(instance), "schedule connection");
+        lcb_wait(instance);
+        check(lcb_get_bootstrap_status(instance), "bootstrap from cluster");
+        check(lcb_cntl(instance, LCB_CNTL_GET, LCB_CNTL_BUCKETNAME, &bucket), "get bucket name");
+        lcb_install_callback3(instance, LCB_CALLBACK_GET, kv_callback);
+        lcb_install_callback3(instance, LCB_CALLBACK_STORE, kv_callback);
+    }
+
+    {
+        lcb_CMDSTORE cmd = {0};
+        LCB_CMD_SET_KEY(&cmd, key, strlen(key));
+        LCB_CMD_SET_VALUE(&cmd, val, strlen(val));
+        cmd.operation = LCB_SET;
+        check(lcb_store3(instance, NULL, &cmd), "schedule STORE operation");
+        lcb_wait(instance);
+    }
+
+    {
+        lcb_CMDGET cmd = {0};
+        LCB_CMD_SET_KEY(&cmd, key, strlen(key));
+        check(lcb_get3(instance, NULL, &cmd), "schedule GET operation");
+        lcb_wait(instance);
+    }
+
+    {
+        lcb_CMDN1XMGMT cmd = {0};
+        cmd.callback = idx_callback;
+        cmd.spec.flags = LCB_N1XSPEC_F_PRIMARY;
+        cmd.spec.ixtype = LCB_N1XSPEC_T_GSI;
+        check(lcb_n1x_create(instance, NULL, &cmd), "schedule N1QL index creation operation");
+        lcb_wait(instance);
+    }
+
+    /* setup CTRL-C handler */
+    struct sigaction action;
+    sigemptyset(&action.sa_mask);
+    action.sa_handler = sigint_handler;
+    action.sa_flags = 0;
+    sigaction(SIGINT, &action, NULL);
+
+    while (running) {
+        lcb_CMDN1QL cmd = {0};
+        char query[1024] = {0};
+        const char *param = "\"African Swallows\"";
+        lcb_N1QLPARAMS *builder = lcb_n1p_new();
+
+        snprintf(query, sizeof(query), "SELECT * FROM `%s` WHERE $1 in interests LIMIT 1", bucket);
+        check(lcb_n1p_setstmtz(builder, query), "set QUERY statement");
+        check(lcb_n1p_posparam(builder, param, strlen(param)), "set QUERY positional parameter");
+        check(lcb_n1p_setopt(builder, "pretty", strlen("pretty"), "false", strlen("false")),
+              "set QUERY 'pretty' option");
+        check(lcb_n1p_mkcmd(builder, &cmd), "build QUERY command structure");
+        cmd.callback = row_callback;
+        check(lcb_n1ql_query(instance, NULL, &cmd), "schedule QUERY operation");
+        lcb_n1p_free(builder);
+        lcb_wait(instance);
+    }
+
+    /* Now that we're all done, close down the connection handle */
+    lcb_destroy(instance);
+    return 0;
+}