Formatter strings use numbered variables like
%1$s to indicate parts that should be replaced by other text.
- - %1$s will be replaced by the distance, like "in 500 meters."
- - %2$s will be replaced by the direction, like "make a right turn."
- - %3$s will be replaced by the name or number of the street or exit, like "Main Street" or "Exit 123."
+ - %1$s will be replaced by the distance translation string, like "in 500 meters."
+ - %2$s will be replaced by the direction translation string, like "make a right turn." For languages that use different grammar for sentences like "in 100 feet, make a right turn onto Main Street" versus "in 100 feet, make a right turn" an optional string like
make_a_right_turn_street can replace the default make_a_right_turn string.
+ - %3$s will be dynamically replaced by the name or number of the street or exit, like "Main Street" or "Exit 123."
+ - %4$s is optional and is used for languages that split their grammar for sentences like "in 100 feet, make a right turn onto Main Street" into two parts, like "make in 100 feet a right turn onto Main Street". Optional strings like
make_a_right_turn_street_verb may be defined for this purpose.
For example "
%1$s %2$s onto
%3$s"
becomes "
In 500 meters make a right turn onto
Main Street"
- whereas "
%3$s is the place to
%2$s when you reach it
%1$s"
becomes "
Main Street is the place to
make a right turn when you reach it
in 500 meters."
+ whereas "
%4$s onto
%3$s a
%2$s when you reach it
%1$s"
can become "
Make onto
Main Street a
right turn when you reach it
in 500 meters." with the help of
_street and
_street_verb strings.