Can 'Visual Studio' format style be modified?

[emptyVoid]

I would like to replicate the Visual Studio 2013 formatting settings (Tools -> Options -> Text Editor -> C/C++ -> Formatting) we use in VSCode. Is it possible to modify "C_Cpp.clang_format_style": "Visual Studio" style's settings?
I've already tried to replicate them using .clang-format to no avail, cant get it to format in the same style.

[sean-mcmanus]

Internally, the Visual Studio style setting we use is similar to "{ BasedOnStyle: LLVM, UseTab: Always, IndentWidth: 4, BreakBeforeBraces: Allman, AllowShortIfStatementsOnASingleLine: false, IndentCaseLabels: false, ColumnLimit: 0, TabWidth: 4 }", so you could set the clang_format_style to something like that with modifications. In the pending 0.11.0 update, you can also use a custom clang_format_fallbackStyle. What formatting feature of Visual Studio are you not able to replicate with clang-format? Later clang-format versions have added more options.

[emptyVoid]

First of all: not sure what I'm doing wrong, though VSCode seems to ignore .clang-format file I place in the root directory of my workspace, here's the file's contents:

BasedOnStyle: LLVM

AccessModifierOffset: -4
AllowShortIfStatementsOnASingleLine: false
BreakBeforeBraces: Allman
ColumnLimit: 0
IndentCaseLabels: false
IndentWidth: 4
SortIncludes: false
TabWidth: 4

There are no C_Cpp settings in my User Settings and I got no Workspace Settings (I'm using cpptools 0.11.0).
Please note the same file in the same place with the same workspace works just fine in Visual Studio 2013 with ClangFormat extension installed.

As per formatting features of Visual Studio: for example it lets me keep empty lines in various locations:

class Foo
{
public:

    Foo()
    {
        ...
    }
...

Whereas ClangFormat removes them.

[sean-mcmanus]

You're on Windows? We have a known bug with .clang-format not being found on Linux/Mac, but if it's not working on Windows, then that sounds like a different problem. I just tried your settings in a .clang-format in the root of my workspace and it worked. Yeah, the empty lines thing looks like it's possibly a bug with clang-format because the MaxEmptyLinesToKeep setting isn't being used. It would probably have to be fixed in clang-format.

[emptyVoid]

Oh, sorry forgot to mention, I use VSCode on Linux (Ubuntu 16.04). Is there a workaround for the said bug?

[sean-mcmanus]

The workaround is to change your clang_format_fallbackStyle to one of the non-Visual Studio presets, such as LLVM. That will cause clang-format itself to recognize the .clang-format file.

[emptyVoid]

Thanks for the workaround!

Ok, I've compiled the major differences between Visual Studio code formatting and clang-format which affect our codebase.

First, the formatting settings for which I've found no counterparts in clang-format:

1. Insert space before opening parenthesis of lambda argument list
2. For empty types, move closing braces to the same line as opening braces
3. For empty function bodies, move closing braces to the same line as opening braces
4. Don't change spaces around assignment operators
5. Insert space within parenthesis of ... (multiple settings allowing different spacing styles depending on the context)

Then, the formatting behavior (with no corresponding settings) which I could not replicate using clang-format:

1. Keeps empty lines in various places
2. Keeps multiple spaces in various places (good for alignment purposes): before macro replacement-list, in declarations
3. Keeps spaces in angle brackets (allowing different spacing styles depending on the context)

Lastly, Visual Studio formatting is more relaxed giving some freedom to choose what should and shouldn't be enforced by the coding style; whereas clang-format's settings mostly have no "do not enforce" option.

[sean-mcmanus]

Okay, those seem like a lot of differences. The "Visual Studio" style we setup up was just intended as a rough approximation given the limits of clang-format. The 2 options would be to make the modifications to clang-format or to port the formatting code used in VS and use that instead of clang-format. I think the reason we choose to use clang-format for formatting was that it was cross-platform and the VS formatting code was not.

[christophe-calmejane]

Hi,

any update on this issue?
Is there a way (more than 1y later) to enable "Visual Studio" formatting in VSCode?

[bobbrow]

Unfortunately, we do not have an update on this issue. Personally, I would love to have this feature as well, but it hasn't gotten enough upvotes to make it to the top of the backlog.

[christophe-calmejane]

Where should we upvote it?

[bobbrow]

Add a +1 to the first comment in this issue.

[christophe-calmejane]

Like I just did? (I don't see yours, still you say you want this feature as well, did I miss something?) thanks!

[bobbrow]

Yes, that's correct. Since we manage the backlog, I haven't been voting on things since I can add my vote in on the fly. 😄

[sean-mcmanus]

It seems like this issue is tracking porting VS's formatting instead of using clang_format.

We recently added AccessModifierOffset: - to the "Visual Studio" format to more closely match VS. If anyone else has a modification we can use to our default clang_format settings to more closely match VS then let us know.

[DavidMunozGit]

Hey your fix broke something,
Now it is not working the .clang-format (default option) in windows 10 I just do this quick test and the extension doesn't update anything.

[tarik-brown]

@travid112 Hi! Have you made sure to update the C_cpp: Formatting settings to either clangFormat or Default?

[sean-mcmanus]

@travid112 Also, are you doing Format Document or Format on Type or Format on Save? Can you provide a code sample and an example .clang-format file?

See also #5901 (i.e. set C_Cpp.clang_format_fallbackStyle to Emulated Visual Studio if you want to get the previous formatting behavior). You could also try changing the vcFormat.* settings (see #5907 ).

[sean-mcmanus]

@emptyVoid @christophe-calmejane https://github.com/microsoft/vscode-cpptools/releases/tag/0.30.0-insiders has support for the various Visual Studio formatting settings instead of using the "emulated" clang-format implementation. Let us know if you have any feedback on that (note: you may want to change some of the default settings, see #5907 ).

[DavidMunozGit]

I actually had to install Clang formatter and configure a file to use it with VSC because it wasn't doing anything at all but well by the way I learn about it and I have it working now, thanks for the comments :)