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: 2015-01-23 22:24+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=UTF-8\n"
  17 "Content-Transfer-Encoding: 8bit\n"
  18
  19 #. type: TH
  20 #: build/C/man3/iconv.3:18
  21 #, no-wrap
  22 msgid "ICONV"
  23 msgstr ""
  24
  25 #. type: TH
  26 #: build/C/man3/iconv.3:18
  27 #, no-wrap
  28 msgid "2014-06-13"
  29 msgstr ""
  30
  31 #. type: TH
  32 #: build/C/man3/iconv.3:18 build/C/man3/iconv_close.3:14 build/C/man3/iconv_open.3:18
  33 #, no-wrap
  34 msgid "GNU"
  35 msgstr ""
  36
  37 #. type: TH
  38 #: build/C/man3/iconv.3:18 build/C/man3/iconv_close.3:14 build/C/man3/iconv_open.3:18
  39 #, no-wrap
  40 msgid "Linux Programmer's Manual"
  41 msgstr ""
  42
  43 #. type: SH
  44 #: build/C/man3/iconv.3:19 build/C/man3/iconv_close.3:15 build/C/man3/iconv_open.3:19
  45 #, no-wrap
  46 msgid "NAME"
  47 msgstr ""
  48
  49 #. type: Plain text
  50 #: build/C/man3/iconv.3:21
  51 msgid "iconv - perform character set conversion"
  52 msgstr ""
  53
  54 #. type: SH
  55 #: build/C/man3/iconv.3:21 build/C/man3/iconv_close.3:17 build/C/man3/iconv_open.3:21
  56 #, no-wrap
  57 msgid "SYNOPSIS"
  58 msgstr ""
  59
  60 #. type: Plain text
  61 #: build/C/man3/iconv.3:24 build/C/man3/iconv_close.3:20 build/C/man3/iconv_open.3:24
  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:28
  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:29 build/C/man3/iconv_close.3:23 build/C/man3/iconv_open.3:27
  77 #, no-wrap
  78 msgid "DESCRIPTION"
  79 msgstr ""
  80
  81 #. type: Plain text
  82 #: build/C/man3/iconv.3:54
  83 msgid ""
  84 "The B<iconv>()  function converts a sequence of characters in one character "
  85 "encoding to a sequence of characters in another character encoding.  The "
  86 "I<cd> argument is a conversion descriptor, previously created by a call to "
  87 "B<iconv_open>(3); the conversion descriptor defines the character encodings "
  88 "that B<iconv>()  uses for the conversion.  The I<inbuf> argument is the "
  89 "address of a variable that points to the first character of the input "
  90 "sequence; I<inbytesleft> indicates the number of bytes in that buffer.  The "
  91 "I<outbuf> argument is the address of a variable that points to the first "
  92 "byte available in the output buffer; I<outbytesleft> indicates the number of "
  93 "bytes available in the output buffer."
  94 msgstr ""
  95
  96 #. type: Plain text
  97 #: build/C/man3/iconv.3:62
  98 msgid ""
  99 "The main case is when I<inbuf> is not NULL and I<*inbuf> is not NULL.  In "
 100 "this case, the B<iconv>()  function converts the multibyte sequence starting "
 101 "at I<*inbuf> to a multibyte sequence starting at I<*outbuf>.  At most "
 102 "I<*inbytesleft> bytes, starting at I<*inbuf>, will be read.  At most "
 103 "I<*outbytesleft> bytes, starting at I<*outbuf>, will be written."
 104 msgstr ""
 105
 106 #. type: Plain text
 107 #: build/C/man3/iconv.3:76
 108 msgid ""
 109 "The B<iconv>()  function converts one multibyte character at a time, and for "
 110 "each character conversion it increments I<*inbuf> and decrements "
 111 "I<*inbytesleft> by the number of converted input bytes, it increments "
 112 "I<*outbuf> and decrements I<*outbytesleft> by the number of converted output "
 113 "bytes, and it updates the conversion state contained in I<cd>.  If the "
 114 "character encoding of the input is stateful, the B<iconv>()  function can "
 115 "also convert a sequence of input bytes to an update to the conversion state "
 116 "without producing any output bytes; such input is called a I<shift "
 117 "sequence>.  The conversion can stop for four reasons:"
 118 msgstr ""
 119
 120 #. type: IP
 121 #: build/C/man3/iconv.3:76
 122 #, no-wrap
 123 msgid "1."
 124 msgstr ""
 125
 126 #. type: Plain text
 127 #: build/C/man3/iconv.3:83
 128 msgid ""
 129 "An invalid multibyte sequence is encountered in the input.  In this case, it "
 130 "sets I<errno> to B<EILSEQ> and returns I<(size_t)\\ -1>.  I<*inbuf> is left "
 131 "pointing to the beginning of the invalid multibyte sequence."
 132 msgstr ""
 133
 134 #. type: IP
 135 #: build/C/man3/iconv.3:83
 136 #, no-wrap
 137 msgid "2."
 138 msgstr ""
 139
 140 #. type: Plain text
 141 #: build/C/man3/iconv.3:90
 142 msgid ""
 143 "The input byte sequence has been entirely converted, that is, "
 144 "I<*inbytesleft> has gone down to 0.  In this case, B<iconv>()  returns the "
 145 "number of nonreversible conversions performed during this call."
 146 msgstr ""
 147
 148 #. type: IP
 149 #: build/C/man3/iconv.3:90
 150 #, no-wrap
 151 msgid "3."
 152 msgstr ""
 153
 154 #. type: Plain text
 155 #: build/C/man3/iconv.3:98
 156 msgid ""
 157 "An incomplete multibyte sequence is encountered in the input, and the input "
 158 "byte sequence terminates after it.  In this case, it sets I<errno> to "
 159 "B<EINVAL> and returns I<(size_t)\\ -1>.  I<*inbuf> is left pointing to the "
 160 "beginning of the incomplete multibyte sequence."
 161 msgstr ""
 162
 163 #. type: IP
 164 #: build/C/man3/iconv.3:98
 165 #, no-wrap
 166 msgid "4."
 167 msgstr ""
 168
 169 #. type: Plain text
 170 #: build/C/man3/iconv.3:102
 171 msgid ""
 172 "The output buffer has no more room for the next converted character.  In "
 173 "this case, it sets I<errno> to B<E2BIG> and returns I<(size_t)\\ -1>."
 174 msgstr ""
 175
 176 #. type: Plain text
 177 #: build/C/man3/iconv.3:116
 178 msgid ""
 179 "A different case is when I<inbuf> is NULL or I<*inbuf> is NULL, but "
 180 "I<outbuf> is not NULL and I<*outbuf> is not NULL.  In this case, the "
 181 "B<iconv>()  function attempts to set I<cd>'s conversion state to the initial "
 182 "state and store a corresponding shift sequence at I<*outbuf>.  At most "
 183 "I<*outbytesleft> bytes, starting at I<*outbuf>, will be written.  If the "
 184 "output buffer has no more room for this reset sequence, it sets I<errno> to "
 185 "B<E2BIG> and returns I<(size_t)\\ -1>.  Otherwise, it increments I<*outbuf> "
 186 "and decrements I<*outbytesleft> by the number of bytes written."
 187 msgstr ""
 188
 189 #. type: Plain text
 190 #: build/C/man3/iconv.3:122
 191 msgid ""
 192 "A third case is when I<inbuf> is NULL or I<*inbuf> is NULL, and I<outbuf> is "
 193 "NULL or I<*outbuf> is NULL.  In this case, the B<iconv>()  function sets "
 194 "I<cd>'s conversion state to the initial state."
 195 msgstr ""
 196
 197 #. type: SH
 198 #: build/C/man3/iconv.3:122 build/C/man3/iconv_close.3:30 build/C/man3/iconv_open.3:86
 199 #, no-wrap
 200 msgid "RETURN VALUE"
 201 msgstr ""
 202
 203 #. type: Plain text
 204 #: build/C/man3/iconv.3:129
 205 msgid ""
 206 "The B<iconv>()  function returns the number of characters converted in a "
 207 "nonreversible way during this call; reversible conversions are not counted.  "
 208 "In case of error, it sets I<errno> and returns I<(size_t)\\ -1>."
 209 msgstr ""
 210
 211 #. type: SH
 212 #: build/C/man3/iconv.3:129 build/C/man3/iconv_open.3:95
 213 #, no-wrap
 214 msgid "ERRORS"
 215 msgstr ""
 216
 217 #. type: Plain text
 218 #: build/C/man3/iconv.3:131
 219 msgid "The following errors can occur, among others:"
 220 msgstr ""
 221
 222 #. type: TP
 223 #: build/C/man3/iconv.3:131
 224 #, no-wrap
 225 msgid "B<E2BIG>"
 226 msgstr ""
 227
 228 #. type: Plain text
 229 #: build/C/man3/iconv.3:134
 230 msgid "There is not sufficient room at I<*outbuf>."
 231 msgstr ""
 232
 233 #. type: TP
 234 #: build/C/man3/iconv.3:134
 235 #, no-wrap
 236 msgid "B<EILSEQ>"
 237 msgstr ""
 238
 239 #. type: Plain text
 240 #: build/C/man3/iconv.3:137
 241 msgid "An invalid multibyte sequence has been encountered in the input."
 242 msgstr ""
 243
 244 #. type: TP
 245 #: build/C/man3/iconv.3:137 build/C/man3/iconv_open.3:97
 246 #, no-wrap
 247 msgid "B<EINVAL>"
 248 msgstr ""
 249
 250 #. type: Plain text
 251 #: build/C/man3/iconv.3:140
 252 msgid "An incomplete multibyte sequence has been encountered in the input."
 253 msgstr ""
 254
 255 #. type: SH
 256 #: build/C/man3/iconv.3:140 build/C/man3/iconv_close.3:37 build/C/man3/iconv_open.3:105
 257 #, no-wrap
 258 msgid "VERSIONS"
 259 msgstr ""
 260
 261 #. type: Plain text
 262 #: build/C/man3/iconv.3:142 build/C/man3/iconv_close.3:39 build/C/man3/iconv_open.3:107
 263 msgid "This function is available in glibc since version 2.1."
 264 msgstr ""
 265
 266 #. type: SH
 267 #: build/C/man3/iconv.3:142
 268 #, no-wrap
 269 msgid "ATTRIBUTES"
 270 msgstr ""
 271
 272 #. type: SS
 273 #: build/C/man3/iconv.3:143
 274 #, no-wrap
 275 msgid "Multithreading (see pthreads(7))"
 276 msgstr ""
 277
 278 #. type: Plain text
 279 #: build/C/man3/iconv.3:147
 280 msgid "The B<iconv>()  function is thread-safe."
 281 msgstr ""
 282
 283 #. type: SH
 284 #: build/C/man3/iconv.3:147 build/C/man3/iconv_close.3:39 build/C/man3/iconv_open.3:107
 285 #, no-wrap
 286 msgid "CONFORMING TO"
 287 msgstr ""
 288
 289 #. type: Plain text
 290 #: build/C/man3/iconv.3:149
 291 msgid "POSIX.1-2001."
 292 msgstr ""
 293
 294 #. type: SH
 295 #: build/C/man3/iconv.3:149
 296 #, no-wrap
 297 msgid "NOTES"
 298 msgstr ""
 299
 300 #. type: Plain text
 301 #: build/C/man3/iconv.3:161
 302 msgid ""
 303 "Although I<inbuf> and I<outbuf> are typed as I<char\\ **>, this does not "
 304 "mean that the objects they point can be interpreted as C strings or as "
 305 "arrays of characters: the interpretation of character byte sequences is "
 306 "handled internally by the conversion functions.  In some encodings, a zero "
 307 "byte may be a valid part of a multibyte character."
 308 msgstr ""
 309
 310 #. type: Plain text
 311 #: build/C/man3/iconv.3:168
 312 msgid ""
 313 "The caller of B<iconv>()  must ensure that the pointers passed to the "
 314 "function are suitable for accessing characters in the appropriate character "
 315 "set.  This includes ensuring correct alignment on platforms that have tight "
 316 "restrictions on alignment."
 317 msgstr ""
 318
 319 #. type: SH
 320 #: build/C/man3/iconv.3:168 build/C/man3/iconv_close.3:41 build/C/man3/iconv_open.3:109
 321 #, no-wrap
 322 msgid "SEE ALSO"
 323 msgstr ""
 324
 325 #. type: Plain text
 326 #: build/C/man3/iconv.3:172
 327 msgid "B<iconv_close>(3), B<iconv_open>(3), B<iconvconfig>(8)"
 328 msgstr ""
 329
 330 #. type: SH
 331 #: build/C/man3/iconv.3:172 build/C/man3/iconv_close.3:44 build/C/man3/iconv_open.3:113
 332 #, no-wrap
 333 msgid "COLOPHON"
 334 msgstr ""
 335
 336 #. type: Plain text
 337 #: build/C/man3/iconv.3:180 build/C/man3/iconv_close.3:52 build/C/man3/iconv_open.3:121
 338 msgid ""
 339 "This page is part of release 3.78 of the Linux I<man-pages> project.  A "
 340 "description of the project, information about reporting bugs, and the latest "
 341 "version of this page, can be found at "
 342 "\\%http://www.kernel.org/doc/man-pages/."
 343 msgstr ""
 344
 345 #. type: TH
 346 #: build/C/man3/iconv_close.3:14
 347 #, no-wrap
 348 msgid "ICONV_CLOSE"
 349 msgstr ""
 350
 351 #. type: TH
 352 #: build/C/man3/iconv_close.3:14 build/C/man3/iconv_open.3:18
 353 #, no-wrap
 354 msgid "2008-08-11"
 355 msgstr ""
 356
 357 #. type: Plain text
 358 #: build/C/man3/iconv_close.3:17
 359 msgid "iconv_close - deallocate descriptor for character set conversion"
 360 msgstr ""
 361
 362 #. type: Plain text
 363 #: build/C/man3/iconv_close.3:22
 364 #, no-wrap
 365 msgid "B<int iconv_close(iconv_t >I<cd>B<);>\n"
 366 msgstr ""
 367
 368 #. type: Plain text
 369 #: build/C/man3/iconv_close.3:30
 370 msgid ""
 371 "The B<iconv_close>()  function deallocates a conversion descriptor I<cd> "
 372 "previously allocated using B<iconv_open>(3)."
 373 msgstr ""
 374
 375 #. type: Plain text
 376 #: build/C/man3/iconv_close.3:37
 377 msgid ""
 378 "When successful, the B<iconv_close>()  function returns 0.  In case of "
 379 "error, it sets I<errno> and returns -1."
 380 msgstr ""
 381
 382 #. type: Plain text
 383 #: build/C/man3/iconv_close.3:41 build/C/man3/iconv_open.3:109
 384 msgid "UNIX98, POSIX.1-2001."
 385 msgstr ""
 386
 387 #. type: Plain text
 388 #: build/C/man3/iconv_close.3:44
 389 msgid "B<iconv>(3), B<iconv_open>(3)"
 390 msgstr ""
 391
 392 #. type: TH
 393 #: build/C/man3/iconv_open.3:18
 394 #, no-wrap
 395 msgid "ICONV_OPEN"
 396 msgstr ""
 397
 398 #. type: Plain text
 399 #: build/C/man3/iconv_open.3:21
 400 msgid "iconv_open - allocate descriptor for character set conversion"
 401 msgstr ""
 402
 403 #. type: Plain text
 404 #: build/C/man3/iconv_open.3:26
 405 #, no-wrap
 406 msgid ""
 407 "B<iconv_t iconv_open(const char *>I<tocode>B<, const char "
 408 "*>I<fromcode>B<);>\n"
 409 msgstr ""
 410
 411 #. type: Plain text
 412 #: build/C/man3/iconv_open.3:36
 413 msgid ""
 414 "The B<iconv_open>()  function allocates a conversion descriptor suitable for "
 415 "converting byte sequences from character encoding I<fromcode> to character "
 416 "encoding I<tocode>."
 417 msgstr ""
 418
 419 #. type: Plain text
 420 #: build/C/man3/iconv_open.3:50
 421 msgid ""
 422 "The values permitted for I<fromcode> and I<tocode> and the supported "
 423 "combinations are system-dependent.  For the GNU C library, the permitted "
 424 "values are listed by the I<iconv --list> command, and all combinations of "
 425 "the listed values are supported.  Furthermore the GNU C library and the GNU "
 426 "libiconv library support the following two suffixes:"
 427 msgstr ""
 428
 429 #. type: TP
 430 #: build/C/man3/iconv_open.3:50
 431 #, no-wrap
 432 msgid "//TRANSLIT"
 433 msgstr ""
 434
 435 #. type: Plain text
 436 #: build/C/man3/iconv_open.3:59
 437 msgid ""
 438 "When the string \"//TRANSLIT\" is appended to I<tocode>, transliteration is "
 439 "activated.  This means that when a character cannot be represented in the "
 440 "target character set, it can be approximated through one or several "
 441 "similarly looking characters."
 442 msgstr ""
 443
 444 #. type: TP
 445 #: build/C/man3/iconv_open.3:59
 446 #, no-wrap
 447 msgid "//IGNORE"
 448 msgstr ""
 449
 450 #. type: Plain text
 451 #: build/C/man3/iconv_open.3:65
 452 msgid ""
 453 "When the string \"//IGNORE\" is appended to I<tocode>, characters that "
 454 "cannot be represented in the target character set will be silently "
 455 "discarded."
 456 msgstr ""
 457
 458 #. type: Plain text
 459 #: build/C/man3/iconv_open.3:71
 460 msgid ""
 461 "The resulting conversion descriptor can be used with B<iconv>(3)  any number "
 462 "of times.  It remains valid until deallocated using B<iconv_close>(3)."
 463 msgstr ""
 464
 465 #. type: Plain text
 466 #: build/C/man3/iconv_open.3:86
 467 msgid ""
 468 "A conversion descriptor contains a conversion state.  After creation using "
 469 "B<iconv_open>(), the state is in the initial state.  Using B<iconv>(3)  "
 470 "modifies the descriptor's conversion state.  (This implies that a conversion "
 471 "descriptor can not be used in multiple threads simultaneously.)  To bring "
 472 "the state back to the initial state, use B<iconv>(3)  with NULL as I<inbuf> "
 473 "argument."
 474 msgstr ""
 475
 476 #. type: Plain text
 477 #: build/C/man3/iconv_open.3:95
 478 msgid ""
 479 "The B<iconv_open>()  function returns a freshly allocated conversion "
 480 "descriptor.  In case of error, it sets I<errno> and returns I<(iconv_t)\\ "
 481 "-1>."
 482 msgstr ""
 483
 484 #. type: Plain text
 485 #: build/C/man3/iconv_open.3:97
 486 msgid "The following error can occur, among others:"
 487 msgstr ""
 488
 489 #. type: Plain text
 490 #: build/C/man3/iconv_open.3:105
 491 msgid ""
 492 "The conversion from I<fromcode> to I<tocode> is not supported by the "
 493 "implementation."
 494 msgstr ""
 495
 496 #. type: Plain text
 497 #: build/C/man3/iconv_open.3:113
 498 msgid "B<iconv>(1), B<iconv>(3), B<iconv_close>(3)"
 499 msgstr ""