Harbour Reference Guide

 

StrFormat()

Format a string

Syntax

StrFormat(<cMask>[, <cPar1>[, <cParn>[, ...]]) --> cString

Arguments

<cMask> Holds the mask for the resulting string
<cParn> Holds the strings to be inserted in the mask maximum 9 of them can be specified.

Returns

<cString> Return the mask with all the parameters inserted.

Description

String replacment, can be useful when writing international apps. You can separate the constant strings from the variable ones. Each %1 - %9 marks will be replaced with the appropriate parameter from the parameter list.
Marks can be in any order, and can be duplicated.
You can print "%" character with "%%".
Examples
      StrFormat("Please insert disk %1 to drive %2", LTrim(Str(2)), "A:")
      StrFormat("This is %1 from %2", "Victor", "Hungary")
      StrFormat("%2 %1 %2", "Param1", "Param2")
Tests
      ? StrFormat("Please insert disk %1 to drive %2", LTrim(Str(2)), "A:")
      ? StrFormat("This is %1 from %2", "Victor", "Hungary")
      ? StrFormat("%2 %1 %2", "Param1", "Param2")
      ? StrFormat("Hello")
      ? StrFormat("%1 - %2", "one")
      ? StrFormat("%1 - %2", "one", "two")
      ? StrFormat("%2 - %1", "one", "two")
      ? StrFormat("%2 - %", "one", "two")
      ? StrFormat("%% - %", "one", "two")
      ? StrFormat("%9 - %", "one", "two")
Status

Done

Compliance

All platforms

Files

Library is libmisc

 




[Source Forge]

Other Docs Categories

Advantage Database RDD
Array
Binary conversion
Classes
Code Block
Console input
Conversion
Conversion Tools
DOS
Data input and output
Database
Database Tools
Date
Dos Tools
Environment
Error recovery
Events
File management
GT
Harbour Tools
Internal
Low Level
Math
Misc
Miscellaneous
Nation
Object manipulation
Operating System Specific
Parameter Checks
String Tools
Strings
TBrowse Method
TBrowse class
Terminal
Time
Utility
Variable Management

 

Last updated on 2001/07/30