1 /****************************************************************************

     2 **

     3 ** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

     4 ** All rights reserved.

     5 ** Contact: Nokia Corporation (qt-info@nokia.com)

     6 **

     7 ** This file is part of the QtCore module of the Qt Toolkit.

     8 **

     9 ** $QT_BEGIN_LICENSE:LGPL$

    10 ** No Commercial Usage

    11 ** This file contains pre-release code and may not be distributed.

    12 ** You may use this file in accordance with the terms and conditions

    13 ** contained in the Technology Preview License Agreement accompanying

    14 ** this package.

    15 **

    16 ** GNU Lesser General Public License Usage

    17 ** Alternatively, this file may be used under the terms of the GNU Lesser

    18 ** General Public License version 2.1 as published by the Free Software

    19 ** Foundation and appearing in the file LICENSE.LGPL included in the

    20 ** packaging of this file.  Please review the following information to

    21 ** ensure the GNU Lesser General Public License version 2.1 requirements

    22 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.

    23 **

    24 ** In addition, as a special exception, Nokia gives you certain additional

    25 ** rights.  These rights are described in the Nokia Qt LGPL Exception

    26 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.

    27 **

    28 ** If you have questions regarding the use of this file, please contact

    29 ** Nokia at qt-info@nokia.com.

    30 **

    31 **

    32 **

    33 **

    34 **

    35 **

    36 **

    37 **

    38 ** $QT_END_LICENSE$

    39 **

    40 ****************************************************************************/

    41 

    42 #include "qplatformdefs.h"

    43 

    44 #include "qbytearray.h"

    45 #include "qstring.h"

    46 

    47 #include "string.h"

    48 

    49 QT_BEGIN_NAMESPACE

    50 

    51 #ifndef QT_VSNPRINTF

    52 

    53 /*!

    54     \relates QByteArray

    55 

    56     A portable \c vsnprintf() function. Will call \c ::vsnprintf(), \c

    57     ::_vsnprintf(), or \c ::vsnprintf_s depending on the system, or

    58     fall back to an internal version.

    59 

    60     \a fmt is the \c printf() format string. The result is put into

    61     \a str, which is a buffer of at least \a n bytes.

    62 

    63     The caller is responsible to call \c va_end() on \a ap.

    64 

    65     \warning Since vsnprintf() shows different behavior on certain

    66     platforms, you should not rely on the return value or on the fact

    67     that you will always get a 0 terminated string back.

    68 

    69     Ideally, you should never call this function but use QString::sprintf()

    70     instead.

    71 

    72     \sa qsnprintf(), QString::sprintf()

    73 */

    74 

    75 int qvsnprintf(char *str, size_t n, const char *fmt, va_list ap)

    76 {

    77     if (!str || !fmt)

    78         return -1;

    79 

    80     QString buf;

    81     buf.vsprintf(fmt, ap);

    82 

    83     QByteArray ba = buf.toLocal8Bit();

    84 

    85     if (n > 0) {

    86         size_t blen = qMin(size_t(ba.length()), size_t(n - 1));

    87         memcpy(str, ba.constData(), blen);

    88         str[blen] = '\0'; // make sure str is always 0 terminated

    89     }

    90 

    91     return ba.length();

    92 }

    93 

    94 #else

    95 

    96 QT_BEGIN_INCLUDE_NAMESPACE

    97 #include <stdio.h>

    98 QT_END_INCLUDE_NAMESPACE

    99 

   100 int qvsnprintf(char *str, size_t n, const char *fmt, va_list ap)

   101 {

   102     return QT_VSNPRINTF(str, n, fmt, ap);

   103 }

   104 

   105 #endif

   106 

   107 /*!

   108     \relates QByteArray

   109 

   110     A portable snprintf() function, calls qvsnprintf.

   111 

   112     \a fmt is the \c printf() format string. The result is put into

   113     \a str, which is a buffer of at least \a n bytes.

   114 

   115     \warning Call this function only when you know what you are doing

   116     since it shows different behavior on certain platforms.

   117     Use QString::sprintf() to format a string instead.

   118 

   119     \sa qvsnprintf(), QString::sprintf()

   120 */

   121 

   122 int qsnprintf(char *str, size_t n, const char *fmt, ...)

   123 {

   124     va_list ap;

   125     va_start(ap, fmt);

   126 

   127     int ret = qvsnprintf(str, n, fmt, ap);

   128     va_end(ap);

   129 

   130     return ret;

   131 }

   132 

   133 QT_END_NAMESPACE