po4a/iconv/po/iconv.pot

   1 # SOME DESCRIPTIVE TITLE
   2 # Copyright (C) YEAR Free Software Foundation, Inc.
   3 # This file is distributed under the same license as the PACKAGE package.
   4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
   5 #
   6 #, fuzzy
   7 msgid ""
   8 msgstr ""
   9 "Project-Id-Version: PACKAGE VERSION\n"
  10 "POT-Creation-Date: 2012-04-25 05:36+0900\n"
  11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13 "Language-Team: LANGUAGE <LL@li.org>\n"
  14 "Language: \n"
  15 "MIME-Version: 1.0\n"
  16 "Content-Type: text/plain; charset=CHARSET\n"
  17 "Content-Transfer-Encoding: 8bit\n"
  18
  19 #. type: TH
  20 #: build/C/man3/iconv.3:16
  21 #, no-wrap
  22 msgid "ICONV"
  23 msgstr ""
  24
  25 #. type: TH
  26 #: build/C/man3/iconv.3:16
  27 #, no-wrap
  28 msgid "2008-09-08"
  29 msgstr ""
  30
  31 #. type: TH
  32 #: build/C/man3/iconv.3:16 build/C/man3/iconv_close.3:12 build/C/man3/iconv_open.3:16
  33 #, no-wrap
  34 msgid "GNU"
  35 msgstr ""
  36
  37 #. type: TH
  38 #: build/C/man3/iconv.3:16 build/C/man3/iconv_close.3:12 build/C/man3/iconv_open.3:16
  39 #, no-wrap
  40 msgid "Linux Programmer's Manual"
  41 msgstr ""
  42
  43 #. type: SH
  44 #: build/C/man3/iconv.3:17 build/C/man3/iconv_close.3:13 build/C/man3/iconv_open.3:17
  45 #, no-wrap
  46 msgid "NAME"
  47 msgstr ""
  48
  49 #. type: Plain text
  50 #: build/C/man3/iconv.3:19
  51 msgid "iconv - perform character set conversion"
  52 msgstr ""
  53
  54 #. type: SH
  55 #: build/C/man3/iconv.3:19 build/C/man3/iconv_close.3:15 build/C/man3/iconv_open.3:19
  56 #, no-wrap
  57 msgid "SYNOPSIS"
  58 msgstr ""
  59
  60 #. type: Plain text
  61 #: build/C/man3/iconv.3:22 build/C/man3/iconv_close.3:18 build/C/man3/iconv_open.3:22
  62 #, no-wrap
  63 msgid "B<#include E<lt>iconv.hE<gt>>\n"
  64 msgstr ""
  65
  66 #. type: Plain text
  67 #: build/C/man3/iconv.3:26
  68 #, no-wrap
  69 msgid ""
  70 "B<size_t iconv(iconv_t >I<cd>B<,>\n"
  71 "B<             char **>I<inbuf>B<, size_t *>I<inbytesleft>B<,>\n"
  72 "B<             char **>I<outbuf>B<, size_t *>I<outbytesleft>B<);>\n"
  73 msgstr ""
  74
  75 #. type: SH
  76 #: build/C/man3/iconv.3:27 build/C/man3/iconv_close.3:21 build/C/man3/iconv_open.3:25
  77 #, no-wrap
  78 msgid "DESCRIPTION"
  79 msgstr ""
  80
  81 #. type: Plain text
  82 #: build/C/man3/iconv.3:31
  83 msgid ""
  84 "The argument I<cd> must be a conversion descriptor created using the "
  85 "function B<iconv_open>(3)."
  86 msgstr ""
  87
  88 #. type: Plain text
  89 #: build/C/man3/iconv.3:39
  90 msgid ""
  91 "The main case is when I<inbuf> is not NULL and I<*inbuf> is not NULL.  In "
  92 "this case, the B<iconv>()  function converts the multibyte sequence starting "
  93 "at I<*inbuf> to a multibyte sequence starting at I<*outbuf>.  At most "
  94 "I<*inbytesleft> bytes, starting at I<*inbuf>, will be read.  At most "
  95 "I<*outbytesleft> bytes, starting at I<*outbuf>, will be written."
  96 msgstr ""
  97
  98 #. type: Plain text
  99 #: build/C/man3/iconv.3:53
 100 msgid ""
 101 "The B<iconv>()  function converts one multibyte character at a time, and for "
 102 "each character conversion it increments I<*inbuf> and decrements "
 103 "I<*inbytesleft> by the number of converted input bytes, it increments "
 104 "I<*outbuf> and decrements I<*outbytesleft> by the number of converted output "
 105 "bytes, and it updates the conversion state contained in I<cd>.  If the "
 106 "character encoding of the input is stateful, the B<iconv>()  function can "
 107 "also convert a sequence of input bytes to an update to the conversion state "
 108 "without producing any output bytes; such input is called a I<shift "
 109 "sequence>.  The conversion can stop for four reasons:"
 110 msgstr ""
 111
 112 #. type: Plain text
 113 #: build/C/man3/iconv.3:60
 114 msgid ""
 115 "1. An invalid multibyte sequence is encountered in the input.  In this case "
 116 "it sets I<errno> to B<EILSEQ> and returns I<(size_t)\\ -1>.  I<*inbuf> is "
 117 "left pointing to the beginning of the invalid multibyte sequence."
 118 msgstr ""
 119
 120 #. type: Plain text
 121 #: build/C/man3/iconv.3:67
 122 msgid ""
 123 "2. The input byte sequence has been entirely converted, that is, "
 124 "I<*inbytesleft> has gone down to 0.  In this case B<iconv>()  returns the "
 125 "number of nonreversible conversions performed during this call."
 126 msgstr ""
 127
 128 #. type: Plain text
 129 #: build/C/man3/iconv.3:75
 130 msgid ""
 131 "3. An incomplete multibyte sequence is encountered in the input, and the "
 132 "input byte sequence terminates after it.  In this case it sets I<errno> to "
 133 "B<EINVAL> and returns I<(size_t)\\ -1>.  I<*inbuf> is left pointing to the "
 134 "beginning of the incomplete multibyte sequence."
 135 msgstr ""
 136
 137 #. type: Plain text
 138 #: build/C/man3/iconv.3:79
 139 msgid ""
 140 "4. The output buffer has no more room for the next converted character.  In "
 141 "this case it sets I<errno> to B<E2BIG> and returns I<(size_t)\\ -1>."
 142 msgstr ""
 143
 144 #. type: Plain text
 145 #: build/C/man3/iconv.3:93
 146 msgid ""
 147 "A different case is when I<inbuf> is NULL or I<*inbuf> is NULL, but "
 148 "I<outbuf> is not NULL and I<*outbuf> is not NULL.  In this case, the "
 149 "B<iconv>()  function attempts to set I<cd>'s conversion state to the initial "
 150 "state and store a corresponding shift sequence at I<*outbuf>.  At most "
 151 "I<*outbytesleft> bytes, starting at I<*outbuf>, will be written.  If the "
 152 "output buffer has no more room for this reset sequence, it sets I<errno> to "
 153 "B<E2BIG> and returns I<(size_t)\\ -1>.  Otherwise it increments I<*outbuf> "
 154 "and decrements I<*outbytesleft> by the number of bytes written."
 155 msgstr ""
 156
 157 #. type: Plain text
 158 #: build/C/man3/iconv.3:99
 159 msgid ""
 160 "A third case is when I<inbuf> is NULL or I<*inbuf> is NULL, and I<outbuf> is "
 161 "NULL or I<*outbuf> is NULL.  In this case, the B<iconv>()  function sets "
 162 "I<cd>'s conversion state to the initial state."
 163 msgstr ""
 164
 165 #. type: SH
 166 #: build/C/man3/iconv.3:99 build/C/man3/iconv_close.3:27 build/C/man3/iconv_open.3:69
 167 #, no-wrap
 168 msgid "RETURN VALUE"
 169 msgstr ""
 170
 171 #. type: Plain text
 172 #: build/C/man3/iconv.3:106
 173 msgid ""
 174 "The B<iconv>()  function returns the number of characters converted in a "
 175 "nonreversible way during this call; reversible conversions are not counted.  "
 176 "In case of error, it sets I<errno> and returns I<(size_t)\\ -1>."
 177 msgstr ""
 178
 179 #. type: SH
 180 #: build/C/man3/iconv.3:106 build/C/man3/iconv_open.3:76
 181 #, no-wrap
 182 msgid "ERRORS"
 183 msgstr ""
 184
 185 #. type: Plain text
 186 #: build/C/man3/iconv.3:108
 187 msgid "The following errors can occur, among others:"
 188 msgstr ""
 189
 190 #. type: TP
 191 #: build/C/man3/iconv.3:108
 192 #, no-wrap
 193 msgid "B<E2BIG>"
 194 msgstr ""
 195
 196 #. type: Plain text
 197 #: build/C/man3/iconv.3:111
 198 msgid "There is not sufficient room at I<*outbuf>."
 199 msgstr ""
 200
 201 #. type: TP
 202 #: build/C/man3/iconv.3:111
 203 #, no-wrap
 204 msgid "B<EILSEQ>"
 205 msgstr ""
 206
 207 #. type: Plain text
 208 #: build/C/man3/iconv.3:114
 209 msgid "An invalid multibyte sequence has been encountered in the input."
 210 msgstr ""
 211
 212 #. type: TP
 213 #: build/C/man3/iconv.3:114 build/C/man3/iconv_open.3:78
 214 #, no-wrap
 215 msgid "B<EINVAL>"
 216 msgstr ""
 217
 218 #. type: Plain text
 219 #: build/C/man3/iconv.3:117
 220 msgid "An incomplete multibyte sequence has been encountered in the input."
 221 msgstr ""
 222
 223 #. type: SH
 224 #: build/C/man3/iconv.3:117 build/C/man3/iconv_close.3:34 build/C/man3/iconv_open.3:82
 225 #, no-wrap
 226 msgid "VERSIONS"
 227 msgstr ""
 228
 229 #. type: Plain text
 230 #: build/C/man3/iconv.3:119 build/C/man3/iconv_close.3:36 build/C/man3/iconv_open.3:84
 231 msgid "This function is available in glibc since version 2.1."
 232 msgstr ""
 233
 234 #. type: SH
 235 #: build/C/man3/iconv.3:119 build/C/man3/iconv_close.3:36 build/C/man3/iconv_open.3:84
 236 #, no-wrap
 237 msgid "CONFORMING TO"
 238 msgstr ""
 239
 240 #. type: Plain text
 241 #: build/C/man3/iconv.3:121
 242 msgid "POSIX.1-2001."
 243 msgstr ""
 244
 245 #. type: SH
 246 #: build/C/man3/iconv.3:121 build/C/man3/iconv_close.3:38 build/C/man3/iconv_open.3:86
 247 #, no-wrap
 248 msgid "SEE ALSO"
 249 msgstr ""
 250
 251 #. type: Plain text
 252 #: build/C/man3/iconv.3:123
 253 msgid "B<iconv_close>(3), B<iconv_open>(3)"
 254 msgstr ""
 255
 256 #. type: TH
 257 #: build/C/man3/iconv_close.3:12
 258 #, no-wrap
 259 msgid "ICONV_CLOSE"
 260 msgstr ""
 261
 262 #. type: TH
 263 #: build/C/man3/iconv_close.3:12 build/C/man3/iconv_open.3:16
 264 #, no-wrap
 265 msgid "2008-08-11"
 266 msgstr ""
 267
 268 #. type: Plain text
 269 #: build/C/man3/iconv_close.3:15
 270 msgid "iconv_close - deallocate descriptor for character set conversion"
 271 msgstr ""
 272
 273 #. type: Plain text
 274 #: build/C/man3/iconv_close.3:20
 275 #, no-wrap
 276 msgid "B<int iconv_close(iconv_t >I<cd>B<);>\n"
 277 msgstr ""
 278
 279 #. type: Plain text
 280 #: build/C/man3/iconv_close.3:27
 281 msgid ""
 282 "The B<iconv_close>()  function deallocates a conversion descriptor I<cd> "
 283 "previously allocated using B<iconv_open>(3)."
 284 msgstr ""
 285
 286 #. type: Plain text
 287 #: build/C/man3/iconv_close.3:34
 288 msgid ""
 289 "When successful, the B<iconv_close>()  function returns 0.  In case of "
 290 "error, it sets I<errno> and returns -1."
 291 msgstr ""
 292
 293 #. type: Plain text
 294 #: build/C/man3/iconv_close.3:38 build/C/man3/iconv_open.3:86
 295 msgid "UNIX98, POSIX.1-2001."
 296 msgstr ""
 297
 298 #. type: Plain text
 299 #: build/C/man3/iconv_close.3:40
 300 msgid "B<iconv>(3), B<iconv_open>(3)"
 301 msgstr ""
 302
 303 #. type: TH
 304 #: build/C/man3/iconv_open.3:16
 305 #, no-wrap
 306 msgid "ICONV_OPEN"
 307 msgstr ""
 308
 309 #. type: Plain text
 310 #: build/C/man3/iconv_open.3:19
 311 msgid "iconv_open - allocate descriptor for character set conversion"
 312 msgstr ""
 313
 314 #. type: Plain text
 315 #: build/C/man3/iconv_open.3:24
 316 #, no-wrap
 317 msgid ""
 318 "B<iconv_t iconv_open(const char *>I<tocode>B<, const char "
 319 "*>I<fromcode>B<);>\n"
 320 msgstr ""
 321
 322 #. type: Plain text
 323 #: build/C/man3/iconv_open.3:31
 324 msgid ""
 325 "The B<iconv_open>()  function allocates a conversion descriptor suitable for "
 326 "converting byte sequences from character encoding I<fromcode> to character "
 327 "encoding I<tocode>."
 328 msgstr ""
 329
 330 #. type: Plain text
 331 #: build/C/man3/iconv_open.3:39
 332 msgid ""
 333 "The values permitted for I<fromcode> and I<tocode> and the supported "
 334 "combinations are system-dependent.  For the GNU C library, the permitted "
 335 "values are listed by the B<iconv --list> command, and all combinations of "
 336 "the listed values are supported.  Furthermore the GNU C library and the GNU "
 337 "libiconv library support the following two suffixes:"
 338 msgstr ""
 339
 340 #. type: TP
 341 #: build/C/man3/iconv_open.3:39
 342 #, no-wrap
 343 msgid "//TRANSLIT"
 344 msgstr ""
 345
 346 #. type: Plain text
 347 #: build/C/man3/iconv_open.3:46
 348 msgid ""
 349 "When the string \"//TRANSLIT\" is appended to I<tocode>, transliteration is "
 350 "activated.  This means that when a character cannot be represented in the "
 351 "target character set, it can be approximated through one or several "
 352 "similarly looking characters."
 353 msgstr ""
 354
 355 #. type: TP
 356 #: build/C/man3/iconv_open.3:46
 357 #, no-wrap
 358 msgid "//IGNORE"
 359 msgstr ""
 360
 361 #. type: Plain text
 362 #: build/C/man3/iconv_open.3:50
 363 msgid ""
 364 "When the string \"//IGNORE\" is appended to I<tocode>, characters that "
 365 "cannot be represented in the target character set will be silently "
 366 "discarded."
 367 msgstr ""
 368
 369 #. type: Plain text
 370 #: build/C/man3/iconv_open.3:56
 371 msgid ""
 372 "The resulting conversion descriptor can be used with B<iconv>(3)  any number "
 373 "of times.  It remains valid until deallocated using B<iconv_close>(3)."
 374 msgstr ""
 375
 376 #. type: Plain text
 377 #: build/C/man3/iconv_open.3:69
 378 msgid ""
 379 "A conversion descriptor contains a conversion state.  After creation using "
 380 "B<iconv_open>(), the state is in the initial state.  Using B<iconv>(3)  "
 381 "modifies the descriptor's conversion state.  (This implies that a conversion "
 382 "descriptor can not be used in multiple threads simultaneously.)  To bring "
 383 "the state back to the initial state, use B<iconv>(3)  with NULL as I<inbuf> "
 384 "argument."
 385 msgstr ""
 386
 387 #. type: Plain text
 388 #: build/C/man3/iconv_open.3:76
 389 msgid ""
 390 "The B<iconv_open>()  function returns a freshly allocated conversion "
 391 "descriptor.  In case of error, it sets I<errno> and returns I<(iconv_t)\\ "
 392 "-1>."
 393 msgstr ""
 394
 395 #. type: Plain text
 396 #: build/C/man3/iconv_open.3:78
 397 msgid "The following error can occur, among others:"
 398 msgstr ""
 399
 400 #. type: Plain text
 401 #: build/C/man3/iconv_open.3:82
 402 msgid ""
 403 "The conversion from I<fromcode> to I<tocode> is not supported by the "
 404 "implementation."
 405 msgstr ""
 406
 407 #. type: Plain text
 408 #: build/C/man3/iconv_open.3:89
 409 msgid "B<iconv>(1), B<iconv>(3), B<iconv_close>(3)"
 410 msgstr ""