1berry/qtbase
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add Qt styling, ids, and classes to string overview graphics

Browse Source 
While many graphics in core use a light blue color, it does not fit to
Qt and to the general styling of the documentation. This patch changes
the color to the Qt green.

In the long run, I would like to have styling switching between light
and dark mode. This patch applies ids and styling so that it could be
switched from outside, if the html document this is embedded into
sets the correct tags. This will probably require some features in qdoc.

Task-number: QTBUG-133882
Change-Id: Iadce79a5f5a99014abe97c19d9e76efac3d49dad
Reviewed-by: Mate Barany <mate.barany@qt.io>
This commit is contained in:
Matthias Rauter 2025-04-29 10:20:51 +02:00
parent 878381473c
commit 8643ae7a76
2 changed files with 224 additions and 130 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

150
src/corelib/doc/images/string_class_api.svg
View File

@ -2,15 +2,36 @@
viewBox="-410 -30 540 470" viewBox="-410 -30 540 470"
version="1.1" version="1.1"
xmlns="http://www.w3.org/2000/svg"> xmlns="http://www.w3.org/2000/svg">
<style>
[data-theme="dark"] svg #raute { fill: #1A8550; stroke: #F2F2F2; }
[data-theme="dark"] svg #lozenge { fill: #1A8550; stroke: #F2F2F2; }
[data-theme="dark"] svg #lozenge_small { fill: #1A8550; stroke: #F2F2F2; }
[data-theme="dark"] svg #footnotes { fill: #F2F2F2; }
[data-theme="dark"] svg #arrow-tip { fill: #F2F2F2; }
[data-theme="dark"] svg .arrow-style { stroke: #F2F2F2; }
[data-theme="dark"] svg .text-style { font: 12px arial; fill: #F2F2F2; }
[data-theme="dark"] svg .text-style-arrows { font: 12px arial; fill: #F2F2F2; }
[data-theme="light"] svg #raute { fill: #56E59D; stroke: #333333; }
[data-theme="light"] svg #lozenge { fill: #56E59D; stroke: #333333; }
[data-theme="light"] svg #lozenge_small { fill: #56E59D; stroke: #333333; }
[data-theme="light"] svg #footnotes { fill: #333333; }
[data-theme="light"] svg #arrow-tip { fill: #333333; }
[data-theme="light"] svg .arrow-style { stroke: #333333; }
[data-theme="light"] svg .text-style { font: 11px arial; fill: #333333; }
[data-theme="light"] svg .text-style-arrows { font: 11px arial; fill: #333333; }
</style>
<defs> <defs>
<path id="raute" <path id="raute"
fill="#cfe7f5" fill="#56E59D"
stroke="black" stroke="#333333"
stroke-width="1px" stroke-width="1px"
d="m 0 -40 L 80 0 L 0 40 L -80 0 z" /> d="m 0 -40 L 80 0 L 0 40 L -80 0 z" />
<path id="lozenge" <path id="lozenge"
fill="#cfe7f5" fill="#56E59D"
stroke="black" stroke="#333333"
stroke-width="1px" stroke-width="1px"
d="M -60,-20 d="M -60,-20
h 120 h 120
@ -23,8 +44,8 @@
a 20,20 0 0 1 20,-20 a 20,20 0 0 1 20,-20
Z"/> Z"/>
<path id="lozenge_small" <path id="lozenge_small"
fill="#cfe7f5" fill="#56E59D"
stroke="black" stroke="#333333"
stroke-width="1px" stroke-width="1px"
d="M -40,-20 d="M -40,-20
h 80 h 80
@ -45,16 +66,17 @@
markerWidth="10" markerWidth="10"
markerHeight="10" markerHeight="10"
orient="auto"> orient="auto">
<path d="M 0 0 L 10 5 L 0 10 z" fill="black" /> <path id="arrow-tip" d="M 0 0 L 10 5 L 0 10 z" fill="#333333" />
</marker> </marker>
</defs> </defs>
<g id="start" transform="translate(-160, 0)"> <g id="start" transform="translate(-160, 0)">
<use href="#lozenge" /> <use href="#lozenge" />
<text <text
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="middle" text-anchor="middle" dominant-baseline="middle"
transform="translate(0, -6)"> transform="translate(0, -6)"
class="text-style">
<tspan x="0" dy="0em">Choosing a string class</tspan> <tspan x="0" dy="0em">Choosing a string class</tspan>
<tspan x="0" dy="1.2em">for creating an API</tspan> <tspan x="0" dy="1.2em">for creating an API</tspan>
</text> </text>
@ -63,9 +85,10 @@
<g id="param_or_return" transform="translate(-160, 100)"> <g id="param_or_return" transform="translate(-160, 100)">
<use href="#raute" /> <use href="#raute" />
<text <text
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="middle" text-anchor="middle" dominant-baseline="middle"
transform="translate(0, -6)"> transform="translate(0, -6)"
class="text-style">
<tspan x="0" dy="0em">For a parameter</tspan> <tspan x="0" dy="0em">For a parameter</tspan>
<tspan x="0" dy="1.2em">or the return value?</tspan> <tspan x="0" dy="1.2em">or the return value?</tspan>
</text> </text>
@ -74,9 +97,10 @@
<g id="make_copy" transform="translate(-320, 200)"> <g id="make_copy" transform="translate(-320, 200)">
<use href="#raute" /> <use href="#raute" />
<text <text
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="middle" text-anchor="middle" dominant-baseline="middle"
transform="translate(0, -6)"> transform="translate(0, -6)"
class="text-style">
<tspan x="0" dy="0em">Will you make</tspan> <tspan x="0" dy="0em">Will you make</tspan>
<tspan x="0" dy="1.2em">a persistent copy?</tspan> <tspan x="0" dy="1.2em">a persistent copy?</tspan>
</text> </text>
@ -85,9 +109,10 @@
<g id="ref_or_perm" transform="translate(40, 200)"> <g id="ref_or_perm" transform="translate(40, 200)">
<use href="#raute" /> <use href="#raute" />
<text <text
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="middle" text-anchor="middle" dominant-baseline="middle"
transform="translate(0, -12)"> transform="translate(0, -12)"
class="text-style">
<tspan x="0" dy="0em">Reference to</tspan> <tspan x="0" dy="0em">Reference to</tspan>
<tspan x="0" dy="1.2em">permanent or</tspan> <tspan x="0" dy="1.2em">permanent or</tspan>
<tspan x="0" dy="1.2em">temporary?</tspan> <tspan x="0" dy="1.2em">temporary?</tspan>
@ -97,9 +122,10 @@
<g id="make_copy" transform="translate(-80, 300)"> <g id="make_copy" transform="translate(-80, 300)">
<use href="#raute" /> <use href="#raute" />
<text <text
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="middle" text-anchor="middle" dominant-baseline="middle"
transform="translate(0, -6)"> transform="translate(0, -6)"
class="text-style">
<tspan x="0" dy="0em">Reference to full</tspan> <tspan x="0" dy="0em">Reference to full</tspan>
<tspan x="0" dy="1.2em">or part?</tspan> <tspan x="0" dy="1.2em">or part?</tspan>
</text> </text>
@ -108,8 +134,9 @@
<g id="const_ref" transform="translate(-320, 300)"> <g id="const_ref" transform="translate(-320, 300)">
<use href="#lozenge" /> <use href="#lozenge" />
<text <text
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="middle" > text-anchor="middle" dominant-baseline="middle"
class="text-style">
<tspan x="0" dy="0em">const QString&amp;¹</tspan> <tspan x="0" dy="0em">const QString&amp;¹</tspan>
</text> </text>
</g> </g>
@ -117,9 +144,10 @@
<g id="anystringview" transform="translate(-200, 380)"> <g id="anystringview" transform="translate(-200, 380)">
<use href="#lozenge" /> <use href="#lozenge" />
<text <text
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="middle" text-anchor="middle" dominant-baseline="middle"
transform="translate(0, -8)" > transform="translate(0, -8)"
class="text-style">
<tspan x="0" dy="0em">Q*StringView</tspan> <tspan x="0" dy="0em">Q*StringView</tspan>
<tspan font-size="8" x="0" dy="1.4em">Parameters: preferably QAnyStringView</tspan> <tspan font-size="8" x="0" dy="1.4em">Parameters: preferably QAnyStringView</tspan>
<tspan font-size="8" x="0" dy="1.2em">Generally: any of L1, UTF-8, or UTF-16</tspan> <tspan font-size="8" x="0" dy="1.2em">Generally: any of L1, UTF-8, or UTF-16</tspan>
@ -130,115 +158,133 @@
<g id="anystringview" transform="translate(40, 380)"> <g id="anystringview" transform="translate(40, 380)">
<use href="#lozenge" /> <use href="#lozenge" />
<text <text
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="middle" > text-anchor="middle" dominant-baseline="middle"
class="text-style">
<tspan x="0" dy="0em">QString</tspan> <tspan x="0" dy="0em">QString</tspan>
</text> </text>
</g> </g>
<g transform="translate(-160, 20)"> <g transform="translate(-160, 20)">
<path <path
fill="none" stroke="black" marker-end="url(#triangle)" fill="none" stroke="#333333" marker-end="url(#triangle)"
class="arrow-style"
d="M 0 0 l 0 30" /> d="M 0 0 l 0 30" />
</g> </g>
<g transform="translate(-240, 100)"> <g transform="translate(-240, 100)">
<path <path
fill="none" stroke="black" marker-end="url(#triangle)" fill="none" stroke="#333333" marker-end="url(#triangle)"
class="arrow-style"
d="M 0 0 l -80 0 l 0 50" /> d="M 0 0 l -80 0 l 0 50" />
<text x="-40" y="-5" <text x="-40" y="-5"
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="auto"> text-anchor="middle" dominant-baseline="auto"
class="text-style-arrows">
parameter parameter
</text> </text>
</g> </g>
<g transform="translate(-80, 100)"> <g transform="translate(-80, 100)">
<path <path
fill="none" stroke="black" marker-end="url(#triangle)" fill="none" stroke="#333333" marker-end="url(#triangle)"
class="arrow-style"
d="M 0 0 l 120 0 l 0 50" /> d="M 0 0 l 120 0 l 0 50" />
<text x="60" y="-5" <text x="60" y="-5"
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="auto"> text-anchor="middle" dominant-baseline="auto"
class="text-style-arrows">
return value return value
</text> </text>
</g> </g>
<g transform="translate(-320, 240)"> <g transform="translate(-320, 240)">
<path <path
fill="none" stroke="black" marker-end="url(#triangle)" fill="none" stroke="#333333" marker-end="url(#triangle)"
class="arrow-style"
d="M 0 0 l 0 30" /> d="M 0 0 l 0 30" />
<text x="5" y="15" <text x="5" y="15"
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="left" dominant-baseline="middle"> text-anchor="left" dominant-baseline="middle"
class="text-style-arrows">
yes yes
</text> </text>
</g> </g>
<g transform="translate(-240, 200)"> <g transform="translate(-240, 200)">
<path <path
fill="none" stroke="black" marker-end="url(#triangle)" fill="none" stroke="#333333" marker-end="url(#triangle)"
class="arrow-style"
d="M 0 0 l 40 0 l 0 150" /> d="M 0 0 l 40 0 l 0 150" />
<text x="20" y="-5" <text x="20" y="-5"
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="auto"> text-anchor="middle" dominant-baseline="auto"
class="text-style-arrows">
no no
</text> </text>
</g> </g>
<g transform="translate(-40, 200)"> <g transform="translate(-40, 200)">
<path <path
fill="none" stroke="black" marker-end="url(#triangle)" fill="none" stroke="#333333" marker-end="url(#triangle)"
class="arrow-style"
d="M 0 0 l -40 0 l 0 50" /> d="M 0 0 l -40 0 l 0 50" />
<text x="-20" y="-5" <text x="-20" y="-5"
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="auto"> text-anchor="middle" dominant-baseline="auto"
class="text-style-arrows">
reference reference
</text> </text>
</g> </g>
<g transform="translate(-160, 300)"> <g transform="translate(-160, 300)">
<path <path
fill="none" stroke="black" marker-end="url(#triangle)" fill="none" stroke="#333333" marker-end="url(#triangle)"
class="arrow-style"
d="M 0 0 l -70 0" /> d="M 0 0 l -70 0" />
<text x="-20" y="-5" <text x="-20" y="-5"
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="auto"> text-anchor="middle" dominant-baseline="auto"
class="text-style-arrows">
full full
</text> </text>
</g> </g>
<g transform="translate(-80, 340)"> <g transform="translate(-80, 340)">
<path <path
fill="none" stroke="black" marker-end="url(#triangle)" fill="none" stroke="#333333" marker-end="url(#triangle)"
class="arrow-style"
d="M 0 0 l 0 40 l -30 0" /> d="M 0 0 l 0 40 l -30 0" />
<text x="5" y="20" <text x="5" y="20"
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="left" dominant-baseline="auto"> text-anchor="left" dominant-baseline="auto"
class="text-style-arrows">
part part
</text> </text>
</g> </g>
<g transform="translate(40, 240)"> <g transform="translate(40, 240)">
<path <path
fill="none" stroke="black" marker-end="url(#triangle)" fill="none" stroke="#333333" marker-end="url(#triangle)"
class="arrow-style"
d="M 0 0 l 0 110" /> d="M 0 0 l 0 110" />
<text x="5" y="55" <text x="5" y="55"
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="left" dominant-baseline="auto"> text-anchor="left" dominant-baseline="auto"
class="text-style-arrows">
temporary temporary
</text> </text>
</g> </g>
<g transform="translate(-400, 415)"> <g transform="translate(-400, 415)">
<text x="5" y="5" <text id="footnotes" x="5" y="5"
font-size="9" fill="black" font-size="9" font-family="Arial" fill="#333333"
text-anchor="left" dominant-baseline="middle"> text-anchor="left" dominant-baseline="middle">
<tspan x="0" dy="0em">1:</tspan> <tspan x="0" dy="0em">1:</tspan>
<tspan x="1em" dy="0em">If you return a QString in full, you can choose <tspan x="1em" dy="0em">If you return a QString in full, you can choose
to return a value instead of a reference, allowing you to return a to return a value instead of a reference, allowing you to return a
temporary in the future without</tspan> temporary in the</tspan>
<tspan x="1em" dy="1.2em">breaking source code compatibility. This is <tspan x="1em" dy="1.2em">future without breaking source code compatibility. This is
also done for all Qt APIs.</tspan> also done for all Qt APIs.</tspan>
</text> </text>
</g> </g>

Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 6.6 KiB

After

Width:  |  Height:  |  Size: 8.8 KiB

160
src/corelib/doc/images/string_class_calling.svg
View File

@ -2,15 +2,36 @@
viewBox="-410 -30 540 540" viewBox="-410 -30 540 540"
version="1.1" version="1.1"
xmlns="http://www.w3.org/2000/svg"> xmlns="http://www.w3.org/2000/svg">
<style>
[data-theme="dark"] svg #raute { fill: #1A8550; stroke: #F2F2F2; }
[data-theme="dark"] svg #lozenge { fill: #1A8550; stroke: #F2F2F2; }
[data-theme="dark"] svg #lozenge_small { fill: #1A8550; stroke: #F2F2F2; }
[data-theme="dark"] svg #footnotes { fill: #F2F2F2; }
[data-theme="dark"] svg #arrow-tip { fill: #F2F2F2; }
[data-theme="dark"] svg .arrow-style { stroke: #F2F2F2; }
[data-theme="dark"] svg .text-style { font: 12px arial; fill: #F2F2F2; }
[data-theme="dark"] svg .text-style-arrows { font: 12px arial; fill: #F2F2F2; }
[data-theme="light"] svg #raute { fill: #56E59D; stroke: #333333; }
[data-theme="light"] svg #lozenge { fill: #56E59D; stroke: #333333; }
[data-theme="light"] svg #lozenge_small { fill: #56E59D; stroke: #333333; }
[data-theme="light"] svg #footnotes { fill: #333333; }
[data-theme="light"] svg #arrow-tip { fill: #333333; }
[data-theme="light"] svg .arrow-style { stroke: #333333; }
[data-theme="light"] svg .text-style { font: 12px arial; fill: #333333; }
[data-theme="light"] svg .text-style-arrows { font: 12px arial; fill: #333333; }
</style>
<defs> <defs>
<path id="raute" <path id="raute"
fill="#cfe7f5" fill="#56E59D"
stroke="black" stroke="#333333"
stroke-width="1px" stroke-width="1px"
d="m 0 -40 L 80 0 L 0 40 L -80 0 z" /> d="m 0 -40 L 80 0 L 0 40 L -80 0 z" />
<path id="lozenge" <path id="lozenge"
fill="#cfe7f5" fill="#56E59D"
stroke="black" stroke="#333333"
stroke-width="1px" stroke-width="1px"
d="M -60,-20 d="M -60,-20
h 120 h 120
@ -23,8 +44,8 @@
a 20,20 0 0 1 20,-20 a 20,20 0 0 1 20,-20
Z"/> Z"/>
<path id="lozenge_small" <path id="lozenge_small"
fill="#cfe7f5" fill="#56E59D"
stroke="black" stroke="#333333"
stroke-width="1px" stroke-width="1px"
d="M -40,-20 d="M -40,-20
h 80 h 80
@ -45,16 +66,17 @@
markerWidth="10" markerWidth="10"
markerHeight="10" markerHeight="10"
orient="auto"> orient="auto">
<path d="M 0 0 L 10 5 L 0 10 z" fill="black" /> <path id="arrow-tip" d="M 0 0 L 10 5 L 0 10 z" fill="#333333" />
</marker> </marker>
</defs> </defs>
<g id="start" transform="translate(-160, 0)"> <g id="start" transform="translate(-160, 0)">
<use href="#lozenge" /> <use href="#lozenge" />
<text <text
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="middle" text-anchor="middle" dominant-baseline="middle"
transform="translate(0, -6)"> transform="translate(0, -6)"
class="text-style">
<tspan x="0" dy="0em">Choosing a string class</tspan> <tspan x="0" dy="0em">Choosing a string class</tspan>
<tspan x="0" dy="1.2em">for calling Qt functions</tspan> <tspan x="0" dy="1.2em">for calling Qt functions</tspan>
</text> </text>
@ -63,9 +85,10 @@
<g id="param_or_return" transform="translate(-160, 100)"> <g id="param_or_return" transform="translate(-160, 100)">
<use href="#raute" /> <use href="#raute" />
<text <text
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="middle" text-anchor="middle" dominant-baseline="middle"
transform="translate(0, -12)"> transform="translate(0, -12)"
class="text-style">
<tspan x="0" dy="0em">Is your string</tspan> <tspan x="0" dy="0em">Is your string</tspan>
<tspan x="0" dy="1.2em">known at compile time</tspan> <tspan x="0" dy="1.2em">known at compile time</tspan>
<tspan x="0" dy="1.2em">(a literal)?</tspan> <tspan x="0" dy="1.2em">(a literal)?</tspan>
@ -75,9 +98,10 @@
<g id="ref_or_perm" transform="translate(-320, 200)"> <g id="ref_or_perm" transform="translate(-320, 200)">
<use href="#raute" /> <use href="#raute" />
<text <text
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="middle" text-anchor="middle" dominant-baseline="middle"
transform="translate(0, -6)"> transform="translate(0, -6)"
class="text-style">
<tspan x="0" dy="0em">Is the parameter a</tspan> <tspan x="0" dy="0em">Is the parameter a</tspan>
<tspan x="0" dy="1.2em">QString or a Q*View?</tspan> <tspan x="0" dy="1.2em">QString or a Q*View?</tspan>
</text> </text>
@ -87,9 +111,10 @@
<g id="ref_or_perm" transform="translate(-320, 330)"> <g id="ref_or_perm" transform="translate(-320, 330)">
<use href="#raute" /> <use href="#raute" />
<text <text
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="middle" text-anchor="middle" dominant-baseline="middle"
transform="translate(0, -6)"> transform="translate(0, -6)"
class="text-style">
<tspan x="0" dy="0em">Has the parameter a</tspan> <tspan x="0" dy="0em">Has the parameter a</tspan>
<tspan x="0" dy="1.2em">preferred² encoding?</tspan> <tspan x="0" dy="1.2em">preferred² encoding?</tspan>
</text> </text>
@ -99,9 +124,10 @@
<g id="make_copy" transform="translate(-100, 330)"> <g id="make_copy" transform="translate(-100, 330)">
<use href="#raute" /> <use href="#raute" />
<text <text
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="middle" text-anchor="middle" dominant-baseline="middle"
transform="translate(0, -6)"> transform="translate(0, -6)"
class="text-style">
<tspan x="0" dy="0em">Is your string</tspan> <tspan x="0" dy="0em">Is your string</tspan>
<tspan x="0" dy="1.2em">ASCII?</tspan> <tspan x="0" dy="1.2em">ASCII?</tspan>
</text> </text>
@ -110,9 +136,10 @@
<g transform="translate(40, 150)"> <g transform="translate(40, 150)">
<use href="#lozenge" /> <use href="#lozenge" />
<text <text
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="middle" text-anchor="middle" dominant-baseline="middle"
transform="translate(0, -4)" > transform="translate(0, -4)"
class="text-style">
<tspan x="0" dy="0em">QString¹</tspan> <tspan x="0" dy="0em">QString¹</tspan>
<tspan font-size="8" x="0" dy="1.4em">or any other owning string</tspan> <tspan font-size="8" x="0" dy="1.4em">or any other owning string</tspan>
</text> </text>
@ -121,9 +148,10 @@
<g transform="translate(-100, 200)"> <g transform="translate(-100, 200)">
<use href="#lozenge" /> <use href="#lozenge" />
<text <text
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="middle" text-anchor="middle" dominant-baseline="middle"
transform="translate(0, -4)" > transform="translate(0, -4)"
class="text-style">
<tspan x="0" dy="0em">QStringLiteral</tspan> <tspan x="0" dy="0em">QStringLiteral</tspan>
<tspan font-size="8" x="0" dy="1.4em">same as u"foo"_s</tspan> <tspan font-size="8" x="0" dy="1.4em">same as u"foo"_s</tspan>
</text> </text>
@ -132,9 +160,10 @@
<g transform="translate(40, 390)"> <g transform="translate(40, 390)">
<use href="#lozenge" /> <use href="#lozenge" />
<text <text
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="middle" text-anchor="middle" dominant-baseline="middle"
transform="translate(0, -4)" > transform="translate(0, -4)"
class="text-style">
<tspan x="0" dy="0em">QLatin1StringView</tspan> <tspan x="0" dy="0em">QLatin1StringView</tspan>
<tspan font-size="8" x="0" dy="1.4em">create with "foo"_L1</tspan> <tspan font-size="8" x="0" dy="1.4em">create with "foo"_L1</tspan>
</text> </text>
@ -143,9 +172,10 @@
<g transform="translate(-100, 430)"> <g transform="translate(-100, 430)">
<use href="#lozenge" /> <use href="#lozenge" />
<text <text
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="middle" text-anchor="middle" dominant-baseline="middle"
transform="translate(0, -4)" > transform="translate(0, -4)"
class="text-style">
<tspan x="0" dy="0em">QStringView</tspan> <tspan x="0" dy="0em">QStringView</tspan>
<tspan font-size="8" x="0" dy="1.4em">create with u"foo"</tspan> <tspan font-size="8" x="0" dy="1.4em">create with u"foo"</tspan>
</text>f </text>f
@ -155,9 +185,10 @@
<g transform="translate(-320, 430)"> <g transform="translate(-320, 430)">
<use href="#lozenge" /> <use href="#lozenge" />
<text <text
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="middle" text-anchor="middle" dominant-baseline="middle"
transform="translate(0, -8)" > transform="translate(0, -8)"
class="text-style">
<tspan x="0" dy="0em">Q*StringView</tspan> <tspan x="0" dy="0em">Q*StringView</tspan>
<tspan font-size="8" x="0" dy="1.4em">of the preferred encoding,</tspan> <tspan font-size="8" x="0" dy="1.4em">of the preferred encoding,</tspan>
<tspan font-size="8" x="0" dy="1.2em">create with u"foo", u8"foo" or "foo"_L1</tspan> <tspan font-size="8" x="0" dy="1.2em">create with u"foo", u8"foo" or "foo"_L1</tspan>
@ -166,28 +197,33 @@
<g transform="translate(-160, 20)"> <g transform="translate(-160, 20)">
<path <path
fill="none" stroke="black" marker-end="url(#triangle)" fill="none" stroke="#333333" marker-end="url(#triangle)"
class="arrow-style"
d="M 0 0 l 0 30" /> d="M 0 0 l 0 30" />
</g> </g>
<g transform="translate(-240, 100)"> <g transform="translate(-240, 100)">
<path <path
fill="none" stroke="black" marker-end="url(#triangle)" fill="none" stroke="#333333" marker-end="url(#triangle)"
class="arrow-style"
d="M 0 0 l -80 0 l 0 50" /> d="M 0 0 l -80 0 l 0 50" />
<text x="-40" y="-5" <text x="-40" y="-5"
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="auto"> text-anchor="middle" dominant-baseline="auto"
class="text-style-arrows">
yes yes
</text> </text>
</g> </g>
<g transform="translate(-80, 100)"> <g transform="translate(-80, 100)">
<path <path
fill="none" stroke="black" marker-end="url(#triangle)" fill="none" stroke="#333333" marker-end="url(#triangle)"
class="arrow-style"
d="M 0 0 l 120 0 l 0 20" /> d="M 0 0 l 120 0 l 0 20" />
<text x="60" y="-5" <text x="60" y="-5"
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="auto"> text-anchor="middle" dominant-baseline="auto"
class="text-style-arrows">
no no
</text> </text>
</g> </g>
@ -195,11 +231,13 @@
<g transform="translate(-240, 200)"> <g transform="translate(-240, 200)">
<path <path
fill="none" stroke="black" marker-end="url(#triangle)" fill="none" stroke="#333333" marker-end="url(#triangle)"
class="arrow-style"
d="M 0 0 l 50 0 " /> d="M 0 0 l 50 0 " />
<text x="25" y="-5" <text x="25" y="-5"
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="auto"> text-anchor="middle" dominant-baseline="auto"
class="text-style-arrows">
QString QString
</text> </text>
</g> </g>
@ -207,33 +245,39 @@
<g transform="translate(-320, 240)"> <g transform="translate(-320, 240)">
<path <path
fill="none" stroke="black" marker-end="url(#triangle)" fill="none" stroke="#333333" marker-end="url(#triangle)"
class="arrow-style"
d="M 0 0 l 0 40 " /> d="M 0 0 l 0 40 " />
<text x="5" y="20" <text x="5" y="20"
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="left" dominant-baseline="middle"> text-anchor="left" dominant-baseline="middle"
class="text-style-arrows">
Q*View Q*View
</text> </text>
</g> </g>
<g transform="translate(-240, 330)"> <g transform="translate(-240, 330)">
<path <path
fill="none" stroke="black" marker-end="url(#triangle)" fill="none" stroke="#333333" marker-end="url(#triangle)"
class="arrow-style"
d="M 0 0 l 50 0" /> d="M 0 0 l 50 0" />
<text x="30" y="-5" <text x="30" y="-5"
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="auto"> text-anchor="middle" dominant-baseline="auto"
class="text-style-arrows">
no no
</text> </text>
</g> </g>
<g transform="translate(-320, 370)"> <g transform="translate(-320, 370)">
<path <path
fill="none" stroke="black" marker-end="url(#triangle)" fill="none" stroke="#333333" marker-end="url(#triangle)"
class="arrow-style"
d="M 0 0 l 0 30" /> d="M 0 0 l 0 30" />
<text x="5" y="15" <text x="5" y="15"
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="left" dominant-baseline="middle"> text-anchor="left" dominant-baseline="middle"
class="text-style-arrows">
yes yes
</text> </text>
</g> </g>
@ -241,35 +285,39 @@
<g transform="translate(-20, 330)"> <g transform="translate(-20, 330)">
<path <path
fill="none" stroke="black" marker-end="url(#triangle)" fill="none" stroke="#333333" marker-end="url(#triangle)"
class="arrow-style"
d="M 0 0 l 60 0 l 0 30" /> d="M 0 0 l 60 0 l 0 30" />
<text x="30" y="-5" <text x="30" y="-5"
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="middle" dominant-baseline="auto"> text-anchor="middle" dominant-baseline="auto"
class="text-style-arrows">
yes yes
</text> </text>
</g> </g>
<g transform="translate(-100, 370)"> <g transform="translate(-100, 370)">
<path <path
fill="none" stroke="black" marker-end="url(#triangle)" fill="none" stroke="#333333" marker-end="url(#triangle)"
class="arrow-style"
d="M 0 0 l 0 30" /> d="M 0 0 l 0 30" />
<text x="5" y="15" <text x="5" y="15"
font-size="12" fill="black" font-size="12" font-family="Arial" fill="#333333"
text-anchor="left" dominant-baseline="middle"> text-anchor="left" dominant-baseline="middle"
class="text-style-arrows">
no no
</text> </text>
</g> </g>
<g transform="translate(-400, 465)"> <g transform="translate(-400, 465)">
<text x="5" y="5" <text id="footnotes" x="5" y="5"
font-size="9" fill="black" font-size="9" font-family="Arial" fill="#333333"
text-anchor="left" dominant-baseline="middle"> text-anchor="left" dominant-baseline="middle">
<tspan x="0" dy="0em">1:</tspan> <tspan x="0" dy="0em">1:</tspan>
<tspan x="1em" dy="0em">An owning string is required to assemble or store <tspan x="1em" dy="0em">An owning string is required to assemble or store
a string at runtime, if it is not known at compile time. This can be a string at runtime, if it is not known at compile time. This can be
QString or any other</tspan> QString or any</tspan>
<tspan x="1em" dy="1.2em">owning string, such as std::string. The correct <tspan x="1em" dy="1.2em">other owning string, such as std::string. The correct
choice depends on the required encoding.</tspan> choice depends on the required encoding.</tspan>
<tspan x="0" dy="1.4em">2:</tspan> <tspan x="0" dy="1.4em">2:</tspan>
<tspan x="1em" dy="0em">Some functions are more effective when using the <tspan x="1em" dy="0em">Some functions are more effective when using the

Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 7.8 KiB

After

Width:  |  Height:  |  Size: 10 KiB