kc3-lang/libiconv/man/iconv_close.3

Branch - branch -master

• Show log

  Commit

• Hash : 9f28054d
  Author :
  Date : 2024-12-15T12:52:18
  

  Implement the //NON_IDENTICAL_DISCARD suffix from POSIX:2024.
  
  * include/iconv.h.in (ICONV_GET_DISCARD_INVALID,
  ICONV_SET_DISCARD_INVALID, ICONV_GET_DISCARD_NON_IDENTICAL,
  ICONV_SET_DISCARD_NON_IDENTICAL): New macros.
  * lib/converters.h (struct conv_struct): Change type of discard_ilseq to
  'unsigned int'.
  (DISCARD_INVALID, DISCARD_UNCONVERTIBLE): New macros.
  * lib/iconv.c (iconv_open, iconv_open_into): Change type of
  discard_ilseq to 'unsigned int'.
  (iconvctl): Implement ICONV_GET_DISCARD_INVALID,
  ICONV_SET_DISCARD_INVALID, ICONV_GET_DISCARD_NON_IDENTICAL,
  ICONV_SET_DISCARD_NON_IDENTICAL. Change the implementation of
  ICONV_GET_DISCARD_ILSEQ, ICONV_SET_DISCARD_ILSEQ to test/set both bits.
  * lib/iconv_open1.h: Update comment. Recognize //NON_IDENTICAL_DISCARD.
  * lib/iconv_open2.h: Update comment.
  * lib/loop_unicode.h (mb_to_uc_write_replacement): Test the
  DISCARD_UNCONVERTIBLE bit of discard_ilseq.
  (unicode_loop_convert): Test the respective bit of discard_ilseq.
  (unicode_loop_reset): Test the DISCARD_UNCONVERTIBLE bit of
  discard_ilseq.
  * lib/loop_wchar.h (wchar_from_loop_convert, wchar_to_loop_convert):
  Test the DISCARD_INVALID bit of discard_ilseq.
  * man/iconv_open.3: Mention the //NON_IDENTICAL_DISCARD suffix. Mark as
  conforming to POSIX:2024.
  * man/iconv.3: Likewise.
  * man/iconv_close.3: Mark as conforming to POSIX:2024.
  * man/iconv.1: Likewise.
  * man/iconvctl.3: Document ICONV_GET_DISCARD_INVALID,
  ICONV_SET_DISCARD_INVALID, ICONV_GET_DISCARD_NON_IDENTICAL,
  ICONV_SET_DISCARD_NON_IDENTICAL. Revise the description of
  ICONV_GET_DISCARD_ILSEQ, ICONV_SET_DISCARD_ILSEQ.
  * tests/test-discard.c (test_default, test_translit, test_ignore,
  test_ignore_translit): Test also the ICONV_GET_DISCARD_INVALID,
  ICONV_GET_DISCARD_NON_IDENTICAL accessors.
  (test_nid, test_nid_translit, test_invd, test_invd_translit): New
  functions.
  (main): Add test cases with //NON_IDENTICAL_DISCARD suffix.
  * NEWS: Mention the change.
  

Download

• man/iconv_close.3

• .\" Copyright (c) Free Software Foundation, Inc.
  .\"
  .\" This is free documentation; you can redistribute it and/or
  .\" modify it under the terms of the GNU General Public License as
  .\" published by the Free Software Foundation; either version 3 of
  .\" the License, or (at your option) any later version.
  .\"
  .\" References consulted:
  .\"   GNU glibc-2 source code and manual
  .\"   OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
  .\"
  .TH ICONV_CLOSE 3  "December 15, 2024" "GNU"
  .SH NAME
  iconv_close \- deallocate descriptor for character set conversion
  .SH SYNOPSIS
  .nf
  .B #include <iconv.h>
  .sp
  .BI "int iconv_close (iconv_t " cd );
  .fi
  .SH DESCRIPTION
  The \fBiconv_close\fP function deallocates a conversion descriptor \fIcd\fP
  previously allocated using \fBiconv_open\fP.
  .SH "RETURN VALUE"
  When successful, the \fBiconv_close\fP function returns 0. In case of error,
  it sets \fBerrno\fP and returns \-1.
  .SH "CONFORMING TO"
  POSIX:2024
  .SH "SEE ALSO"
  .BR iconv_open (3)
  .BR iconv (3)
  

Download