DynamicFormatter

public final class DynamicFormatter

Equivalent to Formatter, but supports DynamicTypes and generates a DynamicString.

See Formatter documentation for the format string syntax.

Argument index options (%s, %2$s, and %<s) are fully supported.

These are the supported conversions and options:

NOTE 1: %f has a default precision of 6..6 in Formatter, which is different from DynamicFloat.format which defaults to 0..3. DynamicFormatter behaves like Formatter and defaults to 6..6.

NOTE 2: DynamicFormatter uses Locale.getDefault(Locale.Category.FORMAT) at the time of calling format for non-DynamicType arguments. This can change on the remote side which, would cause a mismatch between the locally-formatted arguments and the remotely-formatted arguments, unless the provider sends a newly formatted DynamicString (using a new invocation of format).

Example usage:

DynamicFormatter().format(
  "%s has walked %d steps. %1$s has also walked %.2f meters.",
  "John", PlatformHealthSources.dailySteps(), PlatformHealthSources.dailyDistanceMeters()
)
// Generates an equivalent of:
DynamicString.constant("John has walked ")
  .concat(PlatformHealthSources.dailySteps().format())
  .concat(DynamicString.constant(" steps. John has also walked "))
  .concat(
    PlatformHealthSources.dailyMeters()
      .format(FloatFormatter.Builder().setMaxFractionDigits(2).build())
  )
  .concat(DynamicString.constant(" meters."))

Summary

public DynamicFormatter()

@RequiresSchemaVersion(major = 1, minor = 200)
public final @NonNull DynamicBuilders.DynamicString format(@NonNull String format, Object... args)