---
name: "FoldStringA"
section: "3w"
platform: "linux"
package: "libwine-dev"
version: "1.4.1-4"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/FoldStringA"
---

# FoldStringA(3w)

## NAME

**FoldStringA** (KERNEL32.@)

## SYNOPSIS

INT FoldStringA\
  (\
   DWORD  *dwFlags*,\
   LPCSTR *src*,\
   INT    *srclen*,\
   LPSTR  *dst*,\
   INT    *dstlen*\
  )

## DESCRIPTION

Map characters in a string.

## PARAMS

*dwFlags* **\[In\]**  Flags controlling characters to map (**MAP\_** constants from **"winnls.h"**).

*src* **\[In\]**  String to map.

*srclen* **\[In\]**  Length of *src*, or **-1** if *src* is **NUL** terminated.

*dst* **\[Out\]**  Destination for mapped string.

*dstlen* **\[In\]**  Length of *dst*, or **0** to find the required length for the mapped string.

## RETURNS

**Success:** The length of the string written to *dst*, including the terminating **NUL**. If *dstlen* is **0**, the value returned is the same, but nothing is written to *dst*, and *dst* may be **NULL**.

**Failure:** **0.** Use **[GetLastError(3w)](/GetLastError/3w.md)** to determine the cause.

## IMPLEMENTATION

Declared in **"winnls.h"**.

Implemented in **"dlls/kernel32/locale.c"**.

Debug channel **"nls"**.