ONE-xicons
© Copyright 2003-2024 WERK II Medien- und Informationsgesellschaft mbH. All Rights Reserved.

char* sprintf (char* result,
     char* formatStr,
     ...)

Create a formatted char*-string.

Documentation

Create a formatted char*-string.

In plug-in versions prior 3.2 R2300 the output length (after all %-markers are replaced) is limited to 9999. Since 3.2 R2300 the limit is 32768. Longer strings may crash InDesign®.

Name Type Default Description
result char* - Result string. The string must be large enough to take up all replaced values.
formatStr char* - Message. The string can contain %-markes , see here to learn more. An additional parameter is expected in the (correct) sequence and with the correct type for each of these markers.
... depending on the %-markers - Values or variables according to the %-markers in formatStr

Assign "Hello 3rd World" to str in three different ways, then "Hello 4th Dimension" 

int main()
{
    char	*	str	= allocMemory allocation. You should always check the result of the function for 0. Access to erroneously reserved memory lead to significant errors in the script execution. The allocated memory is initialized as an empty string, or, in other words, the first (and only the first) byte is set to 0. ...(512);
    char	*	w	= allocMemory allocation. You should always check the result of the function for 0. Access to erroneously reserved memory lead to significant errors in the script execution. The allocated memory is initialized as an empty string, or, in other words, the first (and only the first) byte is set to 0. ...(256);
    int			i	= 3;

    strcpyCopy the contents of a char*-string into another, the contents of s2 will be copied into s1.(w, "World");
    sprintfCreate a formatted char*-string.(str, "Hello 3rd World");
    showmessageDisplay the standard dialog with a message.(str);
    sprintfCreate a formatted char*-string.(str, "Hello 3rd %s", w);
    showmessageDisplay the standard dialog with a message.(str);
    sprintfCreate a formatted char*-string.(str, "Hello %drd %s", i, w);

    showmessageDisplay the standard dialog with a message.(str);
    strcpyCopy the contents of a char*-string into another, the contents of s2 will be copied into s1.(w, "dimension");
    sprintfCreate a formatted char*-string.(str, "Hello %dth %s", ++i, w);
    showmessageDisplay the standard dialog with a message.(str);

    releaseRelease memory reserved by alloc.(str);
    releaseRelease memory reserved by alloc.(w);

    return 0;
}

As showmessage also expects a format string, the % in the example have to be doubled 

int main()
{
    char	*	str	= allocMemory allocation. You should always check the result of the function for 0. Access to erroneously reserved memory lead to significant errors in the script execution. The allocated memory is initialized as an empty string, or, in other words, the first (and only the first) byte is set to 0. ...(512);
    float		f	= 15.398735;

    sprintfCreate a formatted char*-string.(str, "Der Preis steigt um %.2f%%%%, also ungefähr %.0f%%%%", f, f);
    showmessageDisplay the standard dialog with a message.(str);

    releaseRelease memory reserved by alloc.(str);

    return 0;
}


priint:comet InDesign® Plug-Ins, comet_pdf, Illustrator

Alphabetic index HTML hierarchy of classes or Java

© Copyright 2003-2024 WERK II GmbH Duisburg
Authors :
      Paul Seidel
      Christoph Soergel
      Leo Quensel
      Mihg
This page was created using a modified version of doc++.

This documentation is part of the priint:comet InDesign®, InDesign Server® and Illustrator® plug-in and of the comet_pdf packages and is subject to the same license terms as priint:comet itself. The documentation may neither be passed on nor installed on public servers without the consent of WERK II GmbH.

The documentation describes the priint:comet scripting language cScript and provides support for solving technical problems when using the priint:comet plugins. The documentation is not a manual for the priint:comet plugins. A manual of the priint:comet plugins can be found here.

The documentation has been prepared with the greatest possible care. In case of errors or hints, please do not hesitate to contact our support. However, faulty or incomplete functional descriptions shall in no case result in an obligation on the part of WERK II GmbH to adapt the described item.

This copyright notice may not be removed or altered.