1 /* 2 * This file is part of gtkD. 3 * 4 * gtkD is free software; you can redistribute it and/or modify 5 * it under the terms of the GNU Lesser General Public License 6 * as published by the Free Software Foundation; either version 3 7 * of the License, or (at your option) any later version, with 8 * some exceptions, please read the COPYING file. 9 * 10 * gtkD is distributed in the hope that it will be useful, 11 * but WITHOUT ANY WARRANTY; without even the implied warranty of 12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 13 * GNU Lesser General Public License for more details. 14 * 15 * You should have received a copy of the GNU Lesser General Public License 16 * along with gtkD; if not, write to the Free Software 17 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110, USA 18 */ 19 20 // generated automatically - do not change 21 // find conversion definition on APILookup.txt 22 // implement new conversion functionalities on the wrap.utils pakage 23 24 /* 25 * Conversion parameters: 26 * inFile = cairo-Version-Information.html 27 * outPack = cairo 28 * outFile = Version 29 * strct = 30 * realStrct= 31 * ctorStrct= 32 * clss = Version 33 * interf = 34 * class Code: No 35 * interface Code: No 36 * template for: 37 * extend = 38 * implements: 39 * prefixes: 40 * omit structs: 41 * omit prefixes: 42 * omit code: 43 * omit signals: 44 * imports: 45 * - glib.Str 46 * structWrap: 47 * module aliases: 48 * local aliases: 49 * overrides: 50 */ 51 52 module cairo.Version; 53 54 public import gtkc.cairotypes; 55 56 private import gtkc.cairo; 57 private import glib.ConstructionException; 58 59 private import glib.Str; 60 61 62 63 /** 64 * Cairo has a three-part version number scheme. In this scheme, we use 65 * even vs. odd numbers to distinguish fixed points in the software 66 * vs. in-progress development, (such as from git instead of a tar file, 67 * or as a "snapshot" tar file as opposed to a "release" tar file). 68 * 69 * $(DDOC_COMMENT example) 70 * 71 * Here are a few examples of versions that one might see. 72 * 73 * $(DDOC_COMMENT example) 74 * 75 * Compatibility 76 * 77 * The API/ABI compatibility guarantees for various versions are as 78 * follows. First, let's assume some cairo-using application code that is 79 * successfully using the API/ABI "from" one version of cairo. Then let's 80 * ask the question whether this same code can be moved "to" the API/ABI 81 * of another version of cairo. 82 * 83 * Moving from a release to any later version (release, snapshot, 84 * development) is always guaranteed to provide compatibility. 85 * 86 * Moving from a snapshot to any later version is not guaranteed to 87 * provide compatibility, since snapshots may introduce new API that ends 88 * up being removed before the next release. 89 * 90 * Moving from an in-development version (odd micro component) to any 91 * later version is not guaranteed to provide compatibility. In fact, 92 * there's not even a guarantee that the code will even continue to work 93 * with the same in-development version number. This is because these 94 * numbers don't correspond to any fixed state of the software, but 95 * rather the many states between snapshots and releases. 96 * 97 * <hr> 98 * 99 * Examining the version 100 * 101 * Cairo provides the ability to examine the version at either 102 * compile-time or run-time and in both a human-readable form as well as 103 * an encoded form suitable for direct comparison. Cairo also provides the 104 * macro CAIRO_VERSION_ENCODE() to perform the encoding. 105 * 106 * $(DDOC_COMMENT example) 107 * 108 * For example, checking that the cairo version is greater than or equal 109 * to 1.0.0 could be achieved at compile-time or run-time as follows: 110 * 111 * $(DDOC_COMMENT example) 112 */ 113 public class Version 114 { 115 116 /** 117 */ 118 119 /** 120 * Returns the version of the cairo library encoded in a single 121 * integer as per CAIRO_VERSION_ENCODE. The encoding ensures that 122 * later versions compare greater than earlier versions. 123 * A run-time comparison to check that cairo's version is greater than 124 * Returns: the encoded version. 125 */ 126 public static int cairoVersion() 127 { 128 // int cairo_version (void); 129 return cairo_version(); 130 } 131 132 /** 133 * Returns the version of the cairo library as a human-readable string 134 * of the form "X.Y.Z". 135 * See also cairo_version() as well as the compile-time equivalents 136 * CAIRO_VERSION_STRING and CAIRO_VERSION. 137 * Returns: a string containing the version. 138 */ 139 public static string cairoVersionString() 140 { 141 // const char * cairo_version_string (void); 142 return Str.toString(cairo_version_string()); 143 } 144 }